Magnolia 5.6 reached end of life on June 25, 2020. This branch is no longer supported, see End-of-life policy.
This control is useful for selecting large sets of items such as group and role memberships. You can find an example in the Security app.
Class: info.magnolia.ui.form.field.definition.TwinColSelectFieldDefinition
Simple twin-column field definition.
form: tabs: - name: tabTags label: Tags fields: - name: tags class: info.magnolia.ui.form.field.definition.TwinColSelectFieldDefinition type: String label: Tags options: - name: news label: News selected: true - name: sports label: Sports value: sports - name: celebrities label: Celebrities value: celebrities
Node name | Value |
---|---|
form | |
tabs | |
tabTags | |
fields | |
tags | |
options | |
news | |
label | News |
selected | true |
value | News |
sports | |
label | Sports |
value | sports |
celebrities | |
label | Celebrities |
value | celebrities |
class | info.magnolia.ui.form.field.definition.TwinColSelectFieldDefinition |
label | Tags |
You can use all common field properties and the following:
Select, Option group and Twin-column fields follow this general configuration pattern, but also have additional properties.
Properties:
<field‑name> | required Name of field |
| required Parent node for the selectable options. |
| Name of the option. |
| optional, default is the parent node name Name of the node where the selected value is stored. If not set, the name of the parent node is used. |
| required Value saved to the repository when selected. |
| optional Option label displayed to the user. |
| optional Pre-selects the option. |
| optional Path to an existing option set as opposed to defining options in the current definition. |
| optional, default is When using a |
| optional, default is Read option values from a different property. Set to the name of your custom value node. |
| optional, default is Read option labels from a different property. Set to the name of your custom label node. |
| optional, default is By default, option labels are sorted alphabetically. When set to |
Properties specific to the twin-column field.
<field name> | Name of field. |
| optional, default is Text displayed above the left column. Typically retrieved from a message bundle. |
| optional, default is Text displayed above the right column. Typically retrieved from a message bundle. |