diff options
author | Treehugger Robot <treehugger-gerrit@google.com> | 2020-08-05 22:45:32 +0000 |
---|---|---|
committer | Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com> | 2020-08-05 22:45:32 +0000 |
commit | a5e4f4d2969520f4563ec0d66cbe469c49ee38bc (patch) | |
tree | 8a0d6fd78eb610653f12ded770595c80f1e89a61 /catapult/third_party/polymer/components/iron-form/README.md | |
parent | 5e1447373f2b6aaefa0e866c5907a291e7071a3d (diff) | |
parent | 5338649baa46daab43dd19d939fc1f016d400a94 (diff) | |
download | chromium-trace-a5e4f4d2969520f4563ec0d66cbe469c49ee38bc.tar.gz |
Merge changes Ie9f01eed,I3acb8a0d am: fb769a1607 am: 316160b179 am: 3fd616f492 am: 5338649baa
Original change: https://android-review.googlesource.com/c/platform/external/chromium-trace/+/1392438
Change-Id: I01f6e9f32cc3210fbc5f6f645a77b74316ecfb3b
Diffstat (limited to 'catapult/third_party/polymer/components/iron-form/README.md')
-rw-r--r-- | catapult/third_party/polymer/components/iron-form/README.md | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/catapult/third_party/polymer/components/iron-form/README.md b/catapult/third_party/polymer/components/iron-form/README.md new file mode 100644 index 00000000..01357142 --- /dev/null +++ b/catapult/third_party/polymer/components/iron-form/README.md @@ -0,0 +1,52 @@ + +<!--- + +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 + +--> + +[![Build status](https://travis-ci.org/PolymerElements/iron-form.svg?branch=master)](https://travis-ci.org/PolymerElements/iron-form) + +_[Demo and API docs](https://elements.polymer-project.org/elements/iron-form)_ + + +## <iron-form> +`<iron-form>` is a wrapper around the HTML `<form>` element, that can +validate and submit both custom and native HTML elements. + +It has two modes: if `allow-redirect` is true, then after the form submission you +will be redirected to the server response. Otherwise, if it is false, it will +use an `iron-ajax` element to submit the form contents to the server. + + Example: + +```html + <iron-form> + <form method="get" action="/form/handler"> + <input type="text" name="name" value="Batman"> + <input type="checkbox" name="donuts" checked> I like donuts<br> + <paper-checkbox name="cheese" value="yes" checked></paper-checkbox> + </form> + </iron-form> +``` + +By default, a native `<button>` element (or `input type="submit"`) will submit this form. However, if you +want to submit it from a custom element's click handler, you need to explicitly +call the `iron-form`'s `submit` method. + + Example: + +```html + <paper-button raised onclick="submitForm()">Submit</paper-button> + + function submitForm() { + document.getElementById('iron-form').submit(); + } +``` |