options

Sets or gets the options in a dropdown.

Description

Setting the options property sets all the options available to a user.

Set options to an empty array ([]) to remove the current dropdown options.

Getting the options property returns the current list of options available to a user.

You cannot modify the options array in-place. To add, change, or remove individual dropdown options:

Store the value of the options property in a variable.
Make changes to the options array.
Reset the options property with the modified array.

Type:

Array<Option>Read & Write, default value is An empty array

NAME

TYPE

DESCRIPTION

value

string

The value of the dropdown option. This is what you use in code and is what is stored in your collections. Mandatory if label is not specified.

label

string

The label of the dropdown option. This is what a user sees. Mandatory if value is not specified.

Was this helpful?

Get the list of options and the first option's label and value from dropdown

Copy Code

1let dropdownOptions = $w("#myDropdown").options;
2
3let firstLabel = dropdownOptions[0].label;  // "First Label"
4let firstValue = dropdownOptions[0].value;  // "first_value"

Set the list of options for a dropdown

Copy Code

1$w("#myDropdown").options = [
2  {"label": "Who's on first!", "value": "first"},
3  {"label": "What's on second", "value": "second"},
4  {"label": "I Don't Know is on third", "value": "third"}
5];

Add an option to a dropdown

This example retrieves the options of a dropdown, adds a new option, and then overwrites the old options.

Copy Code

1let opts = $w("#myDropdown").options;
2opts.push({"label": "New Label", "value": "New Value"});
3$w("#myDropdown").options = opts;
4