README

[![Build status](https://travis-ci.org/PolymerElements/iron-selector.svg?branch=master)](https://travis-ci.org/PolymerElements/iron-selector)

_[Demo and API docs](https://elements.polymer-project.org/elements/iron-selector)_

##<iron-selector>

`iron-selector` is an element which can be used to manage a list of elements that can be selected. Tapping on the item will make the item selected. The `selected` indicates which item is being selected. The default is to use the index of the item.

Example:

```html

Item 1
Item 2
Item 3
```

If you want to use the attribute value of an element for `selected` instead of the index, set `attrForSelected` to the name of the attribute. For example, if you want to select item by `name`, set `attrForSelected` to `name`.

Example:

```html

Foo
Bar
Zot
```

You can specify a default fallback with `fallbackSelection` in case the `selected` attribute does not match the `attrForSelected` attribute of any elements.

Example:

```html

Foo
Bar
Default
```

Note: When the selector is multi, the selection will set to `fallbackSelection` iff the number of matching elements is zero.

`iron-selector` is not styled. Use the `iron-selected` CSS class to style the selected element.

Example:

```html

...

Item 1
Item 2
Item 3
```

Back to blog

Leave a comment