简单介绍HTML5中的文件导入

template、shadow dom及custom elements 让你创建ui组件比以前更容易了。但是像html、css、javascript这样的资源仍然需要一个个地去加载，这是很没效率的。

删除重复依赖也并不简单。例如，现在加载jquery ui或bootstrap就需要为javascript、css及web fonts添加单独的标签。如果你的web 组件应用了多重的依赖，那事情就变得更为复杂。

html 导入让你以一个合并的html文件来加载这些资源。
使用html导入

为加载一个html文件，你需要增加一个link标签，其rel属性为import，herf属性是html文件的路径。例如，如果你想把component.html加载到index.html：

index.html
 

xml/html code复制内容到剪贴板

1. <link rel="import" href="component.html" >    

你可以往html导入文件（译者注：本文将“ the imported html”译为“html导入文件”，将“the original html”译为“html主文件”。例如，index.html是html主文件，component.html是html导入文件。）添加任何的资源，包括脚本、样式表及字体，就跟往普通的html添加资源一样。

component.html
 

xml/html code复制内容到剪贴板

1. <link rel="stylesheet" href="css/style.css">  
2. <script src="js/script.js"></script>  

doctype、html、 head、 body这些标签是不需要的。html 导入会立即加载要导入的文档，解析文档中的资源，如果有脚本的话也会立即执行它们。
执行顺序

浏览器解析html文档的方式是线性的，这就是说html顶部的script会比底部先执行。并且，浏览器通常会等到javascript代码执行完毕后，才会接着解析后面的代码。

为了不让script 妨碍html的渲染，你可以在标签中添加async或defer属性（或者你也可以将script 标签放到页面的底部）。defer 属性会延迟脚本的执行，直到全部页面解析完毕。async 属性让浏览器异步地执行脚本，从而不会妨碍html的渲染。那么，html 导入是怎样工作的呢？

html导入文件中的脚本就跟含有defer属性一样。例如在下面的示例中，index.html会先执行script1.js和script2.js ，然后再执行script3.js。

index.html
 

xml/html code复制内容到剪贴板

1. <link rel="import" href="component.html"> // 1.   
2. <title>import example</title>  
3. <script src="script3.js"></script>        // 4.  

component.html
 

xml/html code复制内容到剪贴板

1. <script src="js/script1.js"></script>     // 2.   
2. <script src="js/script2.js"></script>     // 3.  

1.在index.html 中加载component.html并等待执行

2.执行component.html中的script1.js

3.执行完script1.js后执行component.html中的script2.js

4.执行完 script2.js继而执行index.html中的script3.js

注意，如果给link[rel="import"]添加async属性，html导入会把它当做含有async属性的脚本来对待。它不会等待html导入文件的执行和加载，这意味着html 导入不会妨碍html主文件的渲染。这也给提升网站性能带来了可能，除非有其他的脚本依赖于html导入文件的执行。
跨域导入

从根本上说，html导入是不能从其他的域名导入资源的。

比如，你不能从http://webcomponents.org/向 http://example.com/ 导入html 文件。为了绕过这个限制，可以使用cors（跨域资源共享）。想了解cors，请看这篇文章。
html导入文件中的window和document对象

前面我提过在导入html文件的时候里面的脚本是会被执行的，但这并不意味着html导入文件中的标签也会被浏览器渲染。你需要写一些javascript代码来帮忙。

当在html导入文件中使用javascript时，有一点要提防的是，html导入文件中的document对象实际上指的是html主文件中的document对象。以前面的代码为例，index.html和  component.html 的document都是指index.html的document对象。怎么才能使用html导入文件中的document 呢？借助link中的import 属性。

index.html
 

xml/html code复制内容到剪贴板

1. var link = document.queryselector('link[rel="import"]');   
2. link.addeventlistener('load', function(e) {   
3.   var importeddoc = link.import;   
4.   // importeddoc points to the document under component.html   
5. });  

为了获取component.html中的document 对象，要使用document.currentscript.ownerdocument.

component.html
 

xml/html code复制内容到剪贴板

1. var maindoc = document.currentscript.ownerdocument;   
2. // maindoc points to the document under component.html  

如果你在用webcomponents.js，那么就用document._currentscript来代替document.currentscript。下划线用于填充currentscript属性，因为并不是所有的浏览器都支持这个属性。

component.html

 

xml/html code复制内容到剪贴板

