HTML Imports 中文规范

关于本文档

所有图表，示例，备注，以及明确标记为非规范的部分都是非规范的。其他内容都是规范的。

在本文档的规范部分中的关键字 "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", 和 "OPTIONAL" 在 RFC2119 的描述中有解释。为了方便阅读，这些词语不会以全部大写字母出现在本规范。

任何时刻，一个符合UA必须对状态或概念模型状态的反应做决定。这被称为算法。这些算法根据等价处理定义。等价处理是强加给算法实现者的约束。对于相同的输入，要求UA实现和指定算法的输出必须保持完全一致。

依赖

本文档依赖以下规范：

术语

HTML导入, 或此后的导入，是指在 HTML 文档中作为外部资源链接的 HTML 文档。链接到一个导入的文档称为导入来源。对任何给定的导入，一个导入来源祖先是它的导入来源或它的导入来源的任意导入来源祖先。

一个有它自己的浏览上下文的导入来源被称为主文档。每个导入被关联到一个主文档：如果导入的来源是一个主文档，那么此来源是这个导入的主文档。否则，导入来源的主文档是导入的主文档。

导入文档与主文档共享它的 defaultView。 (参见 Bug 23170.)

一个导入的 URL 称为导入地址。

在导入来源中，一个导入表示一个 Document，称为导入文档。导入文档没有浏览上下文。

主文档关联的所有导入形成一个主文档的导入映射。此映射以导入地址作为键保存导入。导入映射一开始是空的。新的项根据导入获取算法被添加到此映射中。

链接类型 "`import`"

为了能在HTML中声明导入，HTML链接类型增加了一个新的链接类型：

import 关键字可以用于 link 元素。此关键字创建一个导入的外部资源链接。

import 关键字给资源指定的默认类型是 text/html。

link 元素有一个 async 属性。async 属性是一个布尔属性。

获取资源的适当时间是，当外部资源链接被创建或它的元素被插入到文档中。

不论 link 的 media 导入始终会被获取和应用。

下面文档有一个导入，位于 /imports/heart.html:


<!DOCTYPE html>
<html lang="en-US">
    <head>
        <title>Human Being</title>
        <link rel="import" href="/imports/heart.html">
    </head>
    <body>
        <p>What is a body without a heart?</p>
    </body>
</html>

`HTMLLinkElement` 接口扩展


partial interface HTMLLinkElement {
    readonly attribute Document? import;
};

import 属性必需返回 null，如果：

link 不表示一个导入
link 元素不在 Document 中

否则，此属性必需返回导入的导入文档，由 link 元素呈现。

每次必需返回相同的对象。

这是如何访问前面例子中提到的导入文档：


var link = document.querySelector('link[rel=import]');
var heart = link.import;
// Access DOM of the document in /imports/heart.html
var pulse = heart.querySelector('div.pulse');

在 HTML parser 或 XML Parser 的 Document 上下文中的导入被称为阻塞脚本的导入。如果此元素是 Document 的解析器创建的，或者这个元素是一个 import 类型的 link，而且此 link 没有被标记为异步，而且此导入已经完全下载，且事件循环的最后时间已经到达步骤1，而且元素在 Document 中，而且用户代理尚未放弃此导入。用户代理可以随时放弃一个导入。

放弃一个未下载或仍在下载中的导入，即脚本可以结束操作错误的信息。比如，如果一个导入注册了一个自定义元素，而某个脚本依赖此元素，如果用户代理放弃，这个脚本会发现此元素不可用。实现者必须平衡脚本使用错误信息时，什么都不做只是等待完成一个很慢的网络请求，导致影响性能的可能性。

如果在 文档 的导入依赖中存在阻塞脚本的导入，那么此 文档 有可阻塞脚本的导入。否则此文档没有阻塞脚本的导入。

每当一个导入完成下载或一个新的导入开始下载，状态 "有阻塞脚本的导入" 都会改变。在这些时刻，HTML解析器会解除阻塞。

`Document` 接口扩展

补充 `document.open() 方法`

增加如下步骤为定义的第一步：

如果 Document 是一个导入，抛出 InvalidStateError 异常。

补充 `document.write()` 方法

增加如下步骤为定义的第一步：

如果 Document 是一个导入，抛出 InvalidStateError 异常。

