HTML5/impl

（暂放） 原文链接 http://www.w3.org/TR/2011/WD-html5-20110525/

本文档开放给所有人编辑，希望参与贡献请移步下面地址注册： http://www.w3.org/Help/Account/Request/Public

介紹

背景

此章節不具有規範性

對象

此章節不具有規範性

範圍

此章節不具有規範性

沿革

此章節不具有規範性

設計備註

此章節不具有規範性

腳本執行的可序列性

此章節不具有規範性

遵守其他規範

此章節不具有規範性

HTML vs XHTML

此章節不具有規範性

這份規範的結構

此章節不具有規範性

如何閱讀本規範

排版慣例

HTML 的簡短介紹

此章節不具有規範性

對於作者的符合要求

此章節不具有規範性

表象標記

此章節不具有規範性

語法錯誤

此章節不具有規範性

內容模型與屬性值的限制

此章節不具有規範性

建議閱讀

此章節不具有規範性

通用设施

术语

本规范会涉及到HTML/XML attributes和IDL attributes。为避免混淆，我们用content attributes来描述HTML/XML attributes，用IDL attributes来描述IDL接口中的属性。类似的，properties可以用来描述JavaScript对象或CSS的properties。为区分这两种properties,我们分别用object properties和CSS properties来描述上两种不同的properties.

一般来说，如果一个feature既适用于HTML语法，也适用于XHTML语法，则会说该feature适用于HTML或者XHTML。如果某feature只适用于其中的一种语言，则会明确指出该feature不适用于另一种语法，比如：在HTML里......(注意不适用于XHTML)

本规范的document可以是任何HTML格式的文件,包括简短的静态文档，较大的带有多媒体数据的文档，还有复杂的交互应用。

当提到一个文档被呈现给用户的方式时，规范中会用到shown, displayed或者visible.

如果说从算法B返回到算法A。这说明A调用了B。当回到A时，程序将会继续执行调用B的语句的下一条语句。

“透明的黑色”表示R,G,B和alpha通道都被设成了0.

资源

XML

DOM树

脚本

插件

字符编码

規範要求

本規範的所有圖表、範例、備註皆沒有規範性，直接標示無規範性的章節也是如此。本規範其餘的部份具有規範性。

在具有規範性的部份裡，關鍵詞「必須（MUST）」、「必不可（MUST NOT）」、「本規範要求…（REQUIRED）」、「應該（SHOULD）」、「不應（SHOULD NOT）」、「本規範建議…（RECOMMENDED）」、「可（MAY）」、「可以選擇（OPTIONAL）」 按照 RFC2119 的敘述解讀。為方便閱讀，本規範翻譯使用中文的這些關鍵詞。[RFC2119]

作為演算法一部分指令的要求（例如：「剝離所有前頭空白字符」、「回傳假值並退出這些步驟」）以呼叫演算法所用關鍵字（「必須」、「應該」、「可」等等）的意義解讀。

以演算法或是具體步驟呈現的要求可以任何方式實作，唯一的要求是是結果相等。（特別是本規範定義的演算法以容易理解而不以性能高為目的。）

規範類別

本章節不具有實作相關內容

依賴關係

本規範建構在其他規範規範之上。

XML

因為 XHTML 語法使用帶有名稱空間的 XML 序列化，支援 XHTML 語法的實作必須支援某個版本的 XML 與相應的名稱空間規範。[XML] [XMLNS]

DOM

文件物件模型（Document Object Model，DOM）是文件與其內容的一個描述方式也是一個模型。DOM 不只是一套 API — 本規範以在 DOM 上的操作定義規範符合條件。[DOMCORE]

因為本規範著重以 DOM 描述規則並定義部份功能為 DOM Core 各界面的擴充，實作必須支援某個版本的 DOM Core 與 DOM Events。[DOMCORE] [DOMEVENTS]

其中，DOM Core 規範定義了以下功能：[DOMCORE]

• Attr 界面
• CDATASection 界面
• Comment 界面
• DOMImplementation 界面
• Document 界面
• DocumentFragment 界面
• DocumentType 界面
• DOMException 界面
• Element 界面
• Node 界面
• NodeList 界面
• ProcessingInstruction 界面
• Text 界面
• createDocument() 方法
• createElement() 方法
• createElementNS() 方法
• getElementById() 方法
• insertBefore() 方法
• ownerDocument 屬性
• childNodes 屬性
• localName 屬性
• parentNode 屬性
• namespaceURI 屬性
• tagName 屬性
• textContent 屬性

DOM Events 規範定義了以下功能：[DOMEVENTS]

• Event 界面
• EventTarget 界面
• UIEvent 界面
• MouseEvent 界面
• click 事件
• target 屬性

File API

本規範使用以下 File API 規範定義的界面：[FILEAPI]

• Blob
• File
• FileList

Web IDL

使用者代理必須將本規範裡的所有 IDL 片段解釋為 Web IDL 所說的必要符合 IDL 片段。[WEBIDL]

本規範使用 WebIDL 規範定義的給予屬性索引與給予屬性名這兩個詞彙。

除非另外說明，若腳本賦予型態為浮點數（double）的 IDL 屬性 Infinity 或 Not-a-Number（NaN），則使用者代理必須丟出 NOT_SUPPORTED_ERR 例外。

除非另外說明，若腳本以 Infinity 或 Not-a-Number（NaN）作為型態是浮點數（double）的方法參數，則使用者代理必須丟出 NOT_SUPPORTED_ERR 例外。

除非另外說明，若腳本對型態為 DOMString 的 IDL 屬性賦值，或是呼叫的方法有型態為 DOMString 的參數，則使用者代理必須將該 DOMString 轉換成 Unicode 字符串列以提供本規範裡的演算法使用。[WEBIDL]

JavaScript

本規範描述的語言的一部分僅支援 JavaScript 為腳本語言。[ECMA262]

媒體查詢（Media Queries）

實作必須支援媒體查詢（Media Queries）語言的某個版本。[MQ]

URI、IRI、IDNA

實作必須支援 URI 與 IRI 規範定義的 URL 語意，並支援《Internationalizing Domain Names in Applications (IDNA)》規範定義的 IDNA 域名語意。[RFC3986] [RFC3987] [RFC3490]

CSS 模組

雖然本規範不要求實作支援 CSS 全部功能（但是本規範鼓勵瀏覽器這樣做），有些功能以特定的 CSS 要求定義。

具體來說，有些功能要求將字串作為 CSS <color> 取值解析。CSS 規範要求使用者代理在解析 CSS 取值的時候使用某些錯誤處理規則，而這些規則也適用於本規範。[CSSCOLOR] [CSS]

本規範不「要求」使用者代理支援特定的網路協定、樣式表語言、腳本語言或是任何上述以外的 DOM 規範。但是，本規範描述的語言傾向使用 CSS 作為樣式表語言、JavaScript 作為腳本語言、HTTP 作為網路協定，並在幾個功能的描述上假設使用者代理使用這些語言與協定。

擴展性

字串比較與大小寫

以區分大小寫的方式比較兩個字串是指一個代碼點一個代碼點準確比較。

以 ASCII 不分大小寫的方式比較兩個字串是指除了將在範圍 U+0041 到 U+005A（也就是 LATIN CAPITAL LETTER A 到 LATIN CAPITAL LETTER Z）之間的字符與在範圍 U+0061 到 U+007A（也就是 LATIN SMALL LETTER A 到 LATIN SMALL LETTER Z）之間的對應字符視為一樣之外，一個代碼點一個代碼點準確比較。

UTF-8

当用户代理需要‘包含错误处理地，以UTF-8解码一个字节的字符串’，它意味着除非出现任何错误，字节流必须通过将其解释为UTF-8从而转化为一个Unicode字符串。出现的错误必须被描述为下列列表中的形式。下面的列表中的字节被表示为十六进制。[RFC3629]

• 一个FE至FF范围内的字节
• 超长形式（例如：F0 80 80 A0）
• 一个C0至C1范围内的字节，其后跟随一个80至BF范围内的字节。
• 一个F0至F4范围内的字节，其后跟随三个80至BF范围内的字节，这三个字节表示一个高于U+10FFFF的码点。
• 一个F5至F7范围内的字节，其后跟随三个80至BF范围内的字节。
• 一个F8至FB范围内的字节，其后跟随四个80至BF范围内的字节。
• 一个FC至FD范围内的字节，其后跟随五个80至BF范围内的字节。
• 一个C0至FD范围内的字节，其后不跟随80至BF范围内的字节。
• 一个E0至FD范围内的字节，其后跟随一个80至BF范围内的字节，该字节后不跟随80至BF范围内的字节。
• 一个F0至FD范围内的字节，其后跟随两个80至BF范围内的字节，最后一个字节后不跟随80至BF范围内的字节。
• 一个F8至FD范围内的字节，其后跟随三个80至BF范围内的字节，最后一个字节后不跟随80至BF范围内的字节。
• 一个FC至FD范围内的字节，其后跟随四个80至BF范围内的字节，最后一个字节后不跟随80至BF范围内的字节。
• 表示U+D800至U+DFFF范围内码点的任意字节序列
  整个匹配的序列必须使用单一的U+FFFD替换字符替换。
• 一个80至BF范围内的字符，其不跟随在一个80至FD范围内的字节之后。
• 一个80至BF范围内的字符，其跟随在一个作为完整UTF-8序列一部分的字节之后，该UTF-8序列不包括该字节。
• 一个80至BF范围内的字符，其跟随在一个作为已经使用U+FFFD替换字符替换过的序列一部分的字节之后，其既不是独立的也不是序列的一部分。
  每个这样的字节必须被使用U+FFFD替换字符替换。

对于上述需要的目的，一个UTF-8的超长形式指的是，使用超过以UTF-8形式编码一个码点所需的最少数量的字节编码该码点所得的一个序列。

通用微語法

HTML 在很多地方使用不同的資料型態，如日期或數值。此章節描述用這些格式的內容符合規範的條件與解析他們的方法。

常用解析器慣用語

在本規範裡，空白字符指的是 U+0020 SPACE、U+0009 CHARACTER TABULATION (tab)、U+000A LINE FEED (LF)、U+000C FORM FEED (FF) 與 U+000D CARRIAGE RETURN (CR)。

White_Space 字符是指 Unicode PropList.txt 資料檔裡有 Unicode "White_Space" 屬性的那些字符。[UNICODE]

ASCII 字母數字字符是指範圍 U+0030 DIGIT ZERO (0) 至 U+0039 DIGIT NINE (9)、U+0041 LATIN CAPITAL LETTER A 至 U+005A LATIN CAPITAL LETTER Z、U+0061 LATIN SMALL LETTER A to U+007A LATIN SMALL LETTER Z 的字符。

部份下述的微解析器按照以下的模式：有一個輸入變數放正在解析的字串，另一個位置變數指向輸入裡要解析的下一個字符。

對於按照這個模式的解析器，要求使用者代理蒐集一串字符意會著使用者代理必須執行以下演算法，其中字符集是要蒐集的字符集合。

1. 設輸入與位置為呼叫此演算法的相同名稱的變數。
2. 設結果為空字串。
3. 當位置沒超過輸入的結尾且位於位置的字符在字符集裡，將該字符附上結果的結尾並將位置向前移到輸入裡的下一個字符。
4. 回傳結果。

跳過空白步驟代表使用者代理必須蒐集一串空白字符。跳過 White_Space 字符步驟代表使用者代理必須蒐集一串White_Space 字符。在這兩種情況下，不使用蒐集到的字符。[UNICODE]

當使用者代理要剝離換行符時，使用者代理必須移除該字串中任何的 U+000A LINE FEED (LF) 與 U+000D CARRIAGE RETURN (CR)。

當使用者代理要剝離頭尾空白時，使用者代理必須移除該字串起頭與結尾的空白字符。

一個字串的代碼點長度是該字串有的 Unicode 代碼點的個數。

布尔型属性

关键字和枚举类型属性

数字

非负整数

带符号整数

实数

百分比和长度

整数列表

尺寸列表

日期和时间

月份

日期

时间

本地日期和时间

全球日期和时间

星期

Vaguer moments in time

颜色

空格分开的token

一组空格分开的token是一个包含零个或者多个由一个或者多个空白字符分隔的词（称为token）的字符串，每个词由一个或者多个字符组成，这些字符都不能是空白字符。

逗号分开的token

参考

媒体查询

URL

术语

一个URL是一个用于标识资源的字符串。

一个URL是一个有效的URL当且仅当以下条件中至少一个成立：

• URL是一个有效的URI引用 [RFC3986]
• URL是一个有效的IRI引用并且它没有查询组件。[RFC3987]
• URL是一个有效的IRI引用并且它的查询组件不包含未编码的非ASCII字符。[RFC3987]
• URL是一个有效的IRI引用并且URL的文档的字符编码是UTF-8或者UTF-16。[RFC3987]

一个字符串是有效非空的URL当且仅当它是一个有效的URL但它不是一个空字符串。

一个字符串是一个有效的URL（允许前后有空格）当且仅当它去掉前后空白字符之后，是一个有效的URL。

一个字符串是一个有效非空的URL（允许前后有空格）当且仅当它去掉前后空白字符之后，是一个有效非空的URL。

本规范定义了URL about:legacy-compat为保留的,尽管不可解析,about: URI,当兼容XML工具需要时，可用于在HTML文档的DOCTYPE中。 [RFC3987]

本规范定义了URL about:srcdoc为保留的,尽管不可解析，about: URI，用于iframe srcdoc文档的document的地址。[RFC3987]

分析URL

Resolving URLs

URL运用与创建

动态改变基础URL

URL运用的接口

获取资源

协议的概念

加密的HTTP及安全考量

決定資源的類型

使用者代理獲得、解讀 Content-Type 後設資料的方式必須不與媒體型態嗅探規範的要求有所衝突。[MIMESNIFF]

使用者代理尋找資源的嗅探型態的方式必須不與媒體形態嗅探規範定義的尋找相關八位元組序列「嗅探型態」的要求有所衝突。[MIMESNIFF]

媒體形態嗅探規範也定義針對圖像嗅探的規則與區分資源是文字還是二進制檔案的規則。這兩個規則皆回傳 MIME 型態。[MIMESNIFF]

由 meta 元素萃取編碼

給定一個字串 s，以下是由 meta 元素萃取編碼的演算法。本演算法回傳一個編碼或是空值。

1. 設位置為指向 s 的指針，一開始指向字串的起點。
2. 「迴圈」：找 s 裡位置之後第一組 ASCII 不分大小寫批配 "charset" 的七個字符
   Error creating thumbnail: Unable to save thumbnail to destination
   。若批配不存在，回傳空值並退出這些步驟。
3. 跳過接著 "charset" 的所有 U+0009, U+000A, U+000C, U+000D 或 U+0020 字符（這些字符不一定存在）
   Error creating thumbnail: Unable to save thumbnail to destination
   。
4. 若下一個字符不是 U+003D EQUALS SIGN（'='），則將位置為指向該字符的正前面並跳回「迴圈」步驟
   Error creating thumbnail: Unable to save thumbnail to destination
   。
5. 跳過接著等號的所有 U+0009, U+000A, U+000C, U+000D 或 U+0020 字符（這些字符不一定存在）
   Error creating thumbnail: Unable to save thumbnail to destination
   。
6. 用下述方式處理下一個字符：

   ↪ 若字符為 U+0022 QUOTATION MARK（"）且 s 的後面還有一個 U+0022 QUOTATION MARK（"）

   ↪ 若字符為 U+0027 APOSTROPHE（'）且 s 的後面還有一個 U+0027 APOSTROPHE（'）

   回傳此字符跟下一個最近的相同字符之間字串的對應編碼。

   Error creating thumbnail: Unable to save thumbnail to destination

   ↪ 若字符為單一個 U+0022 QUOTATION MARK（"）

   ↪ 若字符為單一個 U+0027 APOSTROPHE（'）

   ↪ 下一個字符不存在

   回傳空值

   Error creating thumbnail: Unable to save thumbnail to destination

   ↪ 否則

   回傳此字符跟下一個 U+0009, U+000A, U+000C, U+000D, U+0020 或 U+003B 字符或 s 的結尾之間對應編碼。

通用DOM接口

在IDL属性中反射内容属性

集合

HTMLCollection

HTMLAllCollection

