Simple Example

Just selecting a single value from a list. If this is all you need to do you should probably just use a select element.

open example on its own page

Multi Select

Choose some programming languages, no need to just pick 1.

open example on its own page

Option Groups

You can give your options a little more organization by grouping them.

open example on its own page

Options with Descriptions

Sometimes just a human friendly label for an option isn't enough, and you'd like to add a little extra "color".

You can filter your results by typing, <much-select> will also use the descriptions when trying to find the option you want.

Options Label and Values

The labels and values are different

An initial value

Set using the selected attribute on the <much-select>

A Placeholder

Disabled

Disable the <much-select> with the disabled attribute.

Loading

Show and hide the loading indicator with the loading="" attribute.

Disabled Options

This has the "yellow" and "orange" options disabled.

Change Options With the Dom

Remote API

As you type we'll query the remote API for additional options.

This dropdown searches the Rick and Morty API for characters from the show by name.

open example on its own page

Custom Options That Persist

Events Only Mode

The events-only="" attribute is a little specialized, it is for when you are in a situation where something else really wants to have full control over the DOM. Elm would an example of this. In this case, we only want the much-select element to emmit events and leave it up to "something else" to managed its attributes.

Output Style - Datalist