补充 `document.close()` 方法

增加如下步骤为定义的第一步：

如果 Document 是一个导入，抛出 InvalidStateError 异常。

加载 Imports

导入依赖

每个文档都有一个导入链接表，其项都由链接构成，包括 link 元素，URL地址。而且，项可以标记为分支。此表开始为空，通过导入请求算法添加项。

一个导入文档有0个或多个导入祖先。导入祖先是一个文档。如果文档 A 的导入链接列表包含一个地址指向文档 B 的分支项，那么 A 是 B 的一个导入祖先。B 也称为 Document 的导入父亲。导入祖先是可传递的：如果文档 C 是文档 B 的一个导入祖先，而文档 B 是文档 A 的一个导入祖先，那么 C 是文档 A 的一个导入祖先。

一个导入文档也有0个或多个导入前置。一个导入前置是一个文档。如果在文档 B 的导入父亲的导入链接地址里，文档 A 的URL地址位于文档 B 的URL地址之前，且定位链接被标记为分支，那么 A 是 B 的导入前置。

文档 A 的导入祖先前置定义如下：如果文档 B 是文档 C 的一个导入前置，而 C 是文档 A 的一个导入祖先，那么 B 是 A 的一个导入祖先前置。

如果一个 Document 是文档 A 的导入祖先前置或导入前置，或者是链接到 A 的导入链接表的分支项，那么它是 A 的导入依赖。

导入链接表和导入依赖限制导入中的脚本执行顺序。每个导入中的 link 元素的顺序决定了脚本执行顺序。导入前置的选择要知道这个顺序。

导入链接表的链接结构形成一个有向图。每个节点是一个文档，它的边缘是一个链接。分支形成一个延伸树。这个树给出了脚本执行的准确顺序。

在图中，

文档 A 有一个导入链接表，包含一个链接到 B 和一个链接到 C。
文档 D 有两个导入祖先 A 和 B。
B 是 D 的一个导入祖先，D 的指向 B 的链接项没有被标记为分支。
尽管文档 D 被文档 B 和 C 链接，但它的导入父亲是 B，因为 B 有一个标记为分支的链接到 D。
看 E：
- E 没有任何导入前置。因为从 C 到 D 的链接没有被标记为分支，而到 G 的链接不在到 E 的链接之前。
- E 的导入祖先是 A 和 C。
- E 的导入祖先前置是 B。因为 C 的导入前置是 B 而 A 没有导入前置。
- E 的导入链接表包含标记为分支的 H。
- 因此 E 的导入依赖是一个导入祖先前置 B，和一个导入链接表中的项 H。
看 G：
- G 的导入前置是 E。
- G 的导入祖先前置跟 E 一样，是 B。
- G 的导入链接表是空的。
- 因此 G 的导入依赖是一个导入祖先前置 B，和一个导入前置 E。

导入来源和导入父亲的区别是导入来源体现了节点树的状态，而导入父亲则是由此文档中的算法创造的。

更新分支

在一个链接被添加到导入链接表后，更新标记算法必需被主文档执行。等价于执行如下步骤：

输入: DOCUMENT，文档对象

如果 DOCUMENT 是主文档，取消 DOCUMENT 的导入链接表中所有链接的分支标记，所有导入都被关联到 DOCUMENT。
定义 LIST 等于 DOCUMENT 的导入链接表。
对于 LIST 中的每个 ITEM：
1. 定义 LOCATION 等于 ITEM 的地址。
2. 定义 IMPORT 为一个 URL 等于 LOCATION 的导入。
3. 如果没有其他的链接的地址与 LOCATION 相同且被标记为分支，则标记 ITEM 为一个分支。
4. 如果 ITEM 被标记为分支且 IMPORT 不等于 null，调用 IMPORT 的更新标记算法。

请求导入

当用户代理尝试获取一个链接导入, 它必需运行导入请求算法, 等价于运行如下步骤：

输入: LINK，建立到导入的外部资源链接的 link 元素。; LOCATION，链接资源的 URL 。

如果 LINK 的 async 属性为 true, 则标记 LINK 为异步。
定义 DOCUMENT 为 LINK 的一个文档。
定义 LIST 为 DOCUMENT 的导入链接表。
定义 ITEM 为 LINK 和 LOCATION：
1. 添加 ITEM 到 LIST 的末尾。
2. 调用主文档的更新标记算法。