HTMLFormControlsCollection

HTMLOptionsCollection

DOMTokenList

DOMSettableTokenList

安全地传递结构体类型数据

DOMStringMap

DOM功能点字符串

异常

垃圾回收

命名空间

HTML文档的语义、结构及API

文档

在HTML用户代理中，每个XML和HTML文档都表现为一个Document对象。

文档的地址是一个在Document对象被创建是设置的绝对URL。文档的当前地址是一个可以在Document对象生命周期内被修改的绝对URL。举例说明，当用户导航到一个页面的片段标识时，或者使用一个新的URL调用pushState()方法时，文档的当前地址将被修改。在Document对象被创建时，文档的当前地址必须被设为文档的地址。

当通过createDocument()或createHTMLDocument() API创建一个Document对象时，文档的地址与脚本程序的文档的文档的地址相同。

当Document对象被创建时，除非它们被标记为HTML文档，否则将被假定为XML文档。一个文档是HTML文档还是XML文档将影响某些API的行为和一些选择器的大小写区分情况。

每个Document对象拥有一个原本未设置的重载覆盖标志。该标志在某些情况下通过document.open()和document.write()方法设置。若设置了该标志，Document对象同时还拥有一个重载覆盖缓冲区，该缓冲区是一个用作文档在被重载之后的源的Unicode字符串。

当用户代理执行一个覆盖的重载时，必须执行下列操作：

1. 设source为浏览器上下文的活动文档的重载覆盖缓冲区的值。
2. 通过启用更换（replacement enabled）导航浏览器上下文到源为source的资源。当导航算法为此目的而创建一个Document对象时，设置该Document对象的重载覆盖标志并设置它的重载覆盖缓冲区为source。

DOM中的文档

所有Document对象（对于实现本标准的用户代理而言）必须实现HTMLDocument接口，这可以通过绑定机制实现。（也就是说，文档是不是一个HTML文档，甚至是不是包含任何HTML元素都无所谓）对于用户代理支持的其他命名空间，Document对象必须实现对应的文档级别的接口。

[OverrideBuiltins]

  // 资源元数据管理属性
  [PutForwards=href] readonly attribute Location location;
  readonly attribute DOMString URL;
           attribute DOMString domain;
  readonly attribute DOMString referrer;
           attribute DOMString cookie;
  readonly attribute DOMString lastModified;
  readonly attribute DOMString compatMode;
           attribute DOMString charset;
  readonly attribute DOMString characterSet;
  readonly attribute DOMString defaultCharset;
  readonly attribute DOMString readyState;

  // DOM树访问接口
  getter any (in DOMString name);
           attribute DOMString title;
           attribute DOMString dir;
           attribute HTMLElement body;
  readonly attribute HTMLHeadElement head;
  readonly attribute HTMLCollection images;
  readonly attribute HTMLCollection embeds;
  readonly attribute HTMLCollection plugins;
  readonly attribute HTMLCollection links;
  readonly attribute HTMLCollection forms;
  readonly attribute HTMLCollection scripts;
  NodeList getElementsByName(in DOMString elementName);
  NodeList getElementsByClassName(in DOMString classNames);
  NodeList  getItems(in optional DOMString typeNames); // microdata 
  readonly attribute DOMElementMap cssElementMap;

  // 动态标签插入接口
           attribute DOMString innerHTML;
  HTMLDocument open(in optional DOMString type, in optional DOMString replace);
  WindowProxy open(in DOMString url, in DOMString name, in DOMString features, in optional boolean replace);
  void close();
  void write(in DOMString... text);
  void writeln(in DOMString... text);

  // 用户交互接口
  readonly attribute WindowProxy defaultView;
  readonly attribute Element activeElement;
  boolean hasFocus();
           attribute DOMString designMode;
  boolean execCommand(in DOMString commandId);
  boolean execCommand(in DOMString commandId, in boolean showUI);
  boolean execCommand(in DOMString commandId, in boolean showUI, in DOMString value);
  boolean queryCommandEnabled(in DOMString commandId);
  boolean queryCommandIndeterm(in DOMString commandId);
  boolean queryCommandState(in DOMString commandId);
  boolean queryCommandSupported(in DOMString commandId);
  DOMString queryCommandValue(in DOMString commandId);
  readonly attribute HTMLCollection commands;

  // 事件接口
           attribute function onabort;
           attribute function onblur;
           attribute function oncanplay;
           attribute function oncanplaythrough;
           attribute function onchange;
           attribute function onclick;
           attribute function oncontextmenu;
           attribute function oncuechange;
           attribute function ondblclick;
           attribute function ondrag;
           attribute function ondragend;
           attribute function ondragenter;
           attribute function ondragleave;
           attribute function ondragover;
           attribute function ondragstart;
           attribute function ondrop;
           attribute function ondurationchange;
           attribute function onemptied;
           attribute function onended;
           attribute function onerror;
           attribute function onfocus;
           attribute function oninpput;
           attribute function oninvalid;
           attribute function onkeydown;
           attribute function onkeypress;
           attribute function onkeyup;
           attribute function onload;
           attribute function onloadeddata;
           attribute function onloadedmetadata;
           attribute function onloadstart;
           attribute function onmousedown;
           attribute function onmousemove;
           attribute function onmouseout;
           attribute function onmouseover;
           attribute function onmouseup;
           attribute function onmousewheel;
           attribute function onpause;
           attribute function onplay;
           attribute function onplaying;
           attribute function onprogress;
           attribute function onratechange;
           attribute function onreadystatechange;
           attribute function onreset;
           attribute function onscroll;
           attribute function onseeked;
           attribute function onseeking;
           attribute function onselect;
           attribute function onshow;
           attribute function onstalled;
           attribute function onsubmit;
           attribute function onsuspend;
           attribute function ontimeupdate;
           attribute function onvolumechange;
           attribute function onwaiting;
};
Document implements HTMLDocument;

由于HTMLDocument接口定义了几个不同特性的方法和属性，它的成员将在不同的章节中分别介绍。

安全

当一个HTMLDocument对象被一个脚本访问，且这个脚本的有效脚本源和文档的有效脚本源不同时，用户代理必须抛出一个SECURITY_ERR异常。

资源元数据管理

URL屬性需要返回文档地址。

referrer属性需要返回任意<fragment>组件删除后导航操作开始时（将浏览器上下文导航到当前文档的页面）资源浏览器上下文的活动文档的当前地址，或者当没有这样的原始页面、用户代理被设置为在这种情况下不报告引用、以及导航是通过包含noreferrer关键字的超链接启动的情况下，返回空字符串。

cookie属性表示创建Document所用资源的cookie。

一个Document对象如果满足一下几条之一，则在对象是无CookieDocument对象：

• Document没有浏览器上下文。
• Document的地址没有使用基于服务器的命名机构。

当获取Cookie时，如果文档是一个无CookieDocument对象，则用于代理必须返回空字符串。否则，如果Document的源不是“协议/主机/端口”元组，用户代理必须抛出SECURITY_ERR异常。否则，用户代理必须首先“获得存储互斥”之后返回一个“non-HTTP”API的文档地址的用UTF-8解码且包含错误处理的Cookie字符串。[COOKIES]

当设置Cookie时，如果文档是一个无CookieDocument对象，则用户代理必须停止执行操作。否则，如果Document的源不是“协议/主机/端口”元组，用户代理必须抛出SECURITY_ERR异常。否则，用户代理必须首先“获得存储互斥”之后执行操作，将通过“non-HTTP”API收到的一个文档地址的设置Cookie字符串用UTF-8编码并构成一个新的值。[COOKIES] [RFC3629]

当获取lastModified属性时，必须返回Document源文件的最后修改的日期和时间，日期和时间为用户所在的时区，且遵循以下格式：

1. 日期的月份部分
2. 一个U+002F斜线号字符（/）
3. 日期的天数部分
4. 一个U+002F斜线号字符（/）
5. 日期的年份部分
6. 一个U+0020空格字符
7. 时间的小时部分
8. 一个U+003A冒号字符
9. 时间的分钟部分
10. 一个U+003A冒号字符
11. 时间的秒钟部分

以上所有的数字部分，除年份以外，都必须由两个U+0030数字零（0）至U+0039数字九（9）之间的十进制数字组成，如果必要使用零填充。年份必须由四位或四位以上尽可能短的U+0030数字零（0）到U+0039数字九（9）组成的十进制数字，如果必要使用零填充。

Document源文件的最近修改的日期和时间必须必须来源于网络所使用的协议的相关特征，例如：来源于文档的HTTP Last-Modified头的值，或者本地文件系统中的元数据（metadata）。如果最近修改的日期和时间不确定，这个属性必须返回遵循上述格式的当前的日期和时间。

Document被划分为三种模式：默认的“非怪癖模式”（no-quirks mode）、通常用于旧文档的“怪癖模式”（quirks mode）以及被认为“几乎标准”模式的“限制怪癖模式”（limited-quirks mode）。模式只能由HTML解释器基于文档类型声明（DOCTYPE）字符串是否存在以及它的值从默认模式修改。

如果文档没有被HTML解释器设置为怪癖模式，则compatModeIDL属性必须返回字符串“CSS1Compat”，否则应返回字符串“BackCompat”。

当获取charsetIDL属性时，必须返回文档的字符编码的首选MIME名称。当设置charsetIDL属性时，如果新值是浏览器支持的IANA注册的别名，则文档的字符编码必须被设置为这个字符编码。（否则不进行操作）

当获取characterSetIDL属性时，必须返回文档的字符编码的首选MIME名称。

当获取defaultCharsetIDL属性时，必须返回字符编码的首选MIME名称。该字符编码可能是用户的默认编码，也可能是关于用户当前地理位置的编码，或者任意的编码名称。

每个文档都有一个当前文档准备（current document readiness）。当一个Document对象被创建时，该文档必须拥有它的当前文档准备。如果该文档与HTML解释器或XML解释器相关，那么当前文档准备应设为字符串“loading”；否则设为字符串“complete”。页面加载过程中，各种算法将影响此值。当这个值被设置时，用户代理必须触发一个Document对象的名为readystatechange的简单事件。

如果一个Document与HTML解释器或XML解释器相关，且解释器尚未结束或终止，则称该Document拥有一个活动的解释器（active parser）。

当获取readyStateIDL属性时，必须当前文档准备。

DOM树存取器

如果存在一个文档的html元素，则它是文档的根元素。否则html元素为null。

如果存在一个文档的head元素，则它是html元素子元素中的的第一个head元素。否则head元素为null。

当获取head属性时，必须返回当前文档的head元素（一个head元素或null）。

如果存在一个文档的title元素，则它是文档中的第一个title元素（在树结构中），否则title元素为null。

当获取title属性时，运行下列算法：

1. 如果根元素是一个拥有“http://www.w3.org/2000/svg”命名空间的svg元素，且用户代理支持SVG，则返回SVGDocument接口中同名的IDL属性所返回的值。
2. 否则，将值设置为树结构中title所有子文本节点的数据的数据连接。如果title元素为null，则返回空字符串。
3. 将值中任何单一或连续的空白字符替换为一个单独的U+0020空格字符。
4. 去除值中开头或结尾的空白字符。
5. 返回值。

当设置title属性时，必须运行下列算法。突变事件必须被适当的出发。

1. 如果根元素是一个拥有“http://www.w3.org/2000/svg”命名空间的svg元素，且用户代理支持SVG，则设值函数必须把操作交由SVGDocument接口中同名的IDL属性的设值函数进行（如果后者为只读，则抛出异常），并在此处结束算法。
2. 如果title元素和head元素均为空，则属性必须不进行任何操作，且在此处结束算法。
3. 如果title元素为空，则新建一个新的title元素，将其追加至head元素之中，并将元素设为新建的元素。否则将元素设为title元素。
4. 必须将元素的所有子节点（如果存在）移除。
5. 一个独立的数据为被分配的值的Text节点必须被追加到元素之中。

如果用户代理同时支持HTML及SVG，则HTMLDocument接口中的title属性应该与SVGDocument接口制动同名属性相同。

文档的body元素是html元素子元素中的第一个body或frameset元素。如果没有这样的元素，则body元素为null，进而，规范要求的由“body元素”触发的时间需要由Document对象代为触发。

当获取body属性时，必须返回当前文档的body元素（body元素、frameset元素或null）。当设置body属性时，必须执行下列算法：

1. 如果新值不是body或frameset元素，则抛出一个HIERARCHY REQUEST ERR异常，且在此处结束算法。
2. 否则，如果新值与body元素相同，则不进行操作，且在此处结束算法。
3. 否则，如果body元素为null，则使用DOM中的新值替换该元素。操作与调用根元素的replaceChild()方法相同，其中两个参数分别为新值和当前body元素。之后在此处结束算法。
4. 否则，body元素为空。将新值追加到根元素中。

images属性必须返回一个根植于Document节点的HTMLCollection，其过滤器仅匹配img元素。

embeds属性必须返回一个根植于Document节点的HTMLCollection，其过滤器仅匹配embed元素。

plugins属性必须返回与embeds属性相同的对象。

links属性必须返回一个根植于Document节点的HTMLCollection，其过滤器仅匹配拥有href属性的a元素和area元素。

forms属性必须返回一个根植于Document节点的HTMLCollection，其过滤器仅匹配form元素。

scripts属性必须返回一个根植于Document节点的HTMLCollection，其过滤器仅匹配script元素。

getElementsByName(name)方法以一个字符串name为参数，并且必须返回一个包含文档树结构中所有特定的HTML元素的活动的（live）NodeList，这些元素的name属性的值与name参数相等（区分大小写）。如果方法被Document对象使用相同的参数重复调用，则用户代理可以返回与之前调用返回值相同的对象。其他情况下，则必须返回一个新的NodeList对象。

getElementsByClassName(classNames)方法以一个由表示class的标记以空格分隔所组成的字符串作为参数。当调用该方法时，必须返回一个包含文档树结构中所有特定的元素的活动的（live）NodeList对象。这些元素的class被指定为参数值。class通过按空格分隔字符串（忽略重复）获得。如果参数中没有指定class标记，则方法必须返回一个空的NodeList。如果文档为怪癖模式，则对class的比较必须采用ASCII码的区分大小写方式进行，否则，必须采用区分大小写方式进行。如果方法被Document对象使用相同的参数重复调用，则用户代理可以返回与之前调用返回值相同的对象。其他情况下，则必须返回一个新的NodeList对象。

HTMLElement接口下的getElementsByClassName(classNames)方法必须返回一个活动的（live）NodeList，其中的节点为HTMLDocument的getElementsByClassName()方法使用相同参数所返回的节点，其中不包括调用当前方法的HTMLElement对象的子节点以外的所有节点。如果方法被一个HTMLElement对象使用相同的参数重复调用，则用户代理可以返回与之前调用返回值相同的对象。其他情况下，则必须返回一个新的NodeList对象。

HTML、SVG和MathML元素通过一个不含命名空间的名为class的属性定义了它们所在的class，该属性的值为使用空格分隔的这些元素所属的class的列表。其他规范可能同时允许元素使用命名空间来标记它们属于特殊的class。

<div id="example">
  <p id="p1" class="aaa bbb"/>
  <p id="p2" class="aaa ccc"/>
  <p id="p3" class="bbb ccc"/>
</div>

HTMLDocument接口支持命名属性。在任何时候，支持的属性名包括： Document中拥有name内容属性的applet、embet、form、iframe、img和fallback-free对象元素的name内容属性的值； Document中拥有id内容属性的applet和fallback-free对象元素的id内容属性的值； Document中同时拥有id和name内容属性的imgid内容属性的值；

当HTMLDocument通过一个名为name的属性检索进行索引，用户代理必须通过执行下列步骤获得返回值：

1. 设elements为Document中的名为name的已命名元素列表。
   注：根据定义，至少要有一个这样的元素。
2. 如果elements中仅包含一个元素，且该元素是一个iframe元素，则返回iframe元素说代表的嵌套浏览器上下文的WindowProxy对象，之后在此处结束算法。
3. 否则，如果elements中仅包含一个元素，则返回该元素，之后在此处结束算法。
4. 否则，返回一个植根于Document节点的HTMLCollection，其过滤器仅匹配名为name的已命名元素

对于上述算法，“名为name的已命名元素”指的是：

