amouravski@google.com
60b57c3a38
R=kathyw@google.com Review URL: https://codereview.chromium.org//51003002 git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@29462 260f80e4-7a28-3924-810f-c04153c831b5
44 lines
1.3 KiB
Markdown
44 lines
1.3 KiB
Markdown
# HTML Imports polyfill
|
|
|
|
[HTML Imports][1] are a way to include and reuse HTML documents in other HTML
|
|
documents. As `<script>` tags let authors include external Javascript in their
|
|
pages, imports let authors load full HTML resources. In particular, imports let
|
|
authors include [Custom Element](https://github.com/Polymer/CustomElements)
|
|
definitions from external URLs.
|
|
|
|
|
|
## Getting started
|
|
|
|
Include the `html_import.debug.js` or `html_import.min.js` (minified) file in
|
|
your project.
|
|
|
|
<script src="packages/html_import/html_import.debug.js"></script>
|
|
|
|
`html_import.debug.js` is the debug loader and uses `document.write` to load
|
|
additional modules.
|
|
|
|
Use the minified version (`html_import.min.js`) if you need to load the file
|
|
dynamically.
|
|
|
|
## Basic usage
|
|
|
|
For HTML imports use the `import` relation on a standard `<link>` tag, for
|
|
example:
|
|
|
|
<link rel="import" href="import-file.html">
|
|
|
|
## Polyfill details
|
|
|
|
You can read more about how the polyfill is implemented in JavaScript here:
|
|
<https://github.com/Polymer/HTMLImports/tree/master#polyfill-details>
|
|
|
|
## Getting the source code
|
|
|
|
This package is built from:
|
|
<https://github.com/Polymer/HTMLImports/tree/master>
|
|
|
|
You'll need [node.js](http://nodejs.org) to rebuild the JS file. Use
|
|
`npm install` to get dependencies and `grunt` to build.
|
|
|
|
[1]: https://dvcs.w3.org/hg/webcomponents/raw-file/tip/spec/imports/index.html
|