Picker
A widget with a drop-down list of items to choose from. Includes Widget API
Properties
itemText
Type: function
A function that returns the string to display for a given data item. Defaults to mapping items to their default string representation.
items
Type: any[]
An array of data items to be displayed by the picker. If the items aren’t strings, the itemText
property must be set to a function to extract item texts.
selection
Type: any
The currently selected data item.
selectionIndex
Type: number
The index of the currently selected item.
Events
“change:selection” (widget, selection, options)
Parameters:
Fired when the selection property changes.
“change:selectionIndex” (widget, selectionIndex, options)
Parameters:
- widget: Picker
- selectionIndex: number, the new value of selectionIndex.
- options: Object
Fired when the selectionIndex property changes.
“select” (widget, selection, options)
Parameters:
- widget: Picker
- selection: string, the new value of selection.
- options: Object, contains the index of the selected item, e.g.
{index: number}
Fired an item was selected by the user.