List Box Widget
Allows the user to select multiple values within a list of possible values.
The list of possible values is a List of Records where the Record definition must include a Boolean attribute to hold the user selection.
Properties
| Name | Description | Mandatory | Default value | Observations |
|---|---|---|---|---|
| Name | Identifies an element in the scope where it is defined, like a screen, action, or module. | Yes | ||
| Validation Parent | Specifies an Edit Record widget. Widgets with the same Validation Parent are validated as a group. | |||
| Source Record List | Current list of records displayed by the widget. | Yes | ||
| Source Attribute | Specifies the attribute of the records in the list to populate the widget. | Yes | ||
| Selection Mode | Specifies if the user can select only a single item or multiple items from the list. | Yes | Multiple | The possible values are: Multiple and Single. |
| Selection Attribute | Boolean attribute of the records in the list that holds if a value is selected or not. If using a list from an Aggregate, you can add a new Boolean attribute in the Aggregate. | Yes | ||
| Width | Width of the widget in columns. Other accepted units are pixels(px), points(pt), or percentage(%). Overrides the style sheet definition. | |||
| Height | Height of the widget in pixels. Other accepted units are points(pt) or percentage(%). Overrides the style sheet definition. | |||
| Margin Left | Left margin of the widget in columns. Other accepted units are pixels(px), points(pt), or percentage(%). Overrides the style sheet definition. | |||
| Margin Top | Top margin of the widget in pixels. Other accepted units are points(pt) or percentage(%). Overrides the style sheet definition. | |||
| Style Classes | Specifies one or more style classes to apply to the widget. Separate multiple values with spaces. | |||
| Visible | Boolean literal or expression that defines if the widget is displayed. | Yes | ||
| Enabled | Boolean literal or expression that defines if the widget is editable. | Yes | ||
| Extended Properties | ||||
| Property | Name of an attribute to add to the HTML translation for this element. | You can pick a property from the drop-down list or type a free text. The name of the property will not be validated by the platform. Duplicated properties are not allowed. Spaces, " or ' are also not allowed. |
||
| Value | Value of the attribute. | You can type the value directly or write expressions using the Expression Editor. If the Value is empty, the corresponding HTML tag is created as property="property". For example, the nowrap property does not require a value, therefore nowrap="nowrap" is added. |
||
| On Change | ||||
| Destination | Screen action to be executed or a screen to navigate to when the value of the element changes. | It might be necessary to specify additional input arguments. | ||
Runtime Properties
| Name | Description | Read Only | Type | Observations |
|---|---|---|---|---|
| List | Collection of records returned by the performed query. | Record List | ||
| Valid | Always True for List Boxes. You can override this property value when performing custom validation. | Boolean | ||
| ValidationMessage | Message describing the built-in validation constraints not satisfied when 'Valid' is False. You can override this property value when performing custom validations. | Text | ||
| Id | Identifies the widget instance at runtime (HTML 'id' attribute). You can use it in JavaScript and Extended Properties. | Yes | Text |