| Index: third_party/polymer/v0_8/components/iron-meta/README.md
|
| diff --git a/third_party/polymer/v0_8/components/iron-meta/README.md b/third_party/polymer/v0_8/components/iron-meta/README.md
|
| index 819e336beab75053a7f1fd7bae255d520778ccd3..b3b0f273b6bc6ef92a60d31a9c3c5e2f524e36a5 100644
|
| --- a/third_party/polymer/v0_8/components/iron-meta/README.md
|
| +++ b/third_party/polymer/v0_8/components/iron-meta/README.md
|
| @@ -1,4 +1,46 @@
|
| iron-meta
|
| =========
|
|
|
| -See the [component page](http://polymerelements.github.io/iron-meta) for more information.
|
| +`iron-meta` is a generic element you can use for sharing information across the DOM tree.
|
| +It uses [monostate pattern](http://c2.com/cgi/wiki?MonostatePattern) such that any
|
| +instance of iron-meta has access to the shared
|
| +information. You can use `iron-meta` to share whatever you want (or create an extension
|
| +[like x-meta] for enhancements).
|
| +
|
| +The `iron-meta` instances containing your actual data can be loaded in an import,
|
| +or constructed in any way you see fit. The only requirement is that you create them
|
| +before you try to access them.
|
| +
|
| +Examples:
|
| +
|
| +If I create an instance like this:
|
| +
|
| +```html
|
| +<iron-meta key="info" keyUrl="foo/bar"></iron-meta>
|
| +```
|
| +
|
| +Note that keyUrl="foo/bar" is the metadata I've defined. I could define more
|
| +attributes or use child nodes to define additional metadata.
|
| +
|
| +Now I can access that element (and it's metadata) from any iron-meta instance
|
| +via the byKey method, e.g.
|
| +
|
| +```javascript
|
| +meta.byKey('info').getAttribute('keyUrl').
|
| +```
|
| +
|
| +Pure imperative form would be like:
|
| +
|
| +```javascript
|
| +document.createElement('iron-meta').byKey('info').getAttribute('keyUrl');
|
| +```
|
| +
|
| +Or, in a Polymer element, you can include a meta in your template:
|
| +
|
| +```html
|
| +<iron-meta id="meta"></iron-meta>
|
| +```
|
| +
|
| +```javascript
|
| +this.$.meta.byKey('info').getAttribute('keyUrl');
|
| +```
|
|
|