获取导入

所有链接到主文档或在导入映射中的导入，必需使用如下描述的导入获取算法，代替HTML规范指定的获取链接资源算法。

导入获取算法必需等价于执行如下步骤：

输入: LINK，建立到导入的外部资源链接的 link 元素。; LOCATION，导入地址。
输出: IMPORT，导入文档。

如果 LOCATION 已在导入映射中：
1. 赋值 IMPORT 等于 LOCATION 对应的导入文档，然后停止。
从 LOCATION 获取资源，设置请求的源为主文档的源，模式为 CORS，证书模式为 same-origin。

如果获取的响应类型是错误：
- 添加 LOCATION 和 null 到导入映射，然后停止。
赋值 IMPORT 为一个新的 Document对象，其文档地址等于 LOCATION 。
赋值 PARSER 为一个新的 HTML parser，与 IMPORT 相关。
添加 LOCATION 和 IMPORT 到导入映射。
当每个任务队列里的网络任务源任务获取资源时：
1. 用获取的字节数据填充 PARSER 的输入字节流。
2. 使用 utf-8（一种已知确定的编码），处理 PARSER 的输入字节流。
当已没有有效字节数据：
1. 从 PARSER 的网络任务源产生一个队列任务，处理隐含的 EOF 字符。

所有已经加载和正在加载的导入都在导入链接表中，因此，所有链接到此表中的导入的导入也会使用导入获取算法被下载，其 LOCATION 是导入的导入地址。

当此算法完成，如果 IMPORT 不为null，则必需认为下载是成功的，否则为失败。

每个没有被标记为异步的导入会延迟文档的加载事件。

link 元素成功下载后，会发送一个简单的 load 事件。下载失败则发送一个简单的 error 事件。

因为导入会延迟加载事件，Document 不会完全下载，直到它链接的所有导入都下载完成。

导入和内容安全策略

内容安全策略必需通过 script-src 指令限制导入的加载。

每个导入必需被主文档的内容安全策略限制。例如，如果发送内容安全头字段到一个导入，用户代理必需应用主文档的策略到导入文档。

解析导入

导入的解析行为被定义为 HTML解析的一组改变。

补充：准备一个脚本算法

在准备一个脚本算法的第15步，修改条件“如果元素没有 src 属性”的最后部分为：

... 且 HTML parser 或 XML parser 的创建了 script 元素的 Document，有阻塞脚本的样式或有阻塞脚本的导入

补充：树构建算法

在 DOCTYPE 的章节部分 12.2.5.4.1 初始插入模式，修改如果文档不是一个 iframe srcdoc 文档 ... 为如下：

如果文档不是一个 iframe srcdoc 文档，也不是一个导入 ...

在文本插入模式的条件 Otherwise 的子条件“一个script结束标记”，修改步骤3为：

如果解析器的 Document 有阻塞脚本的样式或有阻塞脚本的导入或脚本的 "准备被解析器执行" 标记没有设置，翻阅事件循环，直到解析器的 Document 没有阻塞脚本样式和没有阻塞脚本导入且脚本的 "准备被解析器执行" 标记被设置。

补充：解析XHTML文档

修改运行准备 script 元素的第3步如下：

翻阅事件循环，直至解析器的 Document 没有阻塞脚本的样式和没有阻塞脚本的导入且等待解析块脚本的 "准备被解析器执行" 标记被设置。

在导入中编写脚本

补充：脚本启用标准

增加下述条件到开启和关闭脚本标准列表：

启用节点的脚本，如果节点的 Document 对象在导入映射中。

补充：document.currentScript

修改 document.currentScript 的定义为：

currentScript 属性，必需返回文档或文档的导入映射中最近初始化的脚本。当文档创建后，currentScript 属性必需初始化为 null。如果文档为导入文档，那么它的 currentScript 始终为 null。

导入的样式处理

导入的 style 元素和外部资源 link 元素的内容必需被当做主文档的样式处理模型的输入源。

不同文档之间的文档顺序中的出现顺序被定义为，比较两个元素，x，其所在文档是 Dx，和 y，其所在文档是 Dy，如下：

