A field for the user to make a selection from a scrollable list of predefined options.

Adding Picker component

  • Select the Picker component from the Components drawer. You can open the list of components by clicking the + button next to Components.
  • To display pre-defined values, add an array as a variable from the Variables modal in the top panel.
800
  • Then, add the Picker component from the Components tree.
  • Go to the Data tab (third tab) in the Properties Panel.
  • For the Options property, select the variable key (in the example below, data is the key that contains an array of strings).
  • Add an empty string "" in the Initial Value property.

Configuration Properties

PropertyDescription
Component nameTo alter the name of the component. The name is reflected in the Components tree. Defaults to Picker.
Icon SizeSize of the icon.
Icon ColorTo select the colour of the icon.
PlaceholderPlaceholder text to display in the picker when the user has not made a selection.
Placeholder Text ColorAllows you to set the color of the placeholder text.
Assistive TextHelper text to be displayed underneath the picker, useful for providing additional instructions.
DisabledWhen enabled, the picker will be grayed out and the user will not be able to make a selection.
Left Icon NameThe name of the icon selected from the icon picker to be displayed on the left.
Left Icon ModeAllows you to select the placement of the left icon, if one is selected. Inset displays the icon inside the border of the picker and outset displays the icon outside of the picker border.
Right Icon NameThe name of the icon selected from the icon picker to be displayed inset on the right.
AppearanceAppearance of the picker modal.

Available values: sold or underlined.

Data Configuration

PropertyDescription
LabelThe label of the picker which is displayed directly above the selected date.
OptionsHere you are able to add the list options you want to be displayed in the picker with each option separated by a comma.

The source of data can be static or remote (coming from a data source).

For example, you can pass the options as [{"label":"foo","value":42},{"label":"bar","value":126}].

The label is the key for each value displayed in the Picker component.
ErrorWhen enabled, an outline matching the theme's defined Error color will appear around the picker.

Must be a boolean value: true or false.
Data SourceInitialize the stateful component with a value from a data source.