Index: third_party/polymer/v1_0/components-chromium/iron-input/README.md |
diff --git a/third_party/polymer/v1_0/components-chromium/iron-input/README.md b/third_party/polymer/v1_0/components-chromium/iron-input/README.md |
index 05a74b721248306a7850dbb636181e369c7f814e..70a74e96a3772e846639eadb3e394aafc45ab5e9 100644 |
--- a/third_party/polymer/v1_0/components-chromium/iron-input/README.md |
+++ b/third_party/polymer/v1_0/components-chromium/iron-input/README.md |
@@ -1,16 +1,49 @@ |
-# iron-input |
-An input with data binding. |
+<!--- |
+ |
+This README is automatically generated from the comments in these files: |
+iron-input.html |
+ |
+Edit those files, and our readme bot will duplicate them over here! |
+Edit this file, and the bot will squash your changes :) |
+ |
+--> |
+ |
+[](https://travis-ci.org/PolymerElements/iron-input) |
+ |
+_[Demo and API Docs](https://elements.polymer-project.org/elements/iron-input)_ |
+ |
+ |
+##<iron-input> |
+ |
+ |
+`<iron-input>` adds two-way binding and custom validators using `Polymer.IronValidatorBehavior` |
+to `<input>`. |
+ |
+### Two-way binding |
By default you can only get notified of changes to an `input`'s `value` due to user input: |
-```html |
-<input value="{{myValue::input}}"> |
-``` |
+ <input value="{{myValue::input}}"> |
`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 |
-<input is="iron-input" bind-value="{{myValue}}"> |
-``` |
+ <input is="iron-input" bind-value="{{myValue}}"> |
+ |
+### Custom validators |
+ |
+You can use custom validators that implement `Polymer.IronValidatorBehavior` with `<iron-input>`. |
+ |
+ <input is="iron-input" validator="my-custom-validator"> |
+ |
+### 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. |
+ |
+ <!-- only allow characters that match [0-9] --> |
+ <input is="iron-input" prevent-invalid-input allowed-pattern="[0-9]"> |
+ |
+ |