Skip to main content

Reference

 

Applies only to Web Applications
OutSystems

Combo Box Widget

Allows the user to select a specific value within a list of possible values.

The list of possible values can be an Attribute of an Entity, an Attribute of a Structure or a list of special values. You can also add special values like "All" and "None" to the list fetched from an Entity or Structure.

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
Variable Holds the value entered by the user. Mandatory if Source Entity/Structure is specified.
Validation Parent Specifies an Edit Record widget. Widgets with the same Validation Parent are validated as a group.
Mandatory Boolean literal or expression that defines if the user input is required. Yes No
Source Record List Current list of records displayed by the widget.
Source Entity Data entity to populate the widget.
Source Attribute Specifies the attribute of the records in the list to populate the widget.
Source Identifier Attribute Attribute of the structure to be used as the identifier of the selected value.
Special Variable Holds the value selected by the user if this value belongs to the defined Special List. The variable must be of type Text, Phone Number, Email, Boolean, Integer, or Long Integer.
At runtime, if the user selects a value among the Source Entity/Structure list of values, this property will have the value "".
Width Width of the widget in columns. Other accepted units are pixels(px), 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.
Special List
Value Value assigned to the Special Variable.
Option Text displayed in the widget.

Runtime Properties

Name Description Read Only Type Observations
SpecialListValue SpecialListValue runtime property is deprecated. Consider using the Special Variable property instead. Text
Valid Always True for Combo 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
  • Was this article helpful?