1. 拥有name内容属性且其值为name的applet、embed、form、img或fallback-free对象元素。或
2. 拥有id内容属性且其值为name的applet或fallback-free对象元素。或
3. 拥有id和name内容属性且id属性值为name的img元素

如果一个object元素没有object或embed的后裔，则其被称为fallback-free。

创建文档

XML文档可以通过脚本程序在DOMImplementation接口上使用createDocument()方法创建。

HTML文档可以使用createHTMLDocument()方法创建：

当调用createHTMLDocument(title)方法时，必须执行下列步骤：

1. 设doc为一个新创建的Document对象。
2. 标记doc为一个HTML文档。
3. 创建一个DocumentType节点，该节点的name属性被设为“html”，其他DocumentType对象的具体属性根据各自情况被设为空字符串、null或空列表。向doc中追加新创建的节点。
4. 创建一个html元素，将其追加到doc之中。
5. 创建一个head元素，将其追加到上一步创建的html元素之中。
6. 创建一个title元素，将其追加到上一步创建的head元素之中。
7. 创建一个Text节点，将其data属性设为方法参数所给出的字符串（可能为空字符串），将其追加到上一步创建的title元素之中。
8. 创建一个body元素，将其追加到早前几步创建的html元素之中。
9. 返回doc。

加载XML文档

一个由DOMImplementation.createDocument()工厂方法创建的XML文档的Document对象，必须同时实现XMLDocumentLoader接口：

load(url)方法必须执行下列步骤：

1. 设document为调用方法的Document对象。
2. 相对于入口脚本（entry script）的基本URL（base URL）分析方法的第一个参数。如果不成功，抛出一个SYNTAX ERR异常，之后在此处结束算法。否则，设url为分析所得的绝对URL。
3. 如果url的源与document的源不相同，则抛出一个SECURITY ERR异常，之后在此处结束算法。
4. 在不触发任何突变实践的情况下，移除document的所有孩子结点。
5. 将document的当前文档准备设为“loading”。
6. 异步地执行下列步骤，并且从方法中返回true。
7. 设result为一个Document对象。
8. 设success为false。
9. 从document的源中提取（Fetch）url，并且设置同步标记（synchronous flag）和强制同源标记（force same-origin flag）。
10. 如果提取成功，并且资源的内容类型元数据（Content-Type metadata）为XML MIME类型，则执行下列分步骤：
    1. 创建一个与result文档关联的新的XML解析器。
    2. 通过这个解析器提取文档。
    3. 如果出现XML良构（well-formedness）或XML命名空间良构错误，则移除result中的所有子节点。否则设success为true。
11. 排队任务执行下列步骤：
    1. 设置document的当前文档准备为“complete”。
    2. 使用result的子节点（即使其没有子节点）替换所有document的子节点，触发与插入包含新的子节点的DocumentFragment时相同的突变事件。
    3. 触发document的一个名为load的简单事件。

元素

语义

本章節不具有實作相關內容

DOM中的元素

表示DOM中HTML元素的节点必须实现，并且向脚本程序公开，有关它们的接口将在本规范的相关章节中列出。这包括XML文档的HTML元素，即使这些文档在其他上下文中（例如在XSLT转换之内）。

从所有HTML元素的接口继承而来，并且必须被没有额外需求的元素所使用的基本接口，被称为HTMLElement接口。

interface HTMLElement : Element {
  // DOM树访问器
  NodeList getElementsByClassName(in DOMString classNames);

  // 动态标记插入
           attribute DOMString innerHTML;
           attribute DOMString outerHTML;
  void insertAdjacentHTML(in DOMString position, in DOMString text);

  // 元数据属性
           attribute DOMString id;
           attribute DOMString title;
           attribute DOMString lang;
           attribute DOMString dir;
           attribute DOMString className;
  readonly attribute DOMTokenList classList;
  readonly attribute DOMStringMap dataset;

  // 用户互动
           attribute boolean hidden;
  void click();
           attribute long tabIndex;
  void focus();
  void blur();
           attribute DOMString accessKey;
  readonly attribute DOMString accessKeyLabel;
           attribute boolean draggable;
  [PutForwards=value] attribute DOMSettableTokenList dropzone;
           attribute DOMString contentEditable;
  readonly attribute boolean isContentEditable;
           attribute HTMLMenuElement contextMenu;
           attribute boolean spellcheck;

  // 命令API
  readonly attribute DOMString commandType;
  readonly attribute DOMString label;
  readonly attribute DOMString icon;
  readonly attribute boolean disabled;
  readonly attribute boolean checked;
  // styling

  // 事件处理行为IDL属性
           attribute Function onabort;
           attribute Function onblur;
           attribute Function oncanplay;
           attribute Function oncanplaythrough;
           attribute Function onchange;
           attribute Function onclick;
           attribute Function oncontextmenu;
           attribute Function oncuechange;
           attribute Function ondblclick;
           attribute Function ondrag;
           attribute Function ondragend;
           attribute Function ondragenter;
           attribute Function ondragleave;
           attribute Function ondragover;
           attribute Function ondragstart;
           attribute Function ondrop;
           attribute Function ondurationchange;
           attribute Function onemptied;
           attribute Function onended;
           attribute Function onerror;
           attribute Function onfocus;
           attribute Function oninput;
           attribute Function oninvalid;
           attribute Function onkeydown;
           attribute Function onkeypress;
           attribute Function onkeyup;
           attribute Function onload;
           attribute Function onloadeddata;
           attribute Function onloadedmetadata;
           attribute Function onloadstart;
           attribute Function onmousedown;
           attribute Function onmousemove;
           attribute Function onmouseout;
           attribute Function onmouseover;
           attribute Function onmouseup;
           attribute Function onmousewheel;
           attribute Function onpause;
           attribute Function onplay;
           attribute Function onplaying;
           attribute Function onprogress;
           attribute Function onratechange;
           attribute Function onreadystatechange;
           attribute Function onreset;
           attribute Function onscroll;
           attribute Function onseeked;
           attribute Function onseeking;
           attribute Function onselect;
           attribute Function onshow;
           attribute Function onstalled;
           attribute Function onsubmit;
           attribute Function onsuspend;
           attribute Function ontimeupdate;
           attribute Function onvolumechange;
           attribute Function onwaiting;
};
interface HTMLUnknownElement : HTMLElement { };

HTMLElement接口拥有的方法和属性与一些不同的特性有关，因此该接口的成员将在本规范的不同章节分别介绍。

HTMLUnknownElement接口必须被用于本规范（或其他适用的规范）中没有定义的HTML元素。

全局属性

下列各项是常见的，且可以被所有HTML元素（即使是那些没有在本规范中定义的）所指定的属性。

• accesskey
• class
• contenteditable
• contextmenu
• dir
• draggable
• dropzone
• hidden
• id
• lang
• spellcheck
• style
• tabindex
• title

下列各项是可以被任何HTML元素指定的事件处理函数内容属性。

• onabort
• onblur*
• oncanplay
• oncanplaythrough
• onchange
• onclick
• oncontextmenu
• oncuechange
• ondblclick
• ondrag
• ondragend
• ondragenter
• ondragleave
• ondragover
• ondragstart
• ondrop
• ondurationchange
• onemptied
• onended
• onerror*
• onfocus*
• oninput
• oninvalid
• onkeydown
• onkeypress
• onkeyup
• onload*
• onloadeddata
• onloadedmetadata
• onloadstart
• onmousedown
• onmousemove
• onmouseout
• onmouseover
• onmouseup
• onmousewheel
• onpause
• onplay
• onplaying
• onprogress
• onratechange
• onreadystatechange
• onreset
• onscroll*
• onseeked
• onseeking
• onselect
• onshow
• onstalled
• onsubmit
• onsuspend
• ontimeupdate
• onvolumechange
• onwaiting

自定义数据属性（例如data-foldername或data-msgid）能够被指定在任意HTML元素上，来储存特定于页面的自定义数据。

在HTML文档中，对于HTML命名空间内的元素，该元素可以拥有一个值为“http://www.w3.org/1999/xhtml”的xmlns属性。这不适用于XML文档。

XML规范还允许在一个XML文的的任意一个元素上的XML命名空间中使用xml:space属性。该属性对于HTML元素没有作用，因为在HTML中的默认行为是保留空白。

对HTML元素和属性标注“辅助技术产品注释”（ARIA role和aria-*属性），来开启辅助技术产品，将会公开更细颗粒度的接口。

id属性

id属性用于指定其元素的唯一标识符（ID）。它的值必须在元素的根子树（home subtree）的所有ID中保持唯一，并且包含至少一个字符。该值必须不包含任何空白字符。

若其值不是空字符串，用户代理必须将该元素与指定的值关联起来（确切地，包含任何空格字符），以便在元素的根子树中进行ID匹配（例如CSS中的选择器或DOM中的getElementById()方法）。

标识符是不透明的字符串。尤其是元素的含义不应该来自id属性的值。

如果其他机制（例如DOM核心方法）能够在不与id属性冲突的情况下设置一个元素的ID，本规范亦不排除元素拥有多个ID。

id IDL属性必须反映id内容属性。

title属性

title属性表示元素的资讯信息，例如适当的提示。在链接上，它可能是目标资源的标题或描述；在图片上，它可能是图片来源或图片的描述；在段落中，它可能是该段文字的脚注或评论；在引文中，它可能是来源的详尽信息或出处。该属性的值是文字。

如果这个属性被元素所省略，则意味着与该元素的最近的拥有title属性的祖先HTML元素的title属性同样与该元素有关。通过设置这个属性，可以显式地说明任何祖先的资讯信息都与该元素无关。设置这个属性为空字符串，则说明该元素没有咨询信息。

如果title属性的值包含U+000A换行（LINE FEED， LF）字符，则其内容将被分割为多行。每个U+000A换行（LINE FEED， LF）字符代表一个换行符。

<p>我的记录表明很多人对<abbr title="Hypertext
Transport Protocol">HTTP</abbr>感兴趣。</p>

某些诸如link、abbr和input元素在上述语义描述之外赋予了title属性额外的语义。

title IDL属性必须反映title内容属性。

lang和xml:lang属性

lang属性（没有命名空间）表示元素内容以及元素的属性所包含的文字的主要语言。它的值必须为一个有效地BCP 47语言标签或空字符串。将该值设为空字符串表示主语言不明。[BCP47]

拥有XML命名空间的lang属性在XML中定义。[XML]

如果该属性元素被忽略，则元素的语言与其父元素的语言相同。

拥有XML命名空间的lang属性可以被用于XML文档中的HTML元素，如果相关的规范允许，其也可以被用于其他命名空间中的元素（特别是MathML和SVG允许拥有XML命名空间的lang属性被用于其元素之上）。如果拥有XML命名空间的lang属性和没有命名空间的lang属性同时被标记于同一个元素之上，则它们必须在ASCII不区分大小写方式的比较下拥有相同的值。

编码人员不得在HTML文档内的HTML元素上使用拥有XML命名空间的lang属性。为了轻松的从XHTML或向XHTML迁移，编码人员可以为HTML文档中的HTML元素指定一个没有代理的字面上的局部名称为“xml:lang”的没有命名空间的属性，但是这些属性仅能在已经指定了一个没有命名空间的lang属性的情况下指定，且两个属性的值必须在ASCII不区分大小写方式的比较下拥有相同的值。

为了确定一个节点的语言，用户代理必须查找最近的祖先元素（如果节点是一个元素，则需包含该元素本身），这些祖先元素需要设置了拥有XML命名空间的lang属性，或者如果是HTML元素则需设置了没有命名空间的lang属性。该属性的值表示节点的语言（不论其值是什么）。

如果拥有XML命名空间的lang属性和没有命名空间的lang属性同时被标记于同一个元素之上，在确定元素的语言时，用户代理必须使用拥有XML命名空间的lang属性，并且忽略没有命名空间的lang属性。

如果节点的祖先（包括根元素）均没有设置上述两种属性，但是设置了杂集默认语言（pragma-set default language），则该值为节点的语言。如果仍然没有设置杂集默认语言，则必须使用上级协议（诸如HTTP）的语言信息作为最终返回的语言。如果没有任何的语言信息且上级协议返回了多个语言，则节点的语言为不明，且设置相应的语言标签为空字符串。

如果返回值不是一个有效地语言标签，则必须将其视为具有指定语言标签的不同于其他语言的一种未知语言。为了与给出该语言标签的服务进行交互与通信，用户代理应该在不进行修改的情况下通过该语言标签。

如果返回值是空字符串，则必须将这种情况明确地解释为节点的语言为不明。

用户代理可以使用元素的语言来决定如何恰当的进行处理和渲染（例如，选择适当的字体或发音、选择字典）。

lang IDL属性必须反映没有命名空间的lang内容属性。

xml:base属性

xml:base属性在XML Base中定义。[XMLBASE]

xml:base属性可以被用于XML文档的元素上。编码人员不得在HTML文档中使用xml:base属性。

dir属性

dir属性指定元素文本的书写方向。该属性是一个枚举属性，它的值为下列关键字和状态之一：

• ltr关键字，映射至ltr状态。
  表示元素的内容是明确的从左至右嵌入文本。
• rtl关键字，映射至rlt状态。
  表示元素的内容是明确的从右至左嵌入文本。
• auto关键字，映射至auto状态。
  表示元素的内容是明确的嵌入文本，但方向取决于元素的内容的编写方式。（如下所述）
  注：此状态所使用的判断方法非常粗略（在双向算法中基于段落级的判断方法只关注第一个具有强方向性的字符）。
  编码人员被要求仅在确实不知道文本的方向且不能使用服务器端算法判断方向时使用该值。
  注：对于textarea和pre元素，判断算法将应用于“每一段落”等级。

该属性没有默认无效值和默认缺失值。

元素的方向只能为'ltr'或'rtl'之一，并且，对于它的值，应该经由逐一匹配下列步骤得出：

• 如果元素的dir属性为ltr状态
  则元素的方向为'ltr'。
• 如果元素的dir属性为rtl状态
  则元素的方向为'rtl'。
• 如果元素的dir属性为auto状态
• 如果该元素是一个bdi元素且dir属性的值不是一个已定义的状态（例如该状态不存在或者是一个无效的值）
  按照下列标准沿着树形结构查找第一个字符：
  • 该字符来自一个已经确定文字方向的元素的后裔文本节点。
  • 该字符是类型为L、AL或者R的双向字符。[BIDI]
  • 该字符不再一个文本节点之中，且该节点拥有一个已知方向的元素的后裔元素作为其祖先元素，且该元素为下列元素之一：
    • 一个HTML5#bdi元素bdi元素
    • 一个script元素
    • 一个style元素
    • 一个dir属性的值为已定义状态的元素
  • 如果找到满足条件的字符，并且该字符是类型为AL或者R的双向字符，则元素的方向为'rtl'。
    否则元素的方向为'rtl'。
• 如果该元素是一个根元素且dir属性的值不是一个已定义的状态（例如该状态不存在或者是一个无效的值）
  则元素的方向为'ltr'。
• 如果该元素有一个父元素且dir属性的值不是一个已定义的状态（例如该状态不存在或者是一个无效的值）
  则元素的方向与其父元素的方向一致。

这个属性的作用主要在表现层。举例说明，在本规范的渲染部分定义了从该属性到CSS的'direction'和'unicode-bidi'属性的映射，并且，CSS针对这些属性所定义了渲染方式。

dir IDL属性必须反映元素的dir内容属性，且仅限已知的值。

