# 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