如果有一个文档 Da，它是 Dx 和 Dy 的公共导入来源祖先，Lx 是 Da 中第一个链接到 Dx 或 Dx 的导入来源祖先的导入 link 元素，Ly 是一个单独导入 Dy 的 link 元素。使用文档顺序比较两者，如果 Lx 在前，则元素 x 在前，否则 y 在前。
如果 Dx 是 Dy 的一个导入来源祖先，Ly 是 Dx 中第一个链接到 Dy 或 Dy 的导入来源祖先的导入 link 元素。比较 x 的文档顺序和 Ly，如果 x 在 Ly 前面，那么 x 也在 y 的前面。
如果 Dy 是 Dx 的一个导入来源祖先，则比较 y 的文档顺序和 Lx。

这是一个导入树的文档顺序演示图。

在这个示例中，主文档有2个导入 B 的导入来源祖先的 link 元素。当比较 b1 和 m2，b1 在 m2 前面，因为在主文档中，用于比较的第一个 link 出现在 m2 的前面。

一个导入树中不同文档样式的文档顺序示例。

这个比较使用导入来源祖先概念来代替导入祖先。这意味着移动导入 link 改变DOM结构会影响这个顺序。它遵循样式表的 style 元素和 link 元素的工作方式。

参见 Bug 24756.

导入中的事件

导入中的事件被定义为一组 HTML事件改变。

附加：事件处理器

修改事件处理器内容属性的脚本创建标准，扩展第一段：

当设置一个事件处理器内容属性时，如果这个元素属于一个在浏览上下文或导入映射中的文档，...

鸣谢

David Hyatt 开发了 XBL 1.0，Ian Hickson 参与了 XBL 2.0 的编写。这些文献在行为依附问题上提供了巨大而深刻的见解，并极大地影响了本说明书。

Alex Russell 和他的重要远见引发了新一波围绕行为依附课题的热潮和如何在网络上应用于实践。

Dominic Cooney 和 Roland Steiner 不知疲倦的仔细研究网络平台范围内的问题，为此文档打下了坚实的基础。

编辑还要感谢 Alex Komoroske，Angelina Fabbro，Anne van Kesteren，Boris Zbarsky，Brian Kardell，Daniel Buchner，Edward O'Connor，Eric Bidelman，Erik Arvidsson，Elliott Sprehn，Gabor Krizsanits，Hayato Ito，James Simonsen，Jonas Sicking，Ken Shirriff，Neel Goyal，Olli Pettay，Rafael Weinstein，Scott Miles，Steve Orvell，Tab Atkins，William Chan，和 William Chen，感谢他们对此说明书的评论和贡献。

这个列表太短了。还有很多工作要做。请通过评审和提交bugs来参与贡献 — 不要忘了要求编辑添加你的名字到此章节。

HTML Imports 中文规范

W3C 编辑草案

摘要

文档状态

目录

关于本文档

依赖

术语

链接类型 "`import`"

`HTMLLinkElement` 接口扩展

`Document` 接口扩展

补充 `document.open() 方法`

补充 `document.write()` 方法

补充 `document.close()` 方法

加载 Imports

导入依赖

更新分支

请求导入

获取导入

导入和内容安全策略

解析导入

补充：准备一个脚本算法

补充：树构建算法

补充：解析XHTML文档

在导入中编写脚本

补充：脚本启用标准

补充：document.currentScript

导入的样式处理

导入中的事件

附加：事件处理器

鸣谢

HTML Imports 中文规范

W3C 编辑草案

摘要

文档状态

目录

关于本文档

依赖

术语

链接类型 "import"

HTMLLinkElement 接口扩展

Document 接口扩展

补充 document.open() 方法

补充 document.write() 方法

补充 document.close() 方法

加载 Imports

导入依赖

更新分支

请求导入

获取导入

导入和内容安全策略

解析导入

补充：准备一个脚本算法

补充：树构建算法

补充：解析XHTML文档

在导入中编写脚本

补充：脚本启用标准

补充：document.currentScript

导入的样式处理

导入中的事件

附加：事件处理器

鸣谢

链接类型 "`import`"

`HTMLLinkElement` 接口扩展

`Document` 接口扩展

补充 `document.open() 方法`

补充 `document.write()` 方法

补充 `document.close()` 方法