如果HTMLDocument对象中的html元素存在[HTML5#dir属性|dir]]内容属性，则dir IDL属性必须反映html元素的dir内容属性，且仅限已知的值。如果没有，则该属性必须返回空字符串并且不执行设值函数。

<p dir=auto class="u1"><b><bdi>Student</bdi>:</b> How do you write "What's your name?" in Arabic?</p>
<p dir=auto class="u2"><b><bdi>Teacher</bdi>:</b> ما اسمك؟</p>
<p dir=auto class="u1"><b><bdi>Student</bdi>:</b> Thanks.</p>
<p dir=auto class="u2"><b><bdi>Teacher</bdi>:</b> That's written "شكرًا".</p>
<p dir=auto class="u2"><b><bdi>Teacher</bdi>:</b> Do you know how to write "Please"?</p>
<p dir=auto class="u1"><b><bdi>Student</bdi>:</b> "من فضلك", right?</p>

class属性

任意HTML元素都可以指定class属性。

如果指定了该属性，则其值必须为以空格分隔的该元素所属各类名称的集合。

指定给HTML元素的类，来自于将该元素class属性的值按照空格分割所得的所有的类（忽略重复）。

对于编码人员使用的用于class属性的值的名称没有额外的限制，但是我们鼓励编码人员使用“内容的性质”而不是“内容的预期表现”作为该属性的值。

className和classList IDL属性都必须反映元素的class内容属性。

style属性

所有HTML元素都可以设置style属性。这是一个定义自CSS样式属性语法规范的CSS样式属性。

对于支持CSS的用户代理，该属性的值必须在被增加或修改时按照CSS样式属性给出的规则进行解析。

对于其中任意元素使用了style属性的文档，如果这些属性被移除，则该文档必须仍然能够被理解和可用。

style IDL属性都必须返回其值表示该属性所指定的声明的CSSStyleDeclaration对象。为了改变CSSStyleDeclaration对象，必须为该元素创建一个style属性（如果不存在）并且将其值改为表示CSSStyleDeclaration对象序列化形式的值。

<p>我的运动服是<span style="color: green; background: transparent">绿色的</span>，
我的眼睛是<span style="color: blue; background: transparent">蓝色的</span>。</p>

用data-*属性嵌入自定义的不可见数据

自定义数据属性是一个没有命名空间的属性。该属性的名称以字符串“data-”开头，并且在连字符之后有至少一个字符，为了兼容XML，这些字符还不能包含U+0041到U+005A范围内的字符（拉丁大写字母A至拉丁大写字母Z）。

自定义数据属性被设计用于在没有适当的属性或元素的情况下储存页面或应用范围内的自定义数据。

该属性不是为了独立于使用该属性的网站的软件而设计的。

<ol>
	<li data-length="2m11s">Beyond The Sea</li>
</ol>

每一个HTML元素都可以通过任意的值指定多个自定义数据属性。

dataset IDL属性提供对元素的data-*属性的方便的存取功能。当获取时，dataset IDL属性必须参照下列算法返回一个暴露该元素这些属性的DOMStringMap对象：

• 用于获取名值对里列表的算法
  1. 设list为一个空的名值对列表。
  2. 对于元素中每一个前五个字符为字符串“data-”且其余字符（如果存在）中不包含U+0041到U+005A范围内的字符（拉丁大写字母A到拉丁大写字母Z）的内容属性，向list添加一个名值对，该名值对的名称为移除了前五个字母的属性名称，值为属性的值。
  3. 对于列表中的每个名称中的每个其后跟随U+0061到U+007A范围内字符（拉丁小写字母A到拉丁小写字母Z）的U+002D“连字符-符号”字符（-），移除U+002D“连字符-符号”字符（-）并且替换其后跟随的字符为相同字符的ASCII大写形式。
  4. 返回list
• 用于为某值设置名称的算法
  1. 设name为输入到算法中的名称。
  2. 设value为输入到算法中的值。
  3. 如果name包含跟随在U+0061到U+007A范围内的字符（拉丁小写字母A-拉丁小写字母Z）之后的U+002D连字符-负号字符（-），则抛出一个SYNTAX ERR异常，并在此处结束算法。
  4. 对于name中的每一个U+0041到U+005A范围内的字符（拉丁大写字母A-拉丁大写字母Z），在该字符前插入一个U+002D连字符-负号字符（-）并将该字符替换为相同字符的ASCII小写形式。
  5. 在name之前插入字符串“data-”。
  6. 设置名为name的属性，将其值设为value，如果该属性已经存在则替换原值。如果setAttribute()在设置名为name的属性时抛出异常，则本算法必须抛出同样的异常。
• 用于删除名称的算法
  1. 设name为输入到算法中的名称。
  2. 对于name中的每一个U+0041到U+005A范围内的字符（拉丁大写字母A-拉丁大写字母Z），在该字符前插入一个U+002D连字符-负号字符（-）并将该字符替换为相同字符的ASCII小写形式。
  3. 在name之前插入字符串“data-”。
  4. 如果名为name的属性存在，则删除该属性。否则不执行任何操作。

每次调用必须返回相同的对象。

<div class="spaceship" data-ship-id="92432"
     data-weapons="laser 2" data-shields="50%"
     data-x="30" data-y="10" data-z="90">
 <button class="fire"
         onclick="spaceships[this.parentNode.dataset.shipId].fire()">
  开火
 </button>
</div>

编码人员应该仔细地设计这些扩展，以便当这些属性被忽略或者任意相关CSS被移除后该页面仍然可用。

用户代理禁止通这些属性或值中派生实现行为。规范要求用户代理禁止为这些属性定义任何有意义的值。

JavaScript库可以使用自定义数据属性，因为它们被认为是其所使用的页面的一部分。我们鼓励那些广泛应用的JavaScript库的作者将他们的名字用于属性名之中，以减少冲突的风险。如果需要，我们也鼓励JavaScript库的作者在属性名中使用自定义的严谨的名称，以便那些作者在不知情的情况下使用了相同名称的库可以被用于同一个页面，以及某个库的不同版本能够被用于同一个页面，即使这些版本相互不兼容。

元素定义

本规范中的每个元素都有一个包含下列信息的定义：

• 分类
  该元素所属的分类的列表。用于为每个元素设置内容属性。
• 该元素可用于哪些上下文中
  该元素可被用于的地方的非规范描述。这些信息与哪些允许此元素作为子节点的元素的内容模型信息相互冗余，本信息仅仅为了方便。
  注：为简单起见，只列出了最具体的期望。举例说明，一个既是流式内容又是章节式内容的元素可以用于预期为流式内容或章节式内容的任何地方，但是因为所有预期为流式内容的地方都会同时预期章节式内容（因为所有章节式内容都是流式内容），所以只会列出“这里预期的是章节式内容”。
• 内容模型
  该元素必须包含为孩子或后继的内容的规范的描述。
• 内容属性
  该元素可以指定的属性的规范的列表。
• DOM接口
  该元素必须实现的DOM接口的规范的定义。

这之后将是该元素所表示内容的描述、编码人员和实现可能需要的额外的符合标准的规范。有时可能还会包含示例。

属性

除非另有规定，HTML元素的属性可以包含任意字符串值，包括空字符串。除非明确说明，对于这些属性所指定的文本没有限制。

内容模型

所有本规范内定义的元素都拥有一个内容模型：该元素的预期内容的描述。一个HTML元素的内容必须与该模型的内容模型中描述的需求相匹配。

元素之间的空白字符是被允许的。在DOM中用户代理以文本节点的形式表示这些源标记中存在于元素之间的字符。空文本节点以及仅包含空白字符序列的文本节点被认为是元素间空白（inter-element whitespace）。

元素间空白、注释节点以及处理指令节点在判断元素的内容是否与元素的内容模型相匹配时必须被忽略，另外在使用下列算法定义文档及元素的语义时也必须被忽略。

编码人员仅能将HTML元素用于其显式允许的地方，这些地方由每个元素定义，或被其他规范明确的需要。对于XML复合文档，如果某些元素的定义声明其提供相关的上下文，则这些上下文可以存在于其他命名空间的元素之中。

此外，HTML元素还可能是一个孤儿节点（例如没有父节点）。

var data = {
  name: "Banana",
  cell: document.createElement('td'),
};

内容种类

HTML中的每个元素都属于零或多个分类（categories），这些分类将元素按照相似的特性分组。下列大类将在本规范中使用：

• 元数据式内容（Metadata content）
• 流式内容（Flow content）
• 章节式内容（Sectioning content）
• 标题式内容（Heading content）
• 段落式内容（Phrasing content）
• 嵌入式内容（Embedded content）
• 交互式内容（Interactive content）

此外，某些元素被分类为表单连结元素并且由更细的分类定义其在各自关于表单的处理模型中的角色。

一些元素拥有特殊要求并且不适合于任何特定分类。

元数据式内容

元数据式内容可以被用于说明其他内容的表现或行为、在当前文档和其他文档之间建立联系以及传递其他“带外（out of band）”信息。

来自其他命名空间的元素，若其语义主要与元数据相关（例如RDF），则其也是元数据式内容。

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:r="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
  <head>
    <title>主页</title>
    <r:RDF>
      <Person xmlns="http://www.w3.org/2000/10/swap/pim/contact#" r:about="http://metadata.example.com/#">
        <fullName>Cat Hedral</fullName>
        <mailbox r:resource="mailto:hedral@damowmow.com"/>
        <personalTitle>Sir</personalTitle>
      </Person>
    </r:RDF>
  </head>
  <body>
    <h1>我的主页</h1>
  </body>
</html>

流式内容

在应用程序和文档的主体部分中使用的大部分元素都被分类为流式内容。

作为通用规则，内容模型允许流式内容的元素，应该拥有至少一个不是元素间空白的文本节点或者嵌入式内容的元素节点作为其后裔。该要求的目的在于，del元素及其后裔不能被作为del元素的祖先。

该要求不是硬性要求，因为在很多情况下，一个元素能够合法的被设为空。举例说明，一个元素可能被用作占位符，该元素将在之后通过脚本程序填充；或者一个元素可能作为模板的一部分，该元素可能只在某些页面被填充。

章节式内容

章节式内容是用于定义标题及页脚范围的内容。

每一个#sectioning-content章节式内容的元素都隐式的拥有一个标题和一个大纲。查看头和区块章节了解详细信息。

标题式内容

标题式内容定义一个区块/章节（section）（无论是明确的使用章节式内容的元素标记，或者标题式内容自身所隐含的）的标题。

段落式内容

段落式内容是文档中的文本、以及标记段落级文本的元素。段落式内容从段落中来。

a（如果其只包含段落式内容）， abbr， area（如果它是map元素的后裔）， audio， b， bdi， bdo， br， button， canvas， cite， code， command， datalist， del（如果其只包含段落式内容）， dfn， em， embed， i， iframe， img， input， ins（如果其只包含段落式内容）， kbd， keygen， label， map（如果其只包含段落式内容）， mark， math， meter， noscript， object， output， progress， q， ruby， s， samp， script， select， small， span， strong， sub， sup， svg， textarea， time， u， var， video， wbr， text

作为通用规则，内容模型允许任意段落式内容的元素应该拥有至少一个不是元素间空白的文本节点或者嵌入式内容的元素节点作为其后裔。该要求的目的在于，del元素及其后裔不能被作为del元素的祖先。

在内容模型的上下文中，文本（Text）表示文本节点。文本在某些时候被用作其自身的内容模型，但是它仍然是段落式内容，并且可以是元素间空白（如果文本节点为空或者仅包含空白字符）。

嵌入式内容

嵌入式内容是引用到本文档中的其他资源的内容，或者被插入到本文档中的其他词汇的内容。

带有除HTML以外的命名空间且传递元数据以外内容的元素，是本规范中内容模型定义的目的的嵌入式内容。（例如：MathML或SVG）。

某些嵌入式内容元素可以拥有备用内容（fallback content）：当外部资源不可用时（例如：因为其为不支持的格式）使用的内容。如果存在该元素，则该元素定义备用内容的状态。

交互式内容

交互式内容是专门用于用户交互的内容。

某些HTML元素拥有一个激活行为（activation behavior），该行为表示用于可以激活它们。该行为触发的一些列事件取决于激活机制。该集中通常为click事件，其描述如下。

用户代理应该允许用户手动触发拥有激活行为的元素，例如通过键盘、声音的输入或鼠标点击。当用户通过除点击以外的一个已定义的激活行为触发了一个元素，则互动事件的默认行为必须在该元素上运行合成点击激活步骤（run synthetic click activation steps）。

当用户代理在元素上运行合成点击激活步骤时，用户代理必须在元素上运行点击前激活步骤（run pre-click activation steps），之后在元素上触发一个click事件。click事件的默认行为必须在元素上运行点击后激活步骤（run post-click activation steps）。如果事件被取消，用户代理必须在元素生改为运行取消激活步骤（run canceled activation steps）。

若一个定点设备（pointing device）被点击，则用户代理必须运行下列步骤：

1. 若用户代理指定的元素的最近的可激活元素存在，则设其为e。
2. 如果元素e存在，则运行它的点击前激活步骤。
3. 调用所需的click事件。
   如果元素e存在，则click事件必须在元素e上运行点击后激活步骤。
   如果元素e存在但事件被取消，则用户代理必须在元素e上运行取消激活步骤。
   注：上述步骤不会发生在任意由作者脚本（author script）派生的合成事件上。然而，click()方法可以被用于通过编程使其发生。

给出一个元素目标target，其最近的可激活元素是通过下列算法返回的：

1. 如果target拥有一个已定义的激活行为，则返回target并且在次步骤停止。
2. 如果target拥有一个父元素，则设置target为该父元素并且返回第一步。
3. 否则，最近的可激活元素不存在。

当一个用户代理在一个元素上运行点击前激活步骤时，如果该元素的点击前激活步骤存在，则必须运行它。

当一个用户代理在一个元素上运行取消激活步骤时，如果该元素的取消激活步骤存在，则必须运行它。

当一个用户代理在一个元素上运行点击后激活步骤时，如果该元素的激活行為存在，则必须运行它。激活行为可以被指向被导致这一点的上述步骤所激活的click事件。

透明内容模型

某些元素被描述为透明的；它们的内容模型描述中存在“透明（transparent）”。一个透明的元素的内容模型是来自它的父元素的内容模型：若一个元素的内容模型中一部分为“透明”，则该元素的需求与该透明元素的父元素中的找到该元素那一部分内容模型的需求相同。

<p><object><param><ins><map><a href="/">Apples</a></map></ins></object></p>

若一个透明元素没有父元素，则该元素标为“透明”的那一部分内容模型必须被视为接受任何流式内容。

段落

一个段落通常是形成讨论一个特定话题的一或多个句子的文本块的段落式内容。与活版印刷相同，但其还可以被用于更多的一般主题小组。举例说明：一个地址可以是一个段落，就像表单的一部分、署名或诗的一节。

<section>
  <h1>段落的例子</h1>
  这是<em>第一个</em>段落。
  <p>这是第二个段落。</p>
  <!-- 这不是段落。 -->
</section>

流式内容中的段落定义了文档在不包含a、ins、del及map元素的情况下的显示形式。因为上述包含混合内容模型的元素可以下下列两个例子中所展示的跨越段落的边界。

<section>
  <ins><h1>段落的例子</h1>
  这是<em>第一个</em></ins>段落<del>。
  <p>这是第二个段落。</p></del>
  <!-- 这不是段落。 -->
</section>

设view为一个DOM视图，该视图将文档内的所有a、ins、del及map元素替换为它们的内容。之后，在view中，对于遇到的每一个不被其他类型的内容（允许的内容不是段落式内容的元素以及段落式内容）中断的兄弟段落式内容节点，设first为遇到的第一个节点，设last为遇到的最后一个节点。对于每一个由至少一个既不是嵌入式内容也不是元素间空白的上述结果，在源DOM中都存在一个紧接着first和last的段落。（因此段落可以跨越a、ins、del及map元素）

一致性检查器可能会因为段落相互重叠而发出警告（这可能发生于object、video、audio和canvas元素，以及间接通过其他命名空间的元素嵌入的HTML，如svg或math）。

一个段落也可以明确的通过p元素形成。

<aside>
 Welcome!
 <a href="about.html">
  This is home of...
  <h1>The Falcons!</h1>
  The Lockheed Martin multirole jet fighter aircraft!
 </a>
 This page discusses the F-16 Fighting Falcon's innermost secrets.
</aside>

<aside>
 <p>Welcome! <a href="about.html">This is home of...</a></p>
 <h1><a href="about.html">The Falcons!</a></h1>
 <p><a href="about.html">The Lockheed Martin multirole jet
 fighter aircraft!</a> This page discusses the F-16 Fighting
 Falcon's innermost secrets.</p>
</aside>

<section>
 <h1>My Cats</h1>
 You can play with my cat simulator.
 <object data="cats.sim">
  To see the cat simulator, use one of the following links:
  <ul>
   <li><a href="cats.sim">Download simulator file</a>
   <li><a href="http://sims.example.com/watch?v=LYds5xY4INU">Use online simulator</a>
  </ul>
  Alternatively, upgrade to the Mellblom Browser.
 </object>
 I'm quite proud of it.
</section>

关于双向文字处理算法的需求

子节点为文本节点的HTML元素中的文本内容，以及元素自由形式（free-form）文本的HTML元素属性中的文本，可以包含U+202A到U+202E范围内的字符（双向算法格式字符）。然而对这些字符的使用受到了限制，以便防止由这些字符产生的嵌入或者覆盖从不同的父元素中开始和结束，并且使所有这些嵌入和覆盖明确的以一个U+202C POP DIRECTIONAL FORMATTING字符。这将有助于降低文字被以对于双向算法有不可预见影响的形式被重用所带来的风险。

上述限制是通过指定文档中的某些部分形成双向算法格式字符范围（bidirectional-algorithm formatting character range）并且在该范围内实施要求来进行定义的。

如果存在一个HTML元素的文本节点的所有数据串联而形成的字符串，则该字符串为双向算法格式字符范围。

一个HTML元素的缺少命名空间（namespace-less）的属性的值是一个双向算法格式字符范围。

任意的前面描述的作为双向算法格式字符范围的字符串必须匹配下列由ABNF产生的字符集为Unicode的字符串。

string        = *( plaintext ( embedding / override ) ) plaintext
embedding     = ( lre / rle ) string pdf
override      = ( lro / rlo ) string pdf
lre           = %x202A ; U+202A LEFT-TO-RIGHT EMBEDDING
rle           = %x202B ; U+202B RIGHT-TO-LEFT EMBEDDING
lro           = %x202D ; U+202D LEFT-TO-RIGHT OVERRIDE
rlo           = %x202E ; U+202E RIGHT-TO-LEFT OVERRIDE
pdf           = %x202C ; U+202C POP DIRECTIONAL FORMATTING
plaintext     = *( %x0000-2029 / %x202F-10FFFF )
                ; any string with no bidirectional-algorithm formatting characters

字符串         = *( 纯文本 ( 嵌入 / 覆盖 ) ) 纯文本
嵌入           = ( 左向右嵌入 / 右向左嵌入 ) 字符串 弹出方向性格式
覆盖           = ( 左向右覆盖 / 右向左覆盖 ) 字符串 弹出方向性格式
左向右嵌入     = %x202A ; U+202A LEFT-TO-RIGHT EMBEDDING
右向左嵌入     = %x202B ; U+202B RIGHT-TO-LEFT EMBEDDING
左向右覆盖     = %x202D ; U+202D LEFT-TO-RIGHT OVERRIDE
右向左覆盖     = %x202E ; U+202E RIGHT-TO-LEFT OVERRIDE
弹出方向性格式 = %x202C ; U+202C POP DIRECTIONAL FORMATTING
纯文本         = *( %x0000-2029 / %x202F-10FFFF )
                 ; 任意不包含双向算法格式字符的字符串

WAI-ARIA（Accessible Rich Internet Applications）无障碍的富因特网应用程序

除非与下列强原生语义发生冲突，编码人员可以按照ARIA规范所描述的要求在HTML元素上使用ARIA角色及aria-*属性。与强原生语义冲突的例外是为了防止编码人员造成辅助技术产品报告不能反映文档当前状态的无意义的状态。

用户代理被要求在所有HTML元素上像ARIA规范所定义的那样实现ARIA语义。下列被定义的隐式ARIA语义必须通过实现来被承认。

下列表格定义了应用于HTML元素的强原生语义及相应的隐式ARIA语义。第一列的每一个单元格内的语言特性（元素或属性）代表的ARIA语义（角色，状态，和/或属性）在同一行内第二列的单元格内给出。当一个元素被应用的多行时，最后一行的角色定义一个必须被应用的角色，所有行的状态和属性都必须被结合。

某些HTML元素拥有可以被重写的自然语义。下面的表格中列出了这些元素、它们的默认隐式ARIA语义以及应用于这些元素上的限制。对于在第一列每一个单元格中的语言特性（元素或属性），除非另有重写，其ARIA语义（角色、状态或属性）将在同一行的第二列的单元格中给出。但是这些语义可以在同一行的第三列单元格中所列出的条件下被重写。此外，任意元素可以无视下列限制被设置为presentation（展示）角色。

当使用强原生语义时，项目“无角色”表示不能被用于除presentation（展示）以外的其他角色。当使用隐式ARIA语义时，项目“无角色”表示用户代理没有到ARIA角色的默认映射。（然而可能存在其在无障碍层的映射。）

WAI-ARIA规范既不要求也不禁止用户代理强化基于WAI-ARIA标记的原生展示和交互行为。即使主流用户代理可以选择公开元数据或者直接或通过用户安装的扩展来导航特性；例如通过表达或标志导航来公开需求。用户代理被鼓励向用户提供最大化的功能，其中包括没有残疾的用户。

一致性检查器被鼓励提供更丰富的错误信息，以鼓励编码人员使用更恰当的元素而不是删除无障碍注释。举例说明，如果一个a元素被标记为拥有button（按钮）角色，一致性检查器可以提示“使用更恰当的元素表示一个按钮，例如button元素或input元素”而不是“button角色不能被用于a元素”。

<figure role="img" aria-labelledby="fish-caption"> 
 <pre>
 o           .'`/
     '      /  (
   O    .-'` ` `'-._      .')
      _/ (o)        '.  .' /
      )       )))     ><  <
      `\  |_\      _.'  '. \
        '-._  _ .-'       '.)
    jgs     `\__\
 </pre>
 <figcaption id="fish-caption">
  Joan G. Stark, "<cite>fish</cite>".
  October 1997. ASCII on electrons. 28×8.
 </figcaption> 