1. var maindoc = document._currentscript.ownerdocument;   
2. // maindoc points to the document under component.html   

通过在脚本开头添加下面的代码，你就可以轻松地访问component.html中的document对象，而不用管浏览器是不是支持html导入。

document._currentscript = document._currentscript || document.currentscript;
性能方面的考虑

使用html 导入的一个好处是能够将资源组织起来，但是也意味着在加载这些资源的时候，由于使用了一些额外的html文件而让头部变得过大。有几点是需要考虑的：
解析依赖

假如html主文件要依赖多个导入文件，而且导入文件中含有相同的库，这时会怎样呢？例如，你要从导入文件中加载jquery，如果每个导入文件都含有加载jquery的script标签，那么jquery就会被加载两次，并且也会被执行两次。

index.html
 

xml/html code复制内容到剪贴板

1. <link rel="import" href="component1.html">  
2. <link rel="import" href="component2.html">  

component1.html
 

xml/html code复制内容到剪贴板

1. <script src="js/jquery.js"></script>  

component2.html
 
html导入自动帮你解决了这个问题。

与加载两次script标签的做法不同，html 导入对已经加载过的html文件不再进行加载和执行。以前面的代码为例，通过将加载jquery的script标签打包成一个html导入文件，这样jquery就只被加载和执行一次了。

但这还有一个问题：我们增加了一个要加载的文件。怎么处理数目膨胀的文件呢？幸运的是，我们有一个叫vulcanize的工具来解决这个问题。
合并网络请求

vulcanize 能将多个html文件合并成一个文件，从而减少了网络连接数。你可以借助npm安装它，并且用命令行来使用它。你可能也在用 grunt和gulp 托管一些任务，这样的话你可以把vulcanize作为构建过程的一部分。

为了解析依赖以及合并index.html中的导入文件，使用如下命令：

复制代码

代码如下:

$ vulcanize -o vulcanized.html index.html

通过执行这个命令，index.html中的依赖会被解析，并且会产生一个合并的html文件，称作 vulcanized.html。学习更多有关vulcanize的知识，请看这儿。

注意：http2的服务器推送功能被考虑用于以后消除文件的连结与合并。
把template、shadow dom、自定义元素跟html导入结合起来

让我们对这个文章系列的代码使用html导入。你之前可能没有看过这些文章，我先解释一下：template可以让你用声明的方式定义你的自定义元素的内容。shadow dom可以让一个元素的style、id、class只作用到其本身。自定义元素可以让你自定义html标签。通过把这些跟html导入结合起来，你自定义的web 组件会变得模块化，具有复用性。任何人添加一个link标签就可以使用它。

x-component.html

 

xml/html code复制内容到剪贴板

1. <template id="template">  
2.   <style>  
3.     ...   
4.   </style>  
5.   <div id="container">  
6.     <img src="http://webcomponents.org/img/logo.svg">  
7.     <content select="h1"></content>  
8.   </div>  
9. </template>  
10. <script>  
11.   // this element will be registered to index.html   
12.   // because `document` here means the one in index.html   
13.   var xcomponent = document.registerelement('x-component', {   
14.     prototype: object.create(htmlelement.prototype, {   
15.       createdcallback: {   
16.         value: function() {   
17.           var root = this.createshadowroot();   
18.           var template = document.queryselector('#template');   
19.           var clone = document.importnode(template.content, true);   
20.           root.appendchild(clone);   
21.         }   
22.       }   
23.     })   
24.   });   
25. </script>  

index.html
 

xml/html code复制内容到剪贴板

1. ...   
2.   <link rel="import" href="x-component.html">  
3. </head>  
4. <body>  
5.   <x-component>  
6.     <h1>this is custom element</h1>  
7.   </x-component>  
8.   ...  

注意，因为x-component.html 中的document 对象跟index.html的一样，你没必要再写一些棘手的代码，它会自动为你注册。
支持的浏览器

chrome 和 opera提供对html导入的支持，firefox要在2014年12月后才支持（mozilla表示firefox不计划在近期提供对html导入的支持，声称需要首先了解es6的模块是怎样实现的）。

你可以去chromestatus.com或caniuse.com查询浏览器是否支持html导入。想要在其他浏览器上使用html导入，可以用webcomponents.js（原名platform.js）。
相关资源

html导入就介绍这么多了。如果你想学更多关于html导入的知识，请前往：

    html imports: #include for the web – html5rocks
    html imports spec