31. 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.

KeyValueDefaultDescription
attributeQualified name of attribute to be editedNo defaultWithout this parameter, the control is used to edit the value of the element for which the control has been generated.
labelsList 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.
valuesList 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.

rowsPositive integermax(10, number of values)Maximum number of rows displayed by the list control.
selectionsingle | multiplesingleSpecifies single or multiple selection mode.
separatorSingle character stringNone (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, ",")