</figure> 

HTML文档中的API

对于HTML文档以及HTML文档内的HTML元素，在DOM核心（DOM Core）中定义的某些API不区分大小写或大小写可变，这些情况在DOM核心中进行定义或者在下面进行总结或要求。

这部分内容不适用于XML文档及不属于HTML命名空间的元素（尽管它们在HTML文档内）。

Element.tagName及Node.nodeName
这些属性必须返回元素名称的ASCII大写形式，不管它们是在何种情况下创建的。

Element.setAttribute()
Element.setAttributeNode()
属性名称是ASCII小写形式。

Element.getAttribute()
Element.getAttributeNode()
属性名称是ASCII小写形式。

Document.getElementsByTagName()
Element.getElementsByTagName()
HTML元素的匹配要求在比较之前将参数转换为小写，从其他命名空间而来的元素被视为在XML（大小写敏感）之内。

与XPath和XSLT交互

动态注入标记

打开输入流

open()方法拥有几个带有不同数量参数的形式。

当使用两个及更少参数调用该方法时，该方法必须执行下列操作：

1. 如果Document对象没有被标记为HTML文档，则抛出一个INVALID_STATE_ERR异常并且在此停止。
2. 如果第一个参数的值存在，则设type为该值，否则设为“text/html”。
3. 如果第二个参数存在且其值ASCII不区分大小写的匹配“replace”，则设replace为真，否则设为假。
4. 如果文档有一个不是脚本所创建的分析器作为其活动分析器，并且与分析器的输入流相关的插入点不是未定义（undefined）状态（即，其为输入流中某处的一点），则该方法不起作用。跳过之后的步骤，并且返回调用本方法的Document对象。
   注：当document.open()被在解析通过网络传来的数据时所发现的行内脚本程序调用时，它将被忽略。但是当调用异步操作或在一个文档中通过该API填鸭式调用其自身时，仍然需要正常发挥作用。
5. 执行储存互斥。
6. 提示卸载该Document对象。如果用户拒绝允许该文档被卸载，则在这步必须被终止。
7. 卸载该Document对象，并且设recycle属性为真。
8. 放弃该Document对象。
9. 注销所有该注册在该Document节点及其后裔上的事件侦听器。
10. 删除任意任务源中与该Document相关的任意任务。
11. 在不触发音译变化事件的情况下删除文档的所有子节点。
12. 用该对象的新实例替换Document的独立对象。（包括Window、Location、History、ApplicationCache和Navigator对象、各种BarProp对象、两个Storage对象、各种HTMLCollection对象以及诸如Selection等的定义在其他规范中的对象。还包括所有Document对象的原型在内的所有JavaScript绑定的Web IDL原型。）
13. 修改文档的字符编码为UTF-8。
14. 设置Document对象的重载覆盖标志，并且设置Document的重载覆盖缓冲器为空字符串。
15. 修改文档的地址为条目脚本的文档的地址。
16. 创建一个新的HTML分析器，并且将其与文档关联。这是一个由脚本创建的分析器（表示其可以被document.open()和document.close()方法关闭，并且其标记生成器将在发出一个文件结束（end-of-file）标记前等待一个明确的document.close()调用。）。编码信赖为irrelevant。
17. 设置文档的当前文档准备状态为“loading（载入中）”。
18. 如果type字符串包含一个U+003B分号字符（;），则删除第一个分号字符到字符串结尾之间的所有字符。
    删除type中所有的前导或后缀的空白字符。
    如果type当前不能ASCII不区分大小写的匹配字符串“text/html”，则操作与标记生成器在一个单独的U+000A换行字符后放置一个标记名为“pre”的开始标记相同，之后切换HTML分析器的标记生成器到纯文本状态 。
19. 删除浏览器上下文的会话历史记录中所有当前条目之后的所有条目。如果当前条目是会话历史记录中的最后一条，则不删除条目。
    注：该操作可能不会影响用户代理的用户界面。
20. 通过历史记录遍历任务来源删除任意任务队列。
21. 删除分享相同Document的任意早期条目。
22. 如果replace为假，则在最后一个条目之前添加一个新条目，并将其与Document对象相关的上一个解析器所解析的文本及开始这些步骤时文档的状态相关联。这将允许用户通过在会话历史记录中向后跳转，以查看调用document.open()之前的页面。新条目不拥有Document对象，所以如果会话历史记录跨越了该条目，则需要创建一个新的Document对象。
23. 最后，设置插入点为输入流结束之前的最后一点（在该点输入流将为空）。
24. 返回调用本方法的Document。

若使用三个或更多参数调用本方法，则HTMLDocument对象上的open()方法必须使用相同的参数调用HTMLDocument对象的Window对象上的open()方法，并且返回后者的返回值。如果HTMLDocument对象不包含Window对象，则必须抛出一个INVALID_ACCESS_ERR异常。

关闭输入流

close()方便必须执行下列步骤：

1. 如果Document对象没有被标记为一个HTML文档，则抛出一个INVALID_STATE_ERR异常并跳过这些步骤。
2. 如果不存在与文档相关的脚本所创建的分析器，则跳过这些步骤。
3. 在分析器输入流的最后插入一个明确的“EOF”字符。
4. 如果存在一个挂起的阻塞解析的脚本，则跳过这些步骤。
5. 执行标记生成器，按照标记的放置情况处理结果标记，并在标记生成器遇到明确的“EOF”字符或自身事件循环时结束。

document.write()

Document对象拥有一个忽略破坏性写入计数器，该计数器与对script元素的处理一起被用于防止外部脚本能够通过使用document.write()造成隐式调用document.open()来破坏文档。在开始时，该计数器必须被设为零。

document.write(...)方法必须执行下列操作：

1. 如果方法是在XML文档上调用的，则抛出一个INVALID_STATE_ERR异常并停止操作。
2. 如果插入点是未定义，并且Document的忽略破坏性写入计数器大于零，则停止操作。
3. 如果插入点是未定义，则在document对象上调用open()方法（没有参数）。如果用户拒绝允许文档被卸载，则停止操作。否则插入点将被设为紧接着（空）输入流结束之前。
4. 向插入点之前的输入流插入由所有参数串联组成的字符串。
5. 如果Document对象设置了重载覆盖标记，则向Document的重载覆盖缓冲区追加由所有参数串联组成的字符串。
6. 如果不存在挂起的阻塞解析的脚本，让标记生成器处理插入的字符，逐个地像它们被放置一样处理生成的标记，并且在标记生成器遇到插入点或者标记生成器的处理被树形结构段（tree construction stage）终止（可能发生在一个script结束标记被标记生成器处理时）时停止。
   注：如果document.write()方法被内联执行（例如，因为解析器处理了一组script标记而被执行）的脚本调用，则其为一个解析器的折返调用（reentrant invocation）。
7. 最后，从方法返回。

document.writeln()

对于document.writeln(...)方法，当调用时，必须像使用相同参数追加了一个额外的由单独的换行字符（U+000A）组成的字符串作为参数调用document.write()方法那样执行。

innerHTML

当获得该属性的值时，如果节点所在的文档是一个HTML文档，则该属性必须返回在该节点上执行HTML片段序列化算法的结果；否则，节点所在的文档是一个XML文档，则该属性必须返回在该节点上执行XML片段序列化算法的结果（这有可能抛出一个异常，而不是返回一个字符串）。

当设置该属性的值时，必须执行下列步骤：

1. 如果节点所在的文档是一个HTML文档：调用HTML片段序列化算法。
   如果节点所在的文档是一个XML文档：调用XML片段序列化算法。
   在其他情况下，本算法必须被一个字符串调用，该字符串被分配给innerHTML属性作为input。如果该节点是一个Element节点，则除此之外，该元素也必须被分配给innerHTML属性作为context（上下文）元素。
   如果抛出一个异常，则停止算法。
   否则，设new children为返回的节点。
2. 如果在一个Document节点上设置该属性，且文档拥有一个激活的分析器，则终止算法。
3. 将设置了innerHTML属性的节点的所有子节点删除，触发恰当的变化事件。
4. 如果在一个Document节点上设置该属性，设target document为该Document节点。否则，如果在一个Element节点上设置该属性，设target document为该Element的ownerDocument（所属的文档）。
5. 设置new children中所有节点的ownerDocument为target document。
6. 向设置了innerHTML属性的节点中追加所有的new children节点，保持它们的顺序，并且触发变化事件，就像插入了一个包含new children的DocumentFragment（文档片段）。

outerHTML

当获得该属性的值时，如果节点所在的文档是一个HTML文档，则该属性必须返回在以该节点为子节点的虚拟节点上执行HTML片段序列化算法的结果；否则，节点所在的文档是一个XML文档，则该属性必须返回在虚拟节点上执行XML片段序列化算法的结果（这有可能抛出一个异常，而不是返回一个字符串）。

当设置该属性的值时，必须执行下列步骤：

1. 设target为设置了outerHTML属性的元素。
2. 如果target没有父节点，则终止算法。因为即使执行了后续步骤，也不可能获得所创建的节点的引用。
3. 如果target的父节点是一个Document对象，则抛出一个NO_MODIFICATION_ALLOWED_ERR异常并终止算法。
4. 如果target的父节点不是一个DocumentFragment节点，则设parent为该节点，否则设parent为一个任意的body元素。
5. 如果target所在的稳定是一个HTML文档：调用HTML片段序列化算法。
   如果target所在的稳定是一个XML文档：调用XML片段序列化算法。
   在其他情况下，本算法必须被一个字符串调用，该字符串被分配给outerHTML属性作为input，且parent为context元素。
   如果抛出一个异常，则停止算法。
   否则，设new children为返回的节点。
6. 设置new children中所有节点的ownerDocument为target的文档。
7. 将target从它的父节点删除，触发适当的变更事件，之后，在该处插入所有的new children节点，保持它们的顺序，并且再次触发变更事件，就像插入了一个包含new children的DocumentFragment。

insertAdjacentHTML()

HTML元素

根元素

html元素

分类：

无

使用场景：

做为文档的根元素

在复合文档中允许子文档的位置

内容模型：

一个head元素后跟一个body元素

允许的属性：

全局属性
manifest

DOM接口：

interface HTMLHtmlElement : HTMLElement {};

html元素表示一个HTML文档的根节点。

如果存在的话，manifest属性给出文档的应用程序缓存清单的地址。如果这个属性存在，这个属性的值必需是一个合法的非空URL,URL的首尾允许添加额外的空格。 manifest属性只有在文档先期加载时会产生效果。动态改变这个属性不会生效（所以也没有DOM API为这个属性提供出来）。

    <!DOCTYPE html>
    <html lang="en">
    <head>
    <title>Swapping Songs</title>
    </head>
    <body>
    <h1>Swapping Songs</h1>
    <p>Tonight I swapped some of the songs I wrote with some friends, who
    gave me some of the songs they wrote. I love sharing my music.</p>
    </body>
    </html>
    

