https://panoptic.com/mediawiki/aolserver/index.php?action=history&feed=atom&title=Ns_htmlselectNs htmlselect - Revision history2026-04-18T15:56:51ZRevision history for this page on the wikiMediaWiki 1.34.2https://panoptic.com/mediawiki/aolserver/index.php?title=Ns_htmlselect&diff=2695&oldid=prevWikiSysop: imported from WiKit id 5762004-06-17T06:30:22Z<p>imported from WiKit id 576</p>
<p><b>New page</b></p><div>Man page: http://aolserver.com/docs/tcl/ns_htmlselect.html<br />
<br />
----<br />
<br />
'''NAME'''<br />
<br />
: ns_htmlselect - Build an HTML SELECT form widget from the specified data<br />
<br />
'''SYNOPSIS'''<br />
<br />
: '''ns_htmlselect''' ''?-multi? ?-sort? ?-labels labels? name values ?selectedData?''<br />
<br />
'''DESCRIPTION'''<br />
<br />
: This command builds an HTML SELECT tag using the passed-in data.<br />
<br />
: If ''-multi'' is specified, the SELECT will be generated with the MULTIPLE attribute to allow multiple options to be selected. This option also affects the SIZE attribute output for the SELECT. If ''-multi'' is specified, the SIZE attribute will be set to 5 or the number of elements in ''values'', whichever is less. If ''-multi'' is not specified, then the SIZE attribute will be set to 5 if there are more than 25 elements in ''values''. If there are 25 or fewer elements in ''values'', the SIZE attribute will be omitted (equivalent to SIZE=1).<br />
<br />
: If ''-sort'' is specified, the option list of the SELECT will be sorted according to the elements of ''labels'', or the elements of ''values'' if ''labels'' is not specified. <br />
<br />
: ''labels'' is an optional list of labels to display. If not specified, the elements of ''values'' will be used. The order and number of the ''labels'' list must match the order and number of the ''values'' list.<br />
<br />
: ''name'' specifies the NAME attribute of the SELECT.<br />
<br />
: ''values'' is a list of the OPTIONs for the SELECT. If a ''labels'' list is not specified, the values themselves will be used as the OPTION labels. <br />
<br />
: ''selectedData'' is an optional list of the OPTIONs that will be selected by default.<br />
<br />
'''EXAMPLES'''<br />
<br />
% set favoriteAnimal [[ns_htmlselect_old -sort -labels [list dog cat cow]] "favoriteAnimal" [[list canine feline bovine]] [[list canine]]]<br />
<br />
<SELECT NAME=favoriteAnimal><br />
<OPTION VALUE="feline">cat<br />
<OPTION VALUE="bovine">cow<br />
<OPTION VALUE="canine" SELECTED>dog<br />
</SELECT><br />
<br />
<br />
'''NOTES'''<br />
<br />
: The NAME attribute is not quoted, so you may discover code abusing this parameter to give the SELECT additional attributes such as an id, a style, or an event handler. Expecting this behavior to be present in future releases is not recommended.<br />
<br />
----<br />
<br />
[[Category Documentation]] - [[Category Core Tcl API]]</div>WikiSysop