---
name: "HTMLDocument.addLabelledSelect"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTMLDocument.addLabelledSelect"
---

# HTMLDocument.addLabelledSelect(3kaya)

Adds a labelled selection box

## NAME

HTMLDocument::addLabelledSelect - Adds a labelled selection box

## 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 (kaya@kayalang.org). 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)**