From e8b181cf748f986ebf4ad3892a38fd714a63c022 Mon Sep 17 00:00:00 2001 From: messju Date: Mon, 12 Jan 2004 19:24:28 +0000 Subject: [PATCH] added docs for year_empty-, month_empty- and day_emtpy-attributes of html_select_date. maybe an example is needed to better explain empty values in YYY-MM-DD. --- docs/designers.sgml | 44 +++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 41 insertions(+), 3 deletions(-) diff --git a/docs/designers.sgml b/docs/designers.sgml index c7b71989..104576ce 100644 --- a/docs/designers.sgml +++ b/docs/designers.sgml @@ -4482,6 +4482,31 @@ OUTPUT: (both examples) strftime format of the month values, default is %m for month numbers. + + year_emtpy + string + No + null + If supplied then the first element of the year's select-box has this + value as it's label and "" as it's value. This is useful to make the + select-box read "Please select a year" for example. + + + day_empty + string + No + null + If supplied then the first element of the day's select-box has this + value as it's label and "" as it's value. + + + month_empty + string + No + null + If supplied then the first element of the month's select-box has this + value as it's label and "" as it's value. . + @@ -4717,10 +4742,23 @@ OUTPUT: (current year is 2000) - html_select_time is a custom function that creates time dropdowns - for you. It can display any or all of hour, minute, second and - meridian. + html_select_time is a custom function that + creates time dropdowns for you. It can display + any or all of hour, minute, second and + meridian. + + The time-attribute can have different + formats. It can be a uniq-timestamp or a + string containing Y-M-D. YYYY-MM-DD may be the + most common, but months and days with less + than two digits are also recognized. If one of + the 3 values (Y,M,D) is the empty string, than + the according select-box is not pre-selected + at all. This is especially useful with the + empty_year-, -month- and -day-attritbutes. + + html_select_time