HTML Imports
为什么需要导入? 先想想你在 web 上是如何加载不同类型的资源。对于 JS,我们有 <script src>
。<link rel="stylesheet">
应该是 CSS 的首选。图片可以用 <img>
。视频则有 <video>
。音频,<audio>
…… 你明白我在说什么了吧! web 上绝大部分的内容都有简单明了的加载方式。可对于 HTML 呢?下面是可选的几种方案:
<iframe>
- 可用但笨重。iframe 中的内容全部存在于一个不同于当前页的独立上下文中。这是个很棒的特性,但也为开发者们带来了额外的挑战 (将 frame 按照内容尺寸来缩放已经有点难度,在 iframe 和当前页面之间写点 JS 能把人绕晕,更别提操作样式了)。 AJAX - 我喜欢 xhr.responseType="document",可是加载 HTML 要用 JS? 这就不大对劲了。 CrazyHacks™ - 用字符串的方式嵌入页面,像注释一样隐藏 (例如 <script type="text/html">
)。呕! 可笑不? 作为 web 上最基础的内容,HTML,竟然需要这么麻烦才能得到我们想要的结果。幸运的是,Web Components 总算找到了一条正确的路。
开始
HTML 导入,Web Components 阵容中的一员,是在其他 HTML 文档中包含 HTML 文档的一种方法。当然并非仅限于此,你还可以包含 CSS,JavaScript,或 .html 文件中能包含的任何内容。换句话说,这使得导入成为了加载相关 HTML/CSS/JS 的神器。
基础
通过声明 <link rel="import">
来在页面中包含一个导入 :
<head>
<link rel="import" href="/path/to/imports/stuff.html">
</head>
导入中的 URL 被称为 导入地址。若想跨域导入内容,导入地址必须允许 CORS:
<!-- 其他域内的资源必须允许 CORS -->
<link rel="import" href="http://example.com/elements.html">
浏览器的网络协议栈(network stack)会对访问相同 URL 的请求自动去重。这意味着从同一个 URL 导入的内容只会被获取一次。无论这个地址被导入多少次,最终它将只执行一次。
特性检测与支持
要检测浏览器是否支持导入,可验证 <link> 元素上是否存在 import:
function supportsImports() {
return 'import' in document.createElement('link');
}
if (supportsImports()) {
// 支持导入!
} else {
// 使用其他的库来加载文件。
}
目前支持该特性的浏览器比较有限。Chrome 31 最先实现了该特性。你可以在 about:flags 页面中启用 Enable HTML Imports。对于其他浏览器可以使用 Polymer 的 polyfill。
在 about:flags 中 启用 HTML Imports。 开启 experimental Web Platform features 可以体验 web component 中的其他实验特性。
打包资源
可以使用导入将 HTML/CSS/JS (甚至其他 HTML 导入) 打包成一个单独的可传递文件。这是个不容忽视的特点。假设你写了一套主题,库,或仅仅想把你的应用按照逻辑拆分,你也仅需给其他人提供一个 URL。天呐,你甚至可以用导入来传输整个应用,想想这该有多棒。
仅用一个 URL,你就可以将多个文件打包成一个文件提供给他人使用。 一个现实中的例子是 Bootstrap。Bootstrap 由多个单独的文件组成 (bootstrap.css,bootstrap.js,字体), 它的插件依赖于 jQuery,并提供了带标记的例子。开发者们喜欢拥有像去餐厅点菜一样的灵活性。这允许开发者只加载框架中 他们 想用的内容。
导入对于类似 Bootstrap 的内容来说意义非凡,下面我将展示未来加载 Bootstrap 的方式:
<head>
<link rel="import" href="bootstrap.html">
</head>
用户只需加载一个 HTML Import 链接。他们再也不用为那些乱七八糟的文件而烦心。相反,整个 Bootstrap 都将包裹在一个导入 bootstrap.html 之中:
<link rel="stylesheet" href="bootstrap.css">
<link rel="stylesheet" href="fonts.css">
<script src="jquery.js"></script>
<script src="bootstrap.js"></script>
<script src="bootstrap-tooltip.js"></script>
<script src="bootstrap-dropdown.js"></script>
...
<!-- 脚手架标记 -->
<template>
...
</template>
让这一切都快点变成现实吧,这玩意简直太棒了!
Load/error 事件
当导入成功时 <link> 元素会触发 load 事件,加载失败时 (例如资源出现 404) 则会触发 error。
导入会尝试立即加载。一个简单的办法是使用 onload/onerror 特性:
<script async>
function handleLoad(e) {
console.log('Loaded import: ' + e.target.href);
}
function handleError(e) {
console.log('Error loading import: ' + e.target.href);
}
</script>
<link rel="import" href="file.html"
onload="handleLoad(event)" onerror="handleError(event)">
注意上面事件处理的定义要早于导入开始加载页面。浏览器一旦解析到导入的标签,它就会立即加载资源。如果此时处理函数不存在,你将在控制台看到函数名未定义的错误。
或者,你可以动态创建导入:
var link = document.createElement('link');
link.rel = 'import';
link.href = 'file.html'
link.onload = function(e) {...};
link.onerror = function(e) {...};
document.head.appendChild(link);
使用内容
在页面中包含导入并不意味着 ”把那个文件的内容都塞到这”。它表示 ”解析器,去把这个文档给我取回来好让我用”。若想真正的使用该文档的内容,你得写点脚本。
当你意识到导入就是一个文档时,你肯定会 啊哈! 一声。事实上,导入的内容被称为 导入文档。你可以 使用标准的 DOM API 来操作导入的内容!
link.import
若想访问导入的内容,需要使用 link 元素的 import 属性:
var content = document.querySelector('link[rel="import"]').import;
在下面几种情况下,link.import 值为 null :
浏览器不支持 HTML 导入。 <link>
没有 rel="import"。 <link>
没有被加入到 DOM 中。 <link>
从 DOM 中被移除。 资源没有开启 CORS。 完整示例
假设 warnings.html 包含如下内容:
<div class="warning">
<style scoped>
h3 {
color: red;
}
</style>
<h3>Warning!</h3>
<p>This page is under construction</p>
</div>
<div class="outdated">
<h3>Heads up!</h3>
<p>This content may be out of date</p>
</div>
你可以获取导入文档中的一部分并把它们复制到当前页面中:
<head>
<link rel="import" href="warnings.html">
</head>
<body>
...
<script>
var link = document.querySelector('link[rel="import"]');
var content = link.import;
// 从 warning.html 的文档中获取 DOM。
var el = content.querySelector('.warning');
document.body.appendChild(el.cloneNode(true));
</script>
</body>
在导入中使用脚本
导入的内容并不在主文档中。它们仅仅作为主文档的附属而存在。即便如此,导入的内容还是能够在主页面中生效。导入能够访问它自己的 DOM 或/和包含它的页面中的 DOM:
示例 - import.html 向主页面中添加它自己的样式表
<link rel="stylesheet" href="http://www.example.com/styles.css">
<link rel="stylesheet" href="http://www.example.com/styles2.css">
...
<script>
// importDoc 是导入文档的引用
var importDoc = document.currentScript.ownerDocument;
// mainDoc 是主文档(包含导入的页面)的引用
var mainDoc = document;
// 获取导入中的第一个样式表,复制,
// 将它附加到主文档中。
var styles = importDoc.querySelector('link[rel="stylesheet"]');
mainDoc.head.appendChild(styles.cloneNode(true));
</script>
留意这里的操作。导入中的脚本获得了导入文档的引用 (document.currentScript.ownerDocument),随后将导入文档中的部分内容附加到了主页面中 (mainDoc.head.appendChild(…))。这段代码看起来不怎么优雅。
导入中的脚本要么直接运行代码,要么就定义个函数留给主页面使用。这很像 Python 中模块定义的方式。
导入中 JavaScript 的规则: 导入中的脚本会在包含导入文档的 window 上下文中运行。因此 window.document 关联的是主页面文档。这会产生两个有用的推论: 导入中定义的函数最终会出现在 window 上。 你不用将导入文档中的 <script>
块附加到主页面。再重申一遍,脚本会自动执行。 导入不会阻塞主页面的解析。不过,导入文档中的脚本会按照顺序执行。它们对于主页面来说就像拥有了延迟(defer)执行的行为。后面会详细讲解。 传输 Web Component
HTML 导入的设计很好的契合了在 web 上加载重用资源的需求。尤其是对于分发 Web Component。无论是基本的 HTML <template>
还是十分成熟的自定义元素/Shadow DOM [1,2,3]。当把这些技术结合在一起使用时,导入就充当了 Web Component 中 #include 的角色。 包含模板 HTML Template 元素是 HTML 导入的好搭档。<template>
特别适合于为需要导入的应用搭建必要的标记。将内容包裹在一个 <template>
元素中还为你提供了延迟加载内容的好处。也就是说,在 template 元素加入到 DOM 之前,它包含的脚本不会执行。 import.html
<template>
<h1>Hello World!</h1>
<img src="world.png"> <!-- 只有当模板生效后才会去请求图片 -->
<script>alert("Executed when the template is activated.");</script>
</template>
index.html
<head>
<link rel="import" href="import.html">
</head>
<body>
<div id="container"></div>
<script>
var link = document.querySelector('link[rel="import"]');
// 从导入中复制 <template>。
var template = link.import.querySelector('template');
var content = template.content.cloneNode(true)
document.querySelector('#container').appendChild(content);
</script>
</body>
注册自定义元素 自定义元素是 Web Component 技术中的另一位成员,它和 HTML 导入也是出奇的搭配。导入能够运行脚本,既然如此,为什么不定义 + 注册你自己的自定义元素,这样一来用户就避免重复操作了呢? 让我们就叫它..."自动注册(auto-registration)"。
elements.html
<script>
// 定义并注册 <say-hi>。
var proto = Object.create(HTMLElement.prototype);
proto.createdCallback = function() {
this.innerHTML = 'Hello, <b>' +
(this.getAttribute('name') || '?') + '</b>';
};
document.register('say-hi', {prototype: proto});
// 定义并注册使用了 Shadow DOM 的 <shadow-element>。
var proto2 = Object.create(HTMLElement.prototype);
proto2.createdCallback = function() {
var root = this.createShadowRoot();
root.innerHTML = "<style>::content > *{color: red}</style>" +
"I'm a " + this.localName +
" using Shadow DOM!<content></content>";
};
document.register('shadow-element', {prototype: proto2});
</script>
这个导入定义 (并注册) 了两个元素,<say-hi> 和 <shadow-element>。主页面可以直接使用它们,无需做任何额外操作。
index.html
<head>
<link rel="import" href="elements.html">
</head>
<body>
<say-hi name="Eric"></say-hi>
<shadow-element>
<div>( I'm in the light dom )</div>
</shadow-element>
</body>
在我看来,这样的工作流程使得 HTML 导入成为了共享 Web Components 的理想方式。 管理依赖和子导入 嘿。听说你挺喜欢导入, 所以我就在你的导入里又加了个导入。 子导入(Sub-imports) 若导入能够嵌套将会提供更多便利。例如,如果你想复用或继承另一个组件,使用导入加载其他元素。 下面是 Polymer 中的真实例子。通过复用布局还有选择器组件,我们得到了一个新的选项卡组件 (<polymer-ui-tabs>)。它们的依赖通过 HTML 导入来管理。
polymer-ui-tabs.html
<link rel="import" href="polymer-selector.html">
<link rel="import" href="polymer-flex-layout.html">
<polymer-element name="polymer-ui-tabs" extends="polymer-selector" ...>
<template>
<link rel="stylesheet" href="polymer-ui-tabs.css">
<polymer-flex-layout></polymer-flex-layout>
<shadow></shadow>
</template>
</polymer-element>
完整源码 应用开发者可以引入这个新元素:
<link rel="import" href="polymer-ui-tabs.html">
<polymer-ui-tabs></polymer-ui-tabs>
若以后出现了一个更新,更棒的 <polymer-selector2>
,你就可以毫不犹豫的用它替换 <polymer-selector>
。多亏有了导入和 web 组件,你再也不用担心惹恼你的用户了。 依赖管理 我们都知道一个页面载入多个 jQuery 会出问题。若是多个组件引用了相同的库,对于 Web 组件来说会不会是个严重的问题? 如果使用 HTML 引用,你就完全不用担心! 导入可以用来管理这些依赖。 将库放进一个 HTML 导入中,就自动避免了重复加载问题。文档只会被解析一次。脚本也只执行一次。来举个例子吧,比如说你定义了一个导入,jquery.html,它会加载 JQuery。 jquery.html
<script src="http://cdn.com/jquery.js"></script>
这个导入可以被其他导入复用: import2.html
<link rel="import" href="jquery.html">
<div>Hello, I'm import 2</div>
ajax-element.html
<link rel="import" href="jquery.html">
<link rel="import" href="import2.html">
<script>
var proto = Object.create(HTMLElement.prototype);
proto.makeRequest = function(url, done) {
return $.ajax(url).done(function() {
done();
});
};
document.register('ajax-element', {prototype: proto});
</script>
若主页面也需要这个库,连它也可以包含 jquery.html:
<head>
<link rel="import" href="jquery.html">
<link rel="import" href="ajax-element.html">
</head>
<body>
...
<script>
$(document).ready(function() {
var el = document.createElement('ajax-element');
el.makeRequest('http://example.com');
});
</script>
</body>
尽管 jquery.html 被加进了多个导入树中,浏览器也只会获取一次它的文档。查看网络面板就能证明这一切: jquery.html is requested once 性能注意事项 HTML 导入绝对是个好东西,但就像许多其他新技术一样,你得明智的去使用它。Web 开发的最佳实践还是需要遵守。下面是一些需要留意的地方。 合并导入 减少网络请求始终是重点。如果需要很多最顶层的导入,那就考虑把它们合并在一个资源里,然后导入该资源! Vulcanizer 是由 Polymer 团队开发的 npm 构建工具,它能够递归的展开一组 HTML 导入并生成一个单独的文件。可以把它看成构建 Web 组件中合并的步骤。 导入影响浏览器缓存 许多人似乎都忘记了浏览器的网络协议栈经过了多年的精心调整。导入 (包括子导入) 也从中受益。导入 http://cdn.com/bootstrap.html 可能包含子资源,但它们都将被缓存起来。 内容只有在被添加后才是可用的 把导入的内容看成是惰性的,只有当你调用它的服务时它才生效。 看看这个动态创建的样式表:
var link = document.createElement('link');
link.rel = 'stylesheet';
link.href = 'styles.css';
在 link 被加入到 DOM 之前,浏览器不会去请求 styles.css:
document.head.appendChild(link); // 浏览器请求 styles.css
另一个例子就是动态创建标签:
var h2 = document.createElement('h2');
h2.textContent = 'Booyah!';
在你把 h2 添加到 DOM 之前它没有意义。 同样的概念对于导入文档也适用。在你将内容追加到 DOM 之前,它就是一个空操作。实际上,在导入文档中直接 "运行" 的只有 <script>
。参见导入中的脚本操作。 优化异步载入 导入不会阻塞主页面解析。导入中的脚本会按照顺序执行,但也不会阻塞主页面。这意味着你在维护脚本顺序时获得了类似于延迟加载的行为。将导入放到 <head>
的好处在于它可以让解析器尽快的去解析导入的内容。即便如此,你还得记得主页面中的 <script>
仍然 会阻塞页面:
<head>
<link rel="import" href="/path/to/import_that_takes_5secs.html">
<script>console.log('I block page rendering');</script>
</head>
根据你的应用架构和使用场景不同,有几种方法可以优化异步行为。下面要使用的技巧可以缓解对主页面渲染的阻塞。
场景 #1 (推荐): <head>
中没有脚本或 <body>
没有内联脚本
我对放置 <script>
的建议就是不要紧跟着你的导入。把它们尽可能远的放置…你肯定早就按照最佳实践这么做了,不是吗!?;)
看个例子:
<head>
<link rel="import" href="/path/to/import.html">
<link rel="import" href="/path/to/import2.html">
<!-- 避免在这放脚本 -->
</head>
<body>
<!-- 避免在这放脚本 -->
<div id="container"></div>
<!-- 避免在这放脚本 -->
...
<script>
// 其他的脚本。
// 获得导入内容。
var link = document.querySelector('link[rel="import"]');
var post = link.import.querySelector('#blog-post');
var container = document.querySelector('#container');
container.appendChild(post.cloneNode(true));
</script>
</body>
所有内容都放到底部。
场景 1.5: 导入添加自己的内容
另一个选择是让导入添加自己的内容. 若导入的作者和应用开发者之间达成了某种约定,那么导入就可以将它自身加入到主页面的某个位置:
import.html:
<div id="blog-post">...</div>
<script>
var me = document.currentScript.ownerDocument;
var post = me.querySelector('#blog-post');
var container = document.querySelector('#container');
container.appendChild(post.cloneNode(true));
</script>
index.html
<head>
<link rel="import" href="/path/to/import.html">
</head>
<body>
<!-- 不需要写脚本。导入会自己处理 -->
</body>
场景 #2: <head>
或 <body>
中有(内联)脚本
若某个导入的加载需要耗费很长时间,跟在导入后面的第一个 <script>
将会阻塞页面渲染。以 Google Analytics 为例,它推荐将跟踪代码放在 <head>
中,若你必须将 <script>
放到 <head>
中,那么动态的添加导入将会避免阻塞页面:
<head>
<script>
function addImportLink(url) {
var link = document.createElement('link');
link.rel = 'import';
link.href = url;
link.onload = function(e) {
var post = this.import.querySelector('#blog-post');
var container = document.querySelector('#container');
container.appendChild(post.cloneNode(true));
};
document.head.appendChild(link);
}
addImportLink('/path/to/import.html'); // 导入被提前添加 :)
</script>
<script>
// 其他脚本
</script>
</head>
<body>
<div id="container"></div>
...
</body>
或者,将导入放到 <body> 结束处:
<head>
<script>
// 其他脚本
</script>
</head>
<body>
<div id="container"></div>
...
<script>
function addImportLink(url) { ... }
addImportLink('/path/to/import.html'); // 导入很晚才能被添加 :(
</script>
</body>
注意: 不推荐最后的方法。解析器在解析页面结束之前不会去操作导入的内容。
要点 导入的 MIME 类型是 text/html。
导入跨域资源需要启用 CORS。
来自相同 URL 的导入仅获取和解析一次。这表示导入中的脚本只在第一次导入的时候执行。 导入中的脚本按顺序执行,它们不会阻塞主页面解析。 导入链接不代表 "#把内容添加到这里"。它代表 "解析器,去把这个文档取过来,我一会要用"。脚本在导入期间运行,而样式,标记,还有其他资源需要明确的加入到主页面中。这是 HTML 导入和<iframe>
之间的最大区别,后者表示 "在这里加载并渲染资源"。 总结 HTML 导入允许将 HTML/CSS/JS 打包成一个单独资源。这个想法在 Web 组件开发世界中显得极为重要。开发者可以创建重用的组件,其他人通过引入 <link rel="import">
就能够在自己的应用中使用这些组件。 HTML 导入是个简单的概念,但却促成了许多有趣的使用案例。
使用案例
将相关的HTML/CSS/JS 作为一个单独的包 来分发。理论上来说,你可以在应用里面导入一个完整的 web 应用。 代码组织 - 将概念按照逻辑划分为不同的文件,鼓励模块化 & 复用性**。 传输 一或多个自定义元素 的定义。可以在应用内使用导入来注册 和包含自定义元素。这符合良好的软件模式,即将接口/定义与使用分离。 管理依赖 - 自动解决资源的重复加载。 脚本块 - 没有导入之前,一个大型的 JS 库需要在使用前全部解析,这通常很慢。有了导入,只要块 A 解析完毕,库就能够立即使用。延迟更少了!
<link rel="import" href="chunks.html">:
<script>/* script chunk A goes here */</script>
<script>/* script chunk B goes here */</script>
<script>/* script chunk C goes here */</script>
... 并行 HTML 解析 - 这是首次能够让浏览器并行运行两个 (或多个) HTML 解析器。
允许在调试和非调试模式下切换,只需要修改导入的目标。你的应用无需知道导入的目标是打包/编译好的资源还是一棵导入树。
HTML Imports的更多相关文章
- ASP.NET Core project.json imports 是什么意思?
示例代码: "frameworks": { "netcoreapp1.0.0": { "imports" : "portable- ...
- imports,using,和include之间的区别
Imports, Using基本一样,有两个作用 1.将后面命名空间中所有的名字导入到当前命名空间 2.为后面的名字取一个当前命名空间可以访问的别名. 比如StreamWriter这个类在System ...
- MEF初体验之四:Imports声明
组合部件使用[System.ComponentModel.Composition.ImportAttribute]特性声明导入.与导出类似,也有几种成员支持,即为字段.属性和构造器参数.同样,我们也来 ...
- 【Scala】Scala之Packaging and Imports
一.前言 前面介绍了Scala的Object,由于中间论文的时间耽误了些时间,接着继续学习Scala的Packaging和Imports 二.Packaging and Imports Scala的包 ...
- Project file is incomplete. Expected imports are missing 错误解决方案
当你打开一个.net core的项目,Visual Studio 可能无法打开,提示如下错误: D:\workshop\Github\Ocelot\src\Ocelot\Ocelot.csproj : ...
- Intellij IDEA Organize Imports
使用Eclipse进行开发时,我喜欢用Ctrl + Shift + O快捷键管理Java类的导入,它可以导入所需的Java类,去除不需要的Java类. Eclipse的Organize Imports ...
- Sqoop--Free-form Query Imports 自由查询模式下$CONDITIONS关键字的作用
Scoop是用来实现HDFS文件系统和关系型数据库如MySQL之间数据传输和转换的工具. 从MySQL导出到HDFS可以通过--table, --columns and --where等设置数据抽出的 ...
- golang 版本升降之后报错——imports runtime: C source files not allowed when not using cgo or SWIG
问题: golang 升级或者降级版本之后,执行编译报错如下: package github.com/onsi/ginkgo/ginkgo imports runtime: C source file ...
- HTML Imports & polyfill
组件化浏览器的兼容性问题汇总 框架依赖的 Web 标准技术 优先级高 HTML Imports HTML tempaltes ES6 to ES5 (搭建模块开发环境) polyfill https: ...
随机推荐
- 详解Android动画之Tween Animation
前面讲了动画中的Frame动画,今天就来详细讲解一下Tween动画的使用. 同样,在开始实例演示之前,先引用官方文档中的一段话: Tween动画是操作某个控件让其展现出旋转.渐变.移动.缩放的这么一种 ...
- 关于tomcat的思考
下载文件两种方式:绿色版的.安装版的(找到jre的环境变量.配置或修改端口8080→8070) 启动完tomcat之后: 既可以虚拟目录打开(如http://localhost:8070/mldn/) ...
- SDWebImage 原理及使用
这个类库提供一个UIImageView类别以支持加载来自网络的远程图片.具有缓存管理.异步下载.同一个URL下载次数控制和优化等特征. SDWebImage 加载图片的流程 入口 setImageWi ...
- RedHat7搭建Nginx+Apache+PHP
Nginx做为前端服务器(本机IP:192.168.136.104),将访问PHP页面的动态请求转发给Apache服务器(只监听本地回环地址172.0.0.1:80) 安装Apache# yum -y ...
- HTML5 Canvas 2D绘图
为了防止无良网站的爬虫抓取文章,特此标识,转载请注明文章出处.LaplaceDemon/ShiJiaqi. http://www.cnblogs.com/shijiaqi1066/p/4851774. ...
- asp.net 使用IHttpModule 做权限检查 登录超时检查(转)
IHttpModule 权限 检查 登录超时检查 这样就不需要每个页面都做一次检查 也不需要继承任何父类. using System;using System.Collections.Generic; ...
- Weex命令
1.下载安装 $ git clone https://github.com/alibaba/weex.git //通过brew安装node $ brew install node //通过node安装 ...
- window 安装 Protobuf
环境安装 1:下载CMake 2:打开VS Command Prompt 3:修改工作目录到目标目录 cd C:\Path\to 4:创建编译完后 protobuf headers/libraries ...
- [Cookie] C#CookieHelper--C#操作Cookie的帮助类 (转载)
点击下载 CookieHelper.rar 下面是代码大家看一下 /// <summary> /// 类说明:CookieHelper /// 联系方式:361983679 /// 更新网 ...
- Maven3(笔记二)
笔记本二 在Eclipse 中使用Maven 第一节:m2eclipse 插件安装 打开Eclipse,点击菜单Help - > Install New Software 点击Add 按钮N ...