aboutsummaryrefslogtreecommitdiff
path: root/catapult/third_party/polymer/components/iron-form/README.md
diff options
context:
space:
mode:
authorTreehugger Robot <treehugger-gerrit@google.com>2020-08-05 22:45:32 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>2020-08-05 22:45:32 +0000
commita5e4f4d2969520f4563ec0d66cbe469c49ee38bc (patch)
tree8a0d6fd78eb610653f12ded770595c80f1e89a61 /catapult/third_party/polymer/components/iron-form/README.md
parent5e1447373f2b6aaefa0e866c5907a291e7071a3d (diff)
parent5338649baa46daab43dd19d939fc1f016d400a94 (diff)
downloadchromium-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.md52
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)_
+
+
+## &lt;iron-form&gt;
+`<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();
+ }
+```