diff --git a/NEWS b/NEWS index efdb162d..2c4280bb 100644 --- a/NEWS +++ b/NEWS @@ -1,3 +1,5 @@ + - updated docs for html_checkboxes, html_options and html_radios (messju) + - fixed wrong default "name" attribute for html_options (messju) - html_checkboxes now expect the options as attribute "options" instead of "checkboxes. html_radios expect "options" instead of "radios". cleaned up indentiation (messju) diff --git a/docs/designers.sgml b/docs/designers.sgml index 288ef19c..d6067fe3 100644 --- a/docs/designers.sgml +++ b/docs/designers.sgml @@ -3479,14 +3479,14 @@ You must supply a <b>state</b>. values array - Yes, unless using checkboxes attribute + Yes, unless using options attribute n/a an array of values for checkbox buttons output array - Yes, unless using checkboxes attribute + Yes, unless using options attribute n/a an array of output for checkbox buttons @@ -3498,7 +3498,7 @@ You must supply a <b>state</b>. the checked checkbox element - checkboxes + options associative array Yes, unless using values and output n/a @@ -3518,9 +3518,13 @@ You must supply a <b>state</b>. html_checkboxes is a custom function that creates an html checkbox group with provided data. It takes care of which item(s) are selected by default as well. Required attributes are values and - output, unless you use checkboxes instead. All output is XHTML + output, unless you use options instead. All output is XHTML compatible. + + All parameters that are not in the list above are printed as + name/value-pairs inside each of the created <input>-tags. + html_checkboxes @@ -3747,6 +3751,11 @@ OUTPUT: (possible) <select name="groupname"></select> tags will enclose the option list. Otherwise only the option list is generated. + + All parameters that are not in the list above are printed as + name/value-pairs inside the <select>-tag. They are ignored if + the optional name is not given. + html_options @@ -3825,14 +3834,14 @@ OUTPUT: (both examples) values array - Yes, unless using radios attribute + Yes, unless using options attribute n/a an array of values for radio buttons output array - Yes, unless using radios attribute + Yes, unless using options attribute n/a an array of output for radio buttons @@ -3844,7 +3853,7 @@ OUTPUT: (both examples) the checked radio element - radios + options associative array Yes, unless using values and output n/a @@ -3864,8 +3873,13 @@ OUTPUT: (both examples) html_radios is a custom function that creates html radio button group with provided data. It takes care of which item is selected by default as well. Required attributes are values and output, - unless you use radios instead. All output is XHTML compatible. + unless you use options instead. All output is XHTML compatible. + + All parameters that are not in the list above are printed as + name/value-pairs inside each of the created <input>-tags. + html_radios