README

[](https://travis-ci.org/PolymerElements/iron-input)

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

## <iron-input>

`` adds two-way binding and custom validators using `Polymer.IronValidatorBehavior` to ``.

### Two-way binding

By default you can only get notified of changes to an `input`'s `value` due to user input:

```html ```

`iron-input` adds the `bind-value` property that mirrors the `value` property, and can be used for two-way data binding. `bind-value` will notify if it is changed either by user input or by script.

```html ```

### Custom validators

You can use custom validators that implement `Polymer.IronValidatorBehavior` with ``.

```html ```

### Stopping invalid input

It may be desirable to only allow users to enter certain characters. You can use the `prevent-invalid-input` and `allowed-pattern` attributes together to accomplish this. This feature is separate from validation, and `allowed-pattern` does not affect how the input is validated.

```html ```