25. list
Prev | Chapter 5. Content objects | Next

## 25. list

list(`key`, `value`, ..., `key`, `value`)

Inserts a list control in generated content. This control can be used to edit the value of the element which is the target of the CSS rule. If "attribute, `attribute_name`" is specified, this control can be used to edit the value of an attribute of this target element.

Key | Value | Default | Description
--- | --- | --- | ---
attribute | Qualified name of attribute to be edited | No default | Without this parameter, the control is used to edit the value of the element for which the control has been generated.
labels | List of strings separated by new lines ("`\A` ") | None (use values as labels) | Labels used for the list items. The order of labels must match the order of values.

values

List of strings separated by new lines ("`\A` ")

None (dynamically determined by examining the data type of value to be edited)

In single selection mode, clicking on list item #N sets the element or attribute value being edited to value string #N.

In multiple selection mode clicking on list item #N adds/removes value string #N to/from the selected set.

The value strings in the selected set are then joined using the character specified by separator (' ' by default).

The resulting string is assigned to the element or attribute value being edited.

rows | Positive integer | max(10, number of values) | Maximum number of rows displayed by the list control.
selection | single | multiple | single | Specifies single or multiple selection mode.
separator | Single character string | None (values are separated by any type of white space characters) | Character used to join selected value strings in multiple selection mode. The resulting string is assigned to the element or attribute value being edited.

`Key`, `value`, ..., `key`, `value` may also specify style parameters.

Examples:

    list(rows, 3)

    list(attribute, value,
         labels, "Cyan\A Yellow\A Magenta\A Black")

    list(rows, 3,
         selection, multiple)

    list(attribute, value,
         labels, "Cyan\A Yellow\A Magenta\A Black",
         values, "cyan\A yellow\A magenta\A black",
         selection, multiple,
         separator, ",")

Prev | Up | Next
24. label | Home | 26. number-field