catapult/third_party/polymer/components/iron-jsonp-library/README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
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)_


## &lt;iron-jsonp-library&gt;

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.