| Index: third_party/polymer/components/iron-form/README.md
 | 
| diff --git a/third_party/polymer/components/iron-form/README.md b/third_party/polymer/components/iron-form/README.md
 | 
| new file mode 100644
 | 
| index 0000000000000000000000000000000000000000..e02ebd382733834961ce9cc9f952c6ab9aa2ffe8
 | 
| --- /dev/null
 | 
| +++ b/third_party/polymer/components/iron-form/README.md
 | 
| @@ -0,0 +1,78 @@
 | 
| +
 | 
| +<!---
 | 
| +
 | 
| +This README is automatically generated from the comments in these files:
 | 
| +iron-form.html
 | 
| +
 | 
| +Edit those files, and our readme bot will duplicate them over here!
 | 
| +Edit this file, and the bot will squash your changes :)
 | 
| +
 | 
| +The bot does some handling of markdown. Please file a bug if it does the wrong
 | 
| +thing! https://github.com/PolymerLabs/tedium/issues
 | 
| +
 | 
| +-->
 | 
| +
 | 
| +[](https://travis-ci.org/PolymerElements/iron-form)
 | 
| +
 | 
| +_[Demo and API docs](https://elements.polymer-project.org/elements/iron-form)_
 | 
| +
 | 
| +
 | 
| +##<iron-form>
 | 
| +
 | 
| +`<iron-form>` is an HTML `<form>` element that can validate and submit any custom
 | 
| +elements that implement `Polymer.IronFormElementBehavior`, as well as any
 | 
| +native HTML elements. For more information on which attributes are
 | 
| +available on the native form element, see [https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form)
 | 
| +
 | 
| +It supports both `get` and `post` methods, and uses an `iron-ajax` element to
 | 
| +submit the form data to the action URL.
 | 
| +
 | 
| +  Example:
 | 
| +
 | 
| +```html
 | 
| +<form is="iron-form" id="form" method="post" action="/form/handler">
 | 
| +  <paper-input name="name" label="name"></paper-input>
 | 
| +  <input name="address">
 | 
| +  ...
 | 
| +</form>
 | 
| +```
 | 
| +
 | 
| +By default, a native `<button>` element will submit this form. However, if you
 | 
| +want to submit it from a custom element's click handler, you need to explicitly
 | 
| +call the form's `submit` method.
 | 
| +
 | 
| +  Example:
 | 
| +
 | 
| +```html
 | 
| +<paper-button raised onclick="submitForm()">Submit</paper-button>
 | 
| +
 | 
| +function submitForm() {
 | 
| +  document.getElementById('form').submit();
 | 
| +}
 | 
| +```
 | 
| +
 | 
| +To customize the request sent to the server, you can listen to the `iron-form-presubmit`
 | 
| +event, and modify the form's[`iron-ajax`](https://elements.polymer-project.org/elements/iron-ajax)
 | 
| +object. However, If you want to not use `iron-ajax` at all, you can cancel the
 | 
| +event and do your own custom submission:
 | 
| +
 | 
| +  Example of modifying the request, but still using the build-in form submission:
 | 
| +
 | 
| +```javascript
 | 
| +form.addEventListener('iron-form-presubmit', function() {
 | 
| +  this.request.method = 'put';
 | 
| +  this.request.params = someCustomParams;
 | 
| +});
 | 
| +```
 | 
| +
 | 
| +  Example of bypassing the build-in form submission:
 | 
| +
 | 
| +```javascript
 | 
| +form.addEventListener('iron-form-presubmit', function(event) {
 | 
| +  event.preventDefault();
 | 
| +  var firebase = new Firebase(form.getAttribute('action'));
 | 
| +  firebase.set(form.serialize());
 | 
| +});
 | 
| +```
 | 
| +
 | 
| +
 | 
| 
 |