文档元数据

head元素

分类：

无

使用场景：

做为html元素中的第一个元素

内容模型：

如果文档是一个iframe的源文档或者标题信息已经由更高层的协议提供，则为0个或者多个元数据式内容

否则是为一个或者多个元数据式内容，其中恰好有一个为title元素

允许的属性：

全局属性

DOM接口：

interface HTMLHeadElement : HTMLElement {};

head元素表示一个文档元数据的集合。

<!doctype html>
<html>
 <head>
  <title>A document with a short head</title>
 </head>
 <body>
 ...

<!DOCTYPE HTML>
<HTML>
 <HEAD>
  <META CHARSET="UTF-8">
  <BASE HREF="http://www.example.com/">
  <TITLE>An application with a long head</TITLE>
  <LINK REL="STYLESHEET" HREF="default.css">
  <LINK REL="STYLESHEET ALTERNATE" HREF="big.css" TITLE="Big Text">
  <SCRIPT SRC="support.js"></SCRIPT>
  <META NAME="APPLICATION-NAME" CONTENT="Long headed application">
 </HEAD>
 <BODY>
 ...

title元素

分类：

元数据式内容

使用场景：

在一个不包含其它title的head元素中

内容模型：

文本

允许的属性：

全局属性

DOM接口：

interface HTMLTitleElement : HTMLElement {
    attribute DOMString text;
}

title元素表示文档的标题或者名称。编写者应该使用即使不在上下文中也能标识他们文档的标题，例如在用户的历史或者标签，抑或是在搜索结果当中。文档的title经常会与它的第一个heading不同，因第一个heading没有被拿出上下文之后的独立性要求。

每个文档中至多有一个title元素。

IDL属性 text 必须返回一个由所有title元素的直接子文本节点按DOM树顺序连接而成的字符串(忽略所有其它节点如注释或者元素)。在被赋值时,它应该采取与IDL属性textContent相同的行为。

<title>Introduction to The Mating Rituals of Bees</title>
    ...
    <h1>Introduction</h1>
    <p>This companion guide to the highly successful
    <cite>Introduction to Medieval Bee-Keeping</cite> book is...

<title>Dances used during bee mating rituals</title>
    ...
    <h1>The Dances</h1>

用来当作文档的标题的字符串由IDL属性document.title提供。

用户代理在将文档展现到它们的UI时，应该使用文档的标题。当一个title元素以这种方式被使用时，title元素的方向性应该用于设置用户界面上文档标题的方向性。

base元素

分类：

元数据式内容

使用场景：

在一个不包含其它base的head元素中

内容模型：

空

允许的属性：

全局属性
href
target

DOM接口：

interface HTMLBaseElement : HTMLElement {
    attribute DOMString href;
    attribute DOMString target;
};

base元素允许编写者指定文档基址URL用于计算相对地址URL, 以及默认的浏览上下文的名字用于接下来的超链接。这个元素不表示此信息之外的任何内容。

每个文档中最多只能出现一个base元素。

一个base元素要至少要有href属性和target属性两者其一，或者全都有也可。

如果href属性被设定了的话，则它必须包含一个合法的URL，前后允许有多余的空格。

一个base元素，如果有href属性的话，则必需出现在DOM树中其它任何有URL型属性的元素之前，html元素除外（它的manifest属性不受base元素影响）。

如果target属性被设定了的话，则它必须包含一个合法的浏览上下文名称或者关键字，这个名称或者关键字指明了当文档中的超链接和表单造成页面跳转时，哪一浏览上下文应该被用作默认。

一个base元素，如果有target属性的话，则必须出现在DOM树中任何表示超链接的元素之前。

IDL属性href，在get时应该返回文档基址URL，在set时则将href属性写入新的值。

target属性则完全反射同名属性。

<!DOCTYPE html>
<html>
    <head>
        <title>This is an example for the <base> element</title>
        <base href="http://www.example.com/news/index.html">
    </head>
    <body>
        <p>Visit the <a href="archives.html">archives</a>.</p>
    </body>
</html>

link元素

分类：

元数据式内容

使用场景：

期望出现元数据式内容处。
在做为head元素孩子的noscript元素内。

内容模型：

空

允许的属性：

全局属性
href
rel
media
hreflang
type
sizes
此外，title属性在此元素上具有特别语义。

DOM接口：

interface HTMLLinkElement : HTMLElement {
    attribute boolean disabled;
    attribute DOMString href;
    attribute DOMString rel;
    readonly attribute DOMTokenList relList;
    attribute DOMString media;
    attribute DOMString hreflang;
    attribute DOMString type;
    [PutForwards=value] readonly attribute DOMSettableTokenList sizes;
};
HTMLLinkElement implements LinkStyle;

link元素允许使用者将他们的文档链接到其它资源。

link的目标由href属性指定，它的值必须表示并且包含一个有效非空的URL（允许前后有空格）。如果没有href属性，那么这个元素则没有定义一个链接。

link元素必须有rel属性。

link表示的类型由rel属性的值给出，这个值如果存在的话，则应该由一组空格分开的token组成。后文将会描述允许的关键字以及它们的意义。如果rel属性不存在、没有关键字或者没有任何一个关键字根据此文档是被允许的，那么元素不会创建任何链接。

使用link元素，可以创建两个类型的链接：到外部资源的链接和超链接。链接类型一节定义了一个指定的链接究竟是一个外部资源还是超链接。一个链接元素可以创建多个链接（其中可能某些是外部资源，某些是超链接）。具体创建多少个、哪一种链接取决于rek属性给出的关键字。用户代理必须逐个链接来处理，不能逐个元素处理。

具体的到外部资源的链接的行为取决于具体的关系,由相关链接类型来定义。一些属性控制外部资源发生作用与否（如下文定义）。

对于那些能够在DOM中表示的外部资源（比如，样式表），即使资源没有发生作用，DOM表示也应该生效。

用户代理应该采用以下步骤获取一个资源：

1. 如果href属性的值是空字符串，取消这些步骤
2. 解析href属性给出的URL相对路径
3. 如果前面步骤失败，中断这些步骤
4. 获取结果的绝对URL地址

用户代理可以选择当需要时尝试去获取这些资源，而不是在它们发生作用前主动获取所有的外部资源。

获取资源是应当遵循所使用的协议(如 HTTP)的语义。（例如重定向应该生效，404响应结果应该导致外部资源无法生效）

在尝试获取资源及其关键子资源完成时，如果加载成功，用户代理应该将以下任务排入隊列：在link元素上触发一个名为load的简单事件，如果资源或者它的一个关键子资源因为任何原因没能完全加载（如DNS错误，HTTP 404响应，链接过早断开，不支持的Content-Type），将以下任务排入隊列：在link元素上触发一个名为error的简单事件，处理资源及子资源时的非网络的错误（如CSS解析错误、PNG解码错误）不在本段描述的错误之列。

这些任务的task source是DOM manipulation task source

元素必须延迟元素的document的load事件至所有获取资源及其关键子资源的尝试完成。（用户代理没有尝试获取的资源，如等待需要时加载的资源，不会延迟load事件。）

交互式的用户代理可能在他们的界面上提供给用户一些触发由link元素创建的超链接的方法。本标准没有确切地规定用户界面，但是可以以某种形式（可能是比较简单的），对于每个由link元素创建的超链接给出以下信息（由元素属性获得）：

• 文档和资源之间的关系（由rel属性给出）
• 资源的标题（由title属性给出）
• 资源的地址（由href属性给出）
• 资源的语言（由hreflang属性给出）
• 资源的适合媒体（由media属性给出）

用户代理也可以包含其它信息，比如资源的类型（由type属性给出）。

media属性说明了资源作用于何种媒体，它的值必须是合法的媒体查询。

如果链接是超链接，那么media属性纯是建议，描述了问题中的文档为何种媒体设计。

然而，如果链接是外部资源链接的话，media属性就是规定，用户代理仅当media属性匹配环境并且其它相关条件满足时才会使资源生效，其它情况下不会生效。

如果media属性被省略，则默认为"all"，意即链接默认作用于所有媒体类型。

link元素的hreflang属性跟a与area元素的link元素有语义完全相同。

对于外部资源链接，type属性用于提示用户代理，以使它们避免获取不支持的资源。如果这个属性被设置，那么用户代理必须确认资源就是给出的类型（即使它不是一个合法的MIME类型，如空字符串）。如果属性被省略，但是外部资源链接类型有定义默认类型，用户代理也必须确认资源就是这个的类型。如果用户代理不支持指定链接关系的指定MIME类型，则用户代理不应该获取这个资源。如果用户代理支持指定链接关系的指定MIME类型，则用户代理应该按照外部资源链接的特定类型所指定，在适当的时候获取资源。如果属性被忽略并且外部资源链接类型没有默认类型，但如果资源的类型是已知的并且支持的，用户代理还是应该当作它能够被支持并获取资源。

如果外部资源链接类型定义了处理资源的内容类型元数据的规则，这些规则应生效。否则，假如资源预计是图片，用户代理可以使用图片探测规则，with the official type being the type determined from the resource's Content-Type metadata，并且把探测资源得出的结果当作它时实际类型。否则，如果所有条件都不生效或者如果用户代理选择不去使用图片探测规则，那么用户代理必须使用内容类型元数据去检查资源的类型，如果没有类型元信息，但是外部资源链接类型有定义默认类型，那么用户代理需要确认资源就是这个类型。

用户代理一经确认资源的类型，如果它是支持的类型并且其它有关条件满足，用户代理必须使资源生效，其它情况则应忽略资源。

<link rel="stylesheet" href="A" type="text/plain">
<link rel="stylesheet" href="B" type="text/css">
<link rel="stylesheet" href="C">

title属性给出了链接的标题。只有一个例外，它纯是建议。它的值为text。例外就是对于样式表链接，这里的title属性定义了可选得样式表集合。

sizes属性与icon这一link类型一起使用。这个属性不能被rel中没有指定icon关键字的link元素使用。

HTTP link:如果支持的话，header必须被认为出现在任何链接之前，这样的话他们就由HTTP实体header给出。（在这些header中的URL将会被根据相关文档的规则被处理和解析，本文档不包含这些规则。[HTTP] [WEBLINK]）

IDL属性href, rel, media, hreflang, 以及type, 以及sizes，每一个都将反射各自同名的内容属性。

IDL属性relList应反射rel内容属性。

IDL属性disabled只做用于样式表链接。当link元素定义了一个样式表链接时，disabled属性跟为可选择样式表DOM定义的表现相同。对所有其它的link元素它总是返回false，并且设置时不做任何事情。

LinkStyle接口也被这个元素实现了，样式处理模型定义了方式。[CSSOM]

<!-- a persistent style sheet -->
<link rel="stylesheet" href="default.css">

<!-- the preferred alternate style sheet -->
<link rel="stylesheet" href="green.css" title="Green styles">

<!-- some alternate style sheets -->
<link rel="alternate stylesheet" href="contrast.css" title="High contrast">
<link rel="alternate stylesheet" href="big.css" title="Big fonts">
<link rel="alternate stylesheet" href="wide.css" title="Wide screen">

<link rel=alternate href="/en/html" hreflang=en type=text/html title="English HTML">
<link rel=alternate href="/fr/html" hreflang=fr type=text/html title="French HTML">
<link rel=alternate href="/en/html/print" hreflang=en type=text/html media=print title="English HTML (for printing)">
<link rel=alternate href="/fr/html/print" hreflang=fr type=text/html media=print title="French HTML (for printing)">
<link rel=alternate href="/en/pdf" hreflang=en type=application/pdf title="English PDF">
<link rel=alternate href="/fr/pdf" hreflang=fr type=application/pdf title="French PDF">

meta元素

分类：

元数据式内容

使用场景：

如果有charset属性出现，或者如果元素的http-equiv属性在编码声明状态：在一个head元素里。
如果元素具有http-equiv属性并且不在在编码声明状态：在一个head元素里。
如果元素具有http-equiv属性并且不在在编码声明状态：在一个做为head元素子节点的noscript元素里。
如果name属性出现：任何期望出现元数据式内容的位置

内容模型：

空

允许的属性：

全局属性
name
http-equiv
content
charset

DOM接口：

interface HTMLMetaElement : HTMLElement {
    attribute DOMString name;
    attribute DOMString httpEquiv;
    attribute DOMString content;
};

style元素

分类：

元数据式内容
如果具有scoped属性: 流式内容

使用场景：

如果元素不具有scoped属性：在一个head元素里。
如果元素不具有scoped属性：在一个做为head元素子节点的noscript元素里。
如果元素具有scoped属性：在期望流式内容处，但必须出现在所有除style元素或者元素内空格以外的流式内容之前。

内容模型：

空

允许的属性：

全局属性
media
scoped
type
此外，title属性在此元素上有特殊语意

DOM接口：

interface HTMLStyleElement : HTMLElement {
    attribute boolean disabled;
    attribute DOMString media;
    attribute DOMString type;
    attribute boolean scoped;
};
HTMLStyleElement implements LinkStyle;

样式

脚本

script元素

分类：

元数据式内容
流式内容
段落式内容

使用场景：

在期望元数据式内容处。
在期望段落式内容处。

内容模型：

如果没有src属性，取决于type属性，但必须符合脚本内容限制。
如果有src属性，元素必须为空或者只包含脚本文档，同样必须符合脚本内容限制。

允许的属性：

全局属性
src
async
defer
type
charset

DOM接口：

interface HTMLScriptElement : HTMLElement {
    attribute DOMString src;
    attribute boolean async;
    attribute boolean defer;
    attribute DOMString type;
    attribute DOMString charset;
    attribute DOMString text;
};

脚本语言

script元素内容的限制

外部脚本的内联文档

script元素和XSLT的交互

noscript元素

分类：

元数据式内容
流式内容
段落式内容

使用场景：

在一个HTML文档的head元素中，祖先不能有noscript元素。
在一个HTML文档中期望出现段落式内容处，祖先不能有noscript元素。

内容模型：

在脚本被禁用状态下，在head元素中：以任意顺序出现零个或多个的link元素，零个或多个的style元素，零个或多个的meta元素。
在脚本被禁用状态下，不在head元素中：noscript元素对子元素是透明的，但不准有noscript元素。
其它情况：如下文描述的文本。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

区块

body元素

分类：

区块根

使用场景：

做为html元素内的第二个元素。

内容模型：

流式内容

允许的属性：

全局属性
onafterprint
onbeforeprint
onbeforeunload
onblur
onerror
onfocus
onhashchange
onload
onmessage
onoffline
ononline
onpagehide
onpageshow
onpopstate
onredo
onresize
onscroll
onstorage
onundo
onunload

DOM接口：

interface HTMLBodyElement : HTMLElement {
    attribute Function onafterprint;
    attribute Function onbeforeprint;
    attribute Function onbeforeunload;
    attribute Function onblur;
    attribute Function onerror;
    attribute Function onfocus;
    attribute Function onhashchange;
    attribute Function onload;
    attribute Function onmessage;
    attribute Function onoffline;
    attribute Function ononline;
    attribute Function onpopstate;
    attribute Function onpagehide;
    attribute Function onpageshow;
    attribute Function onredo;
    attribute Function onresize;
    attribute Function onscroll;
    attribute Function onstorage;
    attribute Function onundo;
    attribute Function onunload;
};

section元素

分类：

流式内容
章节式内容
formatBlock候选

使用场景：

在期望流式内容处。

内容模型：

流式内容

允许的属性：

全局属性

DOM接口：

使用HTMLElement

nav元素

分类：

流式内容。
章节式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

流式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

article元素

分类：

流式内容。
章节式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

流式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

aside元素

分类：

流式内容。
章节式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

流式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

h1,h2,h3,h4,h5和h6元素

分类：

流式内容。
标题式内容。
formatBlock候选。

使用场景：

做为hgroup元素的子元素。
需要流式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

interface HTMLHeadingElement : HTMLElement {};

hgroup元素

分类：

流式内容。
标题式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

一个或多个h1,h2,h3,h4,h5和/或h6元素。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

header元素

分类：

流式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

流式内容, 但不能有header元素或footer元素出现。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

footer元素

分类：

流式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

流式内容, 但不能有header元素或footer元素出现。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

address元素

分类：

流式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

流式内容, 不能有标题式内容出现, 不能有章节式内容出现, 不能有header元素, footer元素或者address元素出现。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

头和区块

内容分组

p元素

分类：

流式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

interface HTMLParagraphElement : HTMLElement {};

hr元素

分类：

流式内容。

使用场景：

需要流式内容处。

内容模型：

空。

允许的属性：

全局属性

DOM接口：

interface HTMLHRElement : HTMLElement {};

pre元素

分类：

流式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

interface HTMLPreElement : HTMLElement {};

blockquote元素

分类：

流式内容。
Sectioning root。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

流式内容。

允许的属性：

全局属性
cite

DOM接口：

interface HTMLQuoteElement : HTMLElement {
    attribute DOMString cite;
};

注：HTMLQuoteElement接口同时也被q元素使用

ol元素

分类：

流式内容。

使用场景：

需要流式内容处。

内容模型：

零个或多个li元素。

允许的属性：

全局属性
reversed
start
type

DOM接口：

interface HTMLOListElement : HTMLElement {
    attribute boolean reversed;
    attribute long start;
    attribute DOMString type;
};

ul元素

分类：

流式内容。

使用场景：

需要流式内容处。

内容模型：

零个或多个li元素。

允许的属性：

全局属性

DOM接口：

interface HTMLUListElement : HTMLElement {};

li元素

分类：

无。

使用场景：

在ol元素中。
在ul元素中。
在menu元素中。

内容模型：

流式内容。

允许的属性：

全局属性
如果元素是ol元素的子节点: value

DOM接口：

interface HTMLLIElement : HTMLElement {
    attribute long value;
};

dl元素

分类：

流式内容。

使用场景：

需要流式内容处。

内容模型：

零或者多组由一个或多个dt元素后跟零个或多个dd元素组成的元素组。

允许的属性：

全局属性

DOM接口：

interface HTMLDListElement : HTMLElement {};

dt元素

分类：

无。

使用场景：

在dl元素中，dd元素或dt元素之前。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

dd元素

分类：

无。

使用场景：

在dl元素中，dt元素或dd元素之后。

内容模型：

流式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

figure元素

分类：

流式内容。
Sectioning root。

使用场景：

需要流式内容处。

内容模型：

可能是: 一个figcaption元素后跟流式内容。
或者: 流式内容后跟一个figcaption元素。
或者: 流式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

figcaption元素

分类：

无。

使用场景：

做为figure元素的第一个或者最后一个子节点。

内容模型：

流式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

div元素

分类：

流式内容。
formatBlock候选。

使用场景：

需要流式内容处。

内容模型：

流式内容。

允许的属性：

全局属性

DOM接口：

interface HTMLDivElement : HTMLElement {};

文本级语意

a元素

分类：

流式内容。
当元素只包含段落式内容: 段落式内容。
交互式内容。

使用场景：

当元素只包含段落式内容: 期望出现段落式内容处。
其它情况: 期望出现流式内容处。

内容模型：

透明内容模型,但不能有交互式内容出现。

允许的属性：

全局属性
href
target
rel
media
hreflang
type

DOM接口：

interface HTMLAnchorElement : HTMLElement {
    stringifier attribute DOMString href;
    attribute DOMString target;
    attribute DOMString rel;
    readonly attribute DOMTokenList relList;
    attribute DOMString media;
    attribute DOMString hreflang;
    attribute DOMString type;

    attribute DOMString text;

    // URL decomposition IDL attributes
    attribute DOMString protocol;
    attribute DOMString host;
    attribute DOMString hostname;
    attribute DOMString port;
    attribute DOMString pathname;
    attribute DOMString search;
    attribute DOMString hash;
};

em元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

strong元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

small元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

s元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

cite元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

q元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性
cite

DOM接口：

使用HTMLQuoteElement。

dfn元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容, 但不能有dfn元素出现。

允许的属性：

全局属性
此外, 此元素的title属性有特别语义。

DOM接口：

使用HTMLElement。

abbr元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性
此外，此元素的title属性有特别语义。

DOM接口：

使用HTMLElement。

time元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容, 但不能有time元素出现。

允许的属性：

全局属性
datetime
pubdate

DOM接口：

interface HTMLTimeElement : HTMLElement {
    attribute DOMString dateTime;
    attribute boolean pubDate;
    readonly attribute Date valueAsDate;
};

code元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

var元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

samp元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

kbd元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

sub和sup元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

i元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

b元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

u元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

mark元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

ruby元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

一或者多组以下元素: 段落式内容后跟一个rt元素或者一个rp元素, 一个rt元素, 以及另一个rp元素。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

rt元素

分类：

无。

使用场景：

做为ruby元素的子元素。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

rp元素

分类：

无。

使用场景：

做为ruby元素的子元素，或者在一个rt元素之前。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

bdi元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性
此外，dir全局属性在此元素上有特殊语义。

DOM接口：

使用HTMLElement。

bdo元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性
此外，dir全局属性在此元素上有特殊语义。

DOM接口：

使用HTMLElement。

span元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

段落式内容。

允许的属性：

全局属性

DOM接口：

interface HTMLSpanElement : HTMLElement {};

br元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

空。

允许的属性：

全局属性

DOM接口：

interface HTMLBRElement : HTMLElement {};

wbr元素

分类：

流式内容。
段落式内容。

使用场景：

需要段落式内容处。

内容模型：

空。

允许的属性：

全局属性

DOM接口：

使用HTMLElement。

使用方式小结

本章节不具有规范性。

更改记录

ins元素

分类：

流式内容。
当元素只包含段落式内容:段落式内容。

使用场景：

当元素只包含段落式内容: 期望出现段落式内容处。
其它情况: 期望出现流式内容处。

内容模型：

透明内容模型

允许的属性：

全局属性
cite
datetime

DOM接口：

使用HTMLModElement。

del元素

分类：

流式内容。
当元素仅包含段落式内容: 段落式内容。

使用场景：

当元素仅包含段落式内容: 期望出现段落式内容处。
其它情况: 期望出现流式内容处。

内容模型：

透明内容模型

允许的属性：

全局属性
cite
datetime

DOM接口：

使用HTMLModElement。

ins和del元素的通用属性

更改记录与段落

更改记录与列表

嵌入内容

img元素

分类：

流式内容。
段落式内容。
嵌入式内容。
如果元素有一个usemap属性: 交互式内容。

使用场景：

需要嵌入式内容处。

内容模型：

空。

允许的属性：

全局属性
alt
src
usemap
ismap
width
height

DOM接口：

[NamedConstructor=Image(),
NamedConstructor=Image(in unsigned long width),
NamedConstructor=Image(in unsigned long width, in unsigned long height)]
interface HTMLImageElement : HTMLElement {
    attribute DOMString alt;
    attribute DOMString src;
    attribute DOMString useMap;
    attribute boolean isMap;
    attribute unsigned long width;
    attribute unsigned long height;
    readonly attribute unsigned long naturalWidth;
    readonly attribute unsigned long naturalHeight;
    readonly attribute boolean complete;
};

iframe元素

分类：

流式内容。
段落式内容。
嵌入式内容。
交互式内容。

使用场景：

需要嵌入式内容处。

内容模型：

符合要求的文本。

允许的属性：

全局属性
src
srcdoc
name
sandbox
seamless
width
height

DOM接口：

interface HTMLIFrameElement : HTMLElement {
    attribute DOMString src;
    attribute DOMString srcdoc;
    attribute DOMString name;
    [PutForwards=value] readonly attribute DOMSettableTokenList sandbox;
    attribute boolean seamless;
    attribute DOMString width;
    attribute DOMString height;
    readonly attribute Document contentDocument;
    readonly attribute WindowProxy contentWindow;
};

embed元素

分类：

流式内容。
段落式内容。
嵌入式内容。
交互式内容。

使用场景：

需要嵌入式内容处。

内容模型：

空。

允许的属性：

全局属性
src
type
width
height
任何其它没有命名空间的属性(见下文)。

DOM接口：

interface HTMLEmbedElement : HTMLElement {
    attribute DOMString src;
    attribute DOMString type;
    attribute DOMString width;
    attribute DOMString height;
};
根据embed元素嵌入的内容不同，此节点可能支持其它接口。

object元素

分类：

流式内容。
段落式内容。
嵌入式内容。
如果元素有usemap属性：交互式内容。
列表元素, 可提交元素, 表单支持元素。

使用场景：

需要嵌入式内容处。

内容模型：

零个或多个param元素, 之后为透明内容模型。

允许的属性：

全局属性
data
type
name
usemap
form
width
height

DOM接口：

interface HTMLObjectElement : HTMLElement {
    attribute DOMString data;
    attribute DOMString type;
    attribute DOMString name;
    attribute DOMString useMap;
    readonly attribute HTMLFormElement form;
    attribute DOMString width;
    attribute DOMString height;
    readonly attribute Document contentDocument;
    readonly attribute WindowProxy contentWindow;

    readonly attribute boolean willValidate;
    readonly attribute ValidityState validity;
    readonly attribute DOMString validationMessage;
    boolean checkValidity();
    void setCustomValidity(in DOMString error);
};

param元素

分类：

无

使用场景：

在流式内容前作为object元素的孩子。

内容模型：

空。

允许的属性：

全局属性
name
value

DOM接口：

interface HTMLParamElement : HTMLElement {
    attribute DOMString name;
    attribute DOMString value;
};

video元素

audio元素

source元素

track元素

多媒体元素

canvas元素

canvas元素提供了一些与分辨率相关的位图画布处理脚本，可用于即时渲染图形、游戏图形或其他可视化图像。

如果有更适合使用的元素，创作者不应该在文档中使用canvas元素。例如，不适合使用canvas 元素来渲染一个页面标题：如果想要给标题增加图形化表现效果，那么应该先使用一些适合的元素（一般是h1），然后再使用CSS及支撑技术（如XBL）添加样式。

当创作者使用canvas 元素时，他们还必须提供一些内容，在向用户展示时它们与位图画布表达具有功能或用途。这些内容可能作为canvas 元素的内容。canvas 元素的内容（如果有）是指元素的回退内容（fallback content）。

在交互式可视化媒体中，如果启用了canvas 元素的脚本支持，而且还启用了canvas 元素的支持，那么canvas 元素表示由动态生成的图像构成的嵌入式内容。

在非交互式的静态可视化媒体中，如果canvas 元素之前已经绘制好（例如，如果页面已经在一个交互式可视化媒体中查看，现在已经打印，或者在页面布局过程中运行的脚本在该元素上绘图），那么canvas 元素会以当前图像和尺寸来表示嵌入的内容。否则，这个元素会转而显示它的回退内容。

在非可视化媒体以及禁用了canvas 元素脚本或者禁用canvas 元素支持的可视化媒体中，canvas 元素会转而显示它的回退内容。

当一个canvas元素展示嵌入的内容时，用户仍然可以聚焦（focus）canvas元素的起源内容（即回退内容）。当聚集于一个元素时，它就成为键盘交互事件的执行目标（即使元素本身是不可见的）。这使创作者能够实现利用键盘访问的交互canvas：创作者可以将交互式区域一一映射到回退内容中可聚焦的元素中。（聚集对鼠标交互事件没有影响。） [DOMEVENTS]

canvas 元素有两个控制坐标空间尺寸的属性：width 和height。这些属性的值必须是有效的非负整数。必须使用解析非负整数的规则的来获得它们的数字值。如果缺少一个属性，或者解析值时返回错误，那么它会使用默认值替代。width 属性的默认值是300，而height 属性默认值是150。

canvas 元素的实际尺寸与坐标空间尺寸相同，其数值是按CSS像素解析的。然而，元素的尺寸可以通过样式表进行任意设置。在渲染过程中，图像会进行缩放，以适应布局尺寸。

坐标空间的尺寸并不一定表示用户代理在内部或渲染时使用的实际位图尺寸。例如，在一些高清显示器中，用户代理可能在内部使用两个设备像素表示一个坐标空间单位的位图，这样渲染结果就会保证具有较高的质量。

在创建canvas 元素时，无论后面width 和height 属性被设置为什么值（修改为新值或者之前的值），位图及所有相关上下文都必须清除为初始状态，然后使用最新指定的坐标空间尺寸重新初始化。

当canvas初始化时，它的位图必须清除为透明黑色。

width 和height IDL属性必须反映具有相同名称的相应内容属性（具有相同默认值）。

下面的例子只画出一个正方形：

代码...

context = canvas.getContext(contextId [, ... ])

返回一个对象，它包含在canvas上绘图的API。第一个参数指定希望得到的API。后面是由该API处理的参数。

所定义的上下文清单请参见WHATWG Wiki CanvasContexts页面。[WHATWGWIKI]

如果指定的上下文ID不支持，或者canvas已经初始化为其他（不兼容）类型（例如，在获得一个“webgl”上下文之后再尝试获得一个“2d”上下文），那么它会返回null。

canvas 元素有一个主上下文（primary context），它是该元素获得的第一个上下文。在canvas 元素创建时，它不能拥有主上下文。

最常用的主上下文是HTML Canvas 2D Context。

canvas 元素的getContext(contextId, args...)方法在调用必须执行以下步骤：

1. 方法是第一个参数必须是contextId 。

1. 如果contextId 不是用户代理提供的上下文名称，返回null，退出这些步骤。

说明：有一个例子是，用户代理在理论上是支持“webgl”3D上下文的，但是所在平台并没有OpenGL硬件支持，而且用户代理不包含OpenGL软件实现。尽管用户代理能够识别“webgl”名称，但是在这一步它会返回null，因为这个调用实际上不支持这种上下文。

1. 如果该元素拥有一个主上下文，而WHATWG Wiki CanvasContexts页面的上下文条目中不包含兼容上下文的contextId ，那么返回null，退出这些步骤。[WHATWGWIKI]

1. 如果这个元素没有主上下文，那么将该元素的主上下文指定为contextId。

1. 如果这个元素已经调用 getContext()方法处理过同一个contextId，那么返回上次调用得到的同一个对象，退出这些步骤。其他参数忽略。

1. 返回一个用contextId创建的新对象，具体类型按照 WHATWG Wiki CanvasContexts页面所列的contextId条目的规定。[WHATWGWIKI]

WHATWG Wiki CanvasContexts页面可能会注册新的上下文类型。[WHATWGWIKI]

任何人在任何时候都可以自由编辑WHATWG Wiki CanvasContexts页面，添加新的上下文类型。这些新的上下文类型必须指定以下信息：

关键词

返回新API定义的对象的contextID 值。

规范

指向上下文类型API正式规范的链接。它可能是Wiki上的另一个页面，或者一个外部页面的链接。如果这个类型没有正式的规范，那么可以先用一个非正式描述替代，直到正式的规范发布。

兼容性

兼容此上下文的上下文类型清单（例如，运行在相同的底层位图上）。这个清单必须是可传递且对称的；如果定义的一个上下文类型与其他类型兼容，那么它兼容的所有类型都必须与这个类型所兼容的全部类型相兼容。

供应商还可能使用“供应商名-上下文”的语法来定义实验性上下文，例如，moz-3d。这些上下文应该在WHATWG Wiki CanvasContexts页面注册。

url = canvas.toDataURL( [ type, ... ])

返回一个表示Canvas中图像的data: URL。

第一个参数（如果有），控制返回图像的类型（例如，PNG或JPEG）。默认值是image/png；如果指定类型不支持，那么也会使用这个默认类型。其他参数与这个具体类型相关，用来控制图像的生成方式，如下表所示。

如果要使用非“image/png”的类型，那么创作者可以通过检查返回的字符串是否由“data:image/png,”或“data:image/png;”开头，以此检查图像是否确定为所要求的格式。如果是，那么图像格式是PNG，因此请求的类型是不支持的。（唯一例外的情况是当canvas没有设置高度或宽度的时候，得到的应该只有“data:,”。）

canvas.toBlob(callback [, type, ... ])

创建一个Blob对象，表示一个包含Canvas图像的文件，并使用该对象的引用调用一个回调函数。

第二个参数（如果有），控制所返回图像的类型（例如，PNG或JPEG）。默认值是image/png；如果指定类型不支持，就使用默认值。其他参数与这个类型相关，用来控制图像的生成方式，如下表所示。

toDataURL()方法必须执行以下步骤：

