Skip to main content
Version: 1.21.3

list

The <list> tag to add a multi-select reference field to a widget. By using it, you can specify more than one reference within one field.

Available attributes:

AttributeTypeMandatoryDescription
canCreateBooleanNSet the value to true to add the button for creating a new record. The default value is false.
canReadBooleanNSet the value to false to restrict access to the specified table. The default value is true.
classStringNSpecify the CSS class name defined in the CSS field of the widget.
conditionStringNSpecify a query condition that limits the records available for selection.
This attribute takes a decoded condition as a value. To decode a query condition, use server methods as recommended.
isFixedBooleanNSet the value to true to disable the editing of the condition value. The default value is false. Pre-specify the condition in the condition attribute.
isMandatoryBooleanNSet the value to true to make the field mandatory. The default value is false.
isVisibleBooleanNSet the value to false to hide the tag. The default value is true.
labelStringNDescribe the field content by giving it a title.
modelStringYSpecify this attribute to connect the client controller data object. When the model data changes, it is automatically transferred to the data of the client controller.
readOnlyBooleanNSet the value to true to make the field read-only. The default value is false.
styleStringNSpecify the display settings (size, font, color, and others) of the tag elements using the CSS syntax.
tableNameStringYSpecify the name of the table to which this tag is bound.
valueArrayNSpecify an array of objects that contains references to other fields. The specified records are added to the field.
The object must contain the database_value and display_value keys. The database_value key contains the ID of the selected record, display_value – its display value.

Example:

list
<list
label="Configuration items"
model="data.element
tableName="sys_cmdb_ci"
isMandatory="true"
condition="{data.condition}"
value='[{"database_value":"169020961913987475","display_value":"CI0000001"},{"database_value":"169020961811196333","display_value":"CI0000002"}]'
></list>

The template above adds the following element to the page: