SYNOPSIS

ElementTree addLabelledSelect( ElementTree block, String labeltext, String name, Int ssize, [Pair<String, [SelectOption]> ] optgroups, Bool lazy=false )

ARGUMENTS

parent The parent element

labeltext The label for the selector

name The name of the input. Remember that names starting with "kaya_" may be used by the Kaya standard library and should not be used directly by applications.

ssize The size of the select element. If this is zero, the select element will only allow one option to be selected at any one time. If this is one or more, the select element will allow multiple options to be selected, and suggest to the browser that this many options be displayed simultaneously.

optgroups The options to select from

lazy This parameter is optional and defaults to false If it is explicitly set to true then the selector will be generated lazily.

DESCRIPTION

Adds a labelled selection box to a form. The selector itself is identical to that produced by HTMLDocument.addSelectElement (3kaya) or HTMLDocument.addLazySelect (3kaya) , depending on the value of the lazy parameter. Generally, it is more convenient to use this function to label selectors, than to create them individally.

AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others ([email protected]). For further information see http://kayalang.org/

LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

RELATED

HTMLDocument.SelectOption (3kaya)

HTMLDocument.addLazySelect (3kaya)

HTMLDocument.addOptionList (3kaya)

HTMLDocument.addSelectElement (3kaya)