diff options
Diffstat (limited to 'catapult/third_party/polymer/components/iron-jsonp-library/README.md')
-rw-r--r-- | catapult/third_party/polymer/components/iron-jsonp-library/README.md | 51 |
1 files changed, 51 insertions, 0 deletions
diff --git a/catapult/third_party/polymer/components/iron-jsonp-library/README.md b/catapult/third_party/polymer/components/iron-jsonp-library/README.md new file mode 100644 index 00000000..c93e1d6b --- /dev/null +++ b/catapult/third_party/polymer/components/iron-jsonp-library/README.md @@ -0,0 +1,51 @@ + +<!--- + +This README is automatically generated from the comments in these files: +iron-jsonp-library.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-jsonp-library.svg?branch=master)](https://travis-ci.org/PolymerElements/iron-jsonp-library) + +_[Demo and API docs](https://elements.polymer-project.org/elements/iron-jsonp-library)_ + + +## <iron-jsonp-library> + +Loads specified jsonp library. + +Example: + +```html +<iron-jsonp-library + library-url="https://apis.google.com/js/plusone.js?onload=%%callback%%" + notify-event="api-load" + library-loaded="{{loaded}}"></iron-jsonp-library> +``` + +Will emit 'api-load' event when loaded, and set 'loaded' to true + +Implemented by Polymer.IronJsonpLibraryBehavior. Use it +to create specific library loader elements. + + + +## Polymer.IronJsonpLibraryBehavior + +`Polymer.IronJsonpLibraryBehavior` loads a jsonp library. +Multiple components can request same library, only one copy will load. + +Some libraries require a specific global function be defined. +If this is the case, specify the `callbackName` property. + +You should use an HTML Import to load library dependencies +when possible instead of using this element. + + |