1. 如果Canvas没有像素（例如，水平尺寸或垂直尺寸为0），那么返回字符串“data:,”，然后退出这些步骤。（这是最短的data: URL；它表示text/plain资源中的空字符串。）

1. 使file成为图像序列化的文件，使用方法的参数（如果有）作为参数。

1. 返回一个表示file的data: URL。[RFC2397]

toBlob()方法必须执行以下步骤：

1. 在第一个参数中传入回调函数（callback ）。

1. 在第二个参数中传入arguments ，如果它有参数，在后面添加它的参数。

1. 使用arguments传入表示图像序列化文件file 。

1. 返回，但是继续以异步方式执行这些步骤。

1. 如果callback 为null，那么退出这些步骤。

1. 将一个任务排队，使用一个表示文件的Blob对象作为参数，调用FileCallback回调函数。

当用户代理选择一些特定参数将图像序列化为文件，那么它会按第一个参数值指定的格式创建一个图像文件，或者在未指定参数的情况下使用PNG格式。[PNG]

如果 arguments 不为空，那么第一个值必须解释为一个MIME类型，以指定使用的格式。如果类型包含任何参数，那么它必须当作未提供进行处理。

例如，“image/png”表示要生成一个PNG图像，“image/jpeg”则表示要生成一个JPEG图像，而“image/svg+xml”表示要生成一个SVG图像（这很可能要求实现技术实际上保存足够的信息，才能够确保从canvas渲染一个SVG图像）。

用户代理必须支持PNG（“image/png”）。用户代理可能支持其他类型。如果用户代理不支持所请求的类型，那么它必须使用PNG格式创建这个文件。[PNG]

如果用户代理支持这种类型，那么它必须在创建之前将所提供的类型转换为ASCII小写字母。

对于不支持透明度通道的图像类型，序列化的图像必须使用source-over 操作将canvas图像组合到一个实黑色背景上。

如果arguments中的第一个参数指定的类型属于下表第一列所指定的类型之一，而且用户代理支持这种类型，那么后续参数（如果有）必须按照表中该行的第二列所述方式进行处理。

根据这些规则，如果一个参数可以按照在Web IDL规范中处理any类型参数的方式转换为一个IDL双精度浮点数，那么这个参数就是一个数字。[WEBIDL]

其他参数必须忽略，而且一定不能引起用户代理抛出异常。这个规范的后续版本将可能定义这些方法的其他参数，使创作者能够更小心地控制压缩设置、图像元数据等。

颜色空间和颜色校正

canvas元素安全性

如果一个原点的脚本可以访问另一个原点（不在同一个原点）的图像信息（例如，读取像素），那么就可能发生信息泄漏。

为了避免这个问题，canvas元素定义了一个标记，用来表示它们是否为干净原点（origin-clean）。所有canvas元素都必须先将它们的origin-clean 设置为true。如果发生以下情况，那么这个标记必须设置为false:

• 调用元素的2D上下文的drawImage()方法处理一个原点与canvas元素所在Document对象不同的HTMLImageElement 或HTMLVideoElement。

• 调用元素的2D上下文的drawImage()方法处理一个origin-clean 标记为false的HTMLCanvasElement。

• 元素的2D上下文的 fillStyle属性设置为一个 CanvasPattern对象，而它由一个在模式创建时原点与canvas元素所在Document对象不同的HTMLImageElement 或HTMLVideoElement 创建。

• 元素的2D上下文的fillStyle属性被设置为一个CanvasPattern对象，而它由一个在模式创建时origin-clean 标记为false的HTMLCanvasElement 创建。

• 元素的2D上下文的strokeStyle 属性被设置为一个CanvasPattern对象，而它由一个在模式创建时与canvas元素所在Document对象不同HTMLImageElement的HTMLVideoElement或创建。

• 元素的2D上下文的strokeStyle属性被设置为一个CanvasPattern对象，而它由一个在模式创建时origin-clean 标记为false的HTMLCanvasElement 创建。

• 使用一个原点与canvas元素所在Document对象不同的字体来调用元素的2D上下文的fillText()或strokeText()方法。（这种字体甚至不一定已经使用；问题关键在于这种字体是否被认为是一种字形图。）

如果canvas元素的origin-clean 标记为false，那么任何时候调用它的toDataURL()方法都会抛出一个SECURITY_ERR 异常。

如果canvas元素的origin-clean 标记为false，那么任何时候调用2D上下文getImageData()方法都会抛出一个SECURITY_ERR 异常。

如果canvas元素最终使用一种原点与canvas元素所在Document对象不同的字体，那么任何时候调用2D上下文的measureText()方法都会抛出一个SECURITY_ERR 异常。

注意：即使通过修改width 或height 属性来重置canvas，它的标记也不会重置。

map元素

area元素

图像映射

MathML

SVG

尺寸属性

表格数据

table元素

描述表格的技术

表格布局的技术

caption元素

colgroup元素

col元素

tbody元素

thead元素

tfoot元素

tr元素

td元素

th元素

td和th元素的通用属性

处理模型

示例

表单

介紹

分類

本章節的各個元素在分類上除了屬於通常的流式內容、章節式內容與互動內容以外，還屬於不同但有交集（卻有細微差異）的多個分類。

有不少元素是表單連結元素，也就是有主表單、存取主表單用的內容屬性 form 與對應的 IDL 屬性 form。

表單連結元素又分為以下幾個子分類：

被列元素

是指 form.elements 與 fieldset.elements API 會列出的元素。

可標元素

是指可與 label 元素連結的元素。

可提交元素

是指當使用者提交 form 元素的時候，建構表單資料集用到的元素。

可重設元素

是指 form 元素重置時會影響到的元素。

另外，可提交元素根據擁有的屬性可能是按鈕。後面說明元素是按鈕的條件。有些按鈕還是提交按鈕。

form元素

fieldset元素

legend元素

label元素

input元素

type 屬性的狀態

input 元素的共通屬性

每個 input 元素的 type 屬性的狀態的定義決定了以下哪些屬性適用於這個元素。當某個一個屬性不適用於某個 input 元素時，使用者代理必須忽視該屬性，此時以下對於的該屬性的要求與定義皆不適用。

autocomplete 屬性

部分使用者代理有幫助使用者填寫表單的功能，舉例來說，預先幫使用者填上之前輸入過的地址。

autocompelte 屬性是一個列舉屬性，他有三個狀態：對應到關鍵字 on 的開啟狀態、對應到關鍵字 off 的關閉狀態、不指定屬性時的失蹤預設值是預設狀態。

關閉狀態代表控制項的輸入特別重要（例如核武的啓動代碼），或者輸入絕不可重復使用（例如銀行登入的一次性鑰匙）因此使用者必須每次輸入，而不可讓使用者代理預先填寫，又或網頁提供自己的自動完成機制而不需要使用者代理提供的自動完成值。

相反的，開啟狀態代表這個值不是特別重要，使用者可以讓他的使用者代理記憶他在那個控制項輸入的值。

預設狀態代表使用者會用該元素的主表單上的 autocomplete 屬性。（form 元素的 autocomplete 屬性預設處於開啟狀態。）

每一個 input 元素都有一個自動完成狀態結果，是開啟或關閉兩者其一。

當 input 元素處於以下任一種情況時，input 元素的自動完成狀態結果為開啟，否則 input 元素的自動完成狀態結果為關閉。

• autocomplete 屬性處於開啟狀態。
• autocomplete 屬性處於預設狀態，且此元素沒有主表單。
• autocomplete 屬性處於預設狀態，且此元素主表單的 autocomplete 屬性處於開啟狀態。

當一個 input 元素的自動完成狀態結果為開啟，使用者代理可以庫存使用者輸入的值以作為表單預先填寫之用，以期未來使用者返回同樣頁面。否則，使用者不應該記憶控制項的取值，也不應該提供使用者過去輸入的值。

另外，若自動完成狀態結果為關閉 ，當瀏覽器穿越歷史時會重設取值。

使用者代理必須將自動完成當成使用者對元素取值的更改，且自動完成必須發生在元素處於可變狀態的時候（例如，元素剛進入文件的時候，或者使用者代理停止解析的時候）。

<p><label>帳戶：<input type="text" name="ac" autocomplete="off"></label></p>
<p><label>PIN：<input type="password" name="pin" autocomplete="off"></label></p>

dirname 屬性

當 dirname 屬性適用於某元素上 時，它是表單控制項 dirname 屬性。

<form action="addcomment.cgi" method=post>
 <p><label>評論：<input type=text name="comment" dirname="comment.dir" required></label></p>
 <p><button name="mode" type=submit value="add">發表評論</button></p>
</form>

comment=Hello&'''comment.dir=ltr'''&mode=add

comment=%D9%85%D8%B1%D8%AD%D8%A8%D9%8B%D8%A7&comment.dir=rtl&mode=add

list 屬性

list 屬性可以用來指定代表預定義的建議選項列表的一個元素。

若網頁作者欲設定此屬性，則它的取值必須是同樣文件裡一個 datalist 元素的 ID。

若文件中以樹排序算的第一個 ID 等同於 list 屬性值的元素是一個 datalist 元素，則該元素為 input 元素的建議來源元素。若未指定 list 屬性，或者沒有擁有該 ID 的元素，又或第一個有該 ID 的元素不是一個 datalist 元素，則 input 元素沒有建議來源元素。

若 input 元素具有建議來源元素，則當使用者代理讓使用者編輯 input 元素的取值時，使用者代理應該視控制項的形態，以適合的方式提供建議來源元素代表的建議選項給使用者。使用者代理可以在適當的時機用建議選項的標籤代表該選項。

使用者選取建議選項後的處理方法視元素是否為僅接受單一取值的控制項，又或元素可以接受數個取值而定。

↪ 若元素不具有 multiple 屬性，或是 multiple 屬性不適用

當使用者選取了一個建議選項，input 元素的取值必須設為選到選項的取值，如同使用者自己輸入的。

↪ 若元素確時有 multiple 屬性，且 multiple 屬性適用

當使用者選取了一個建議選項，使用者代理必須加一份有選到選項的取值的資料到 input 元素的取值組，或者更改 input 元素取值組裡既有的一份資料成為選到選項的取值，如同使用者自己加了一份有該數值的資料，或編輯了一份既有資料成為該值。使用上述兩種行為的那種取決於使用者介面，由使用者代理決定。

若 list 屬性不適用，則 input 元素沒有建議來源元素。

<label>首頁：<input name=hp type=url list=hpurls></label>
<datalist id=hpurls>
 <option value="http://www.google.com/" label="Google">
 <option value="http://www.reddit.com/" label="Reddit">
</datalist>

<p>
 <label>
  輸入一個品種：
  <input type="text" name="breed" list="breeds">
  <datalist id="breeds">
   <option value="阿比西尼亞貓">
   <option value="挪邦貓">
   <!-- ... -->
  </datalist>
 </label>
</p>

<p>
 <label>
  輸入一個品種：
  <input type="text" name="breed" list="breeds">
 </label>
 <datalist id="breeds">
  <label>
   或從列表中選取：
   <select name="breed">
    <option value="">（未選取）
    <option>阿比西尼亞貓
    <option>挪邦貓
    <!-- ... -->
   </select>
  </label>
 </datalist>
</p>

readonly 屬性

readonly 屬性是一個布林屬性，控制使用者能否編輯某個表單控制項。具有此屬性的元素是不可變的。

約束驗證：若一個 input 元素具有 readonly 屬性，不進行這個元素的約束驗證。

<form action="products.cgi" method=post enctype="multipart/form-data">
 <table>
  <tr> <th> 產品 ID <th> 產品名稱 <th> 價格 <th> 操作
  <tr>
   <td> <input readonly name="1.pid" value="H412">
   <td> <input required name="1.pname" value="奧客牌落地燈">
   <td> $<input required type=number min=0 step=0.01 name="1.pprice" value="49.99">
   <td> <button formnovalidate name="action" value="delete:1">刪除</button>
  <tr>
   <td> <input readonly name="2.pid" value="FG28">
   <td> <input required name="2.pname" value="奧客牌桌燈">
   <td> $<input required type=number min=0 step=0.01 name="2.pprice" value="24.99">
   <td> <button formnovalidate name="action" value="delete:2">刪除</button>
  <tr>
   <td> <input required name="3.pid" value="" pattern="[A-Z0-9]+">
   <td> <input required name="3.pname" value="">
   <td> $<input required type=number min=0 step=0.01 name="3.pprice" value="">
   <td> <button formnovalidate name="action" value="delete:3">刪除</button>
 </table>
 <p> <button formnovalidate name="action" value="add">加入</button> </p>
 <p> <button name="action" value="update">除存</button> </p>
</form>

size 屬性

size 屬性可以用來指定在視覺渲染下，用戶代理允許正在編輯此元素取值的使用者看到的字元數。

若網頁作者欲指定 size 屬性，則它的取值必須是大於零的合法非負整數。

若某個元素具有此屬性，使用者代理必須使用非負整數解析規則解析它的取值，且若結果是大於零的數，則使用者代理應該確保使用者可以至少看到那麼多個字元。

IDL 屬性 size 受限於大於零的非負數值，且預設值為 20。

required 屬性

required 屬性 屬性是一個布林屬性。當某個元素具有此屬性，他是必要的。

約束驗證：若一個元素是必要的且它的 IDL 屬性 value 適用且處於數值模式，又它是可變的且取值為空字串，則此元素苦於失蹤。

<h1>創建新帳號</h1>
<form action="/newaccount" method=post
      oninput="up2.setCustomValidity(up2.value != up.value ? '密碼不相符。' : '')">
 <p>
  <label for="username">郵件信箱：</label>
  <input id="username" type=email required name=un>
 <p>
  <label for="password1">密碼：</label>
  <input id="password1" type=password required name=up>
 <p>
  <label for="password2">確認密碼：</label>
  <input id="password2" type=password name=up2>
 <p>
  <input type=submit value="Create account">
</form>

multiple 屬性

multiple 屬性是一個表示使用者代理允不允許使用者輸入超過一個取值的布林屬性。

以下片段是讓電子郵件客戶端的「Cc」欄位處理多個郵件地址的方法。

<label>Cc: <input type=email multiple name=cc></label>

若使用者在他的線下聯絡人資料庫裡有「Arthur Dent」（地址「art@example.net」）與「Adam Josh」（地址「adamjosh@example.net」）兩個朋友，則在使用者輸入了「a」以後，使用者代理可以給使用者建議這兩個郵件。

頁面也可以直接連到網站上的使用者的聯絡人資料庫：

<label>Cc: <input type=email multiple name=cc list=contacts></label>
...
<datalist id="contacts">
 <option value="hedral@damowmow.com">
 <option value="pillar@example.com">
 <option value="astrophy@cute.example">
 <option value="astronomy@science.example.org">
</datalist>

假設使用者已在這個文字欄位輸入了「bob@example.net」並開始輸入第二個郵件以「a」為開頭的郵件地址，使用者代理可以顯示前面提到的兩個朋友跟 datalist 元素裡的「antrophy」與「astronomy」這兩個值。

<label>附件：<input type=file multiple name=att></label>

maxlength 屬性

當 maxlength 屬性適用於某 input 元素上時，它是此元素髒值標記控制的表單控制項 maxlength 屬性。

若一個 input 元素具有最大容許取值長度，則此元素的 value 屬性取值的代碼點長度必須等於或小於它的最大容許取值長度。

有什么新鲜事想告诉大家？<input name=status maxlength=140>

pattern 屬性

pattern 屬性可以用來指定用來檢驗控制項取值或是取值組（元素具有multiple 屬性且它適用）的正規表示。

若網頁作者欲設定此屬性，則屬性質必須與 JavaScript 的 Pattern 產生式匹配。[ECMA262]

若一個 input 元素具有 pattern 屬性，且屬性值可以成功的作為一個停用 gobal、ignoreCase、multiline 標記的 JavaScript 正規表示編譯，則其結果稱之為此元素的編譯後正規表示模式。若元素不具有此屬性，又或屬性取值不能成功編譯，此元素不具有編譯後正規模式。[ECMA262]

約束驗證：若一個元素的取值不為空字串，且元素不具有 multiple 屬性或屬性不適用於 input 元素 type 屬性的當時狀態，且元素具有編譯後正規表示模式但該正則表示不與元素的取值整體匹配，則此元素苦於不匹配模式。