- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 24 Aug 2011 07:56:07 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/markup/html5-spec
In directory hutz:/tmp/cvs-serv31913/html5-spec
Modified Files:
Overview.html acknowledgements.html
apis-in-html-documents.html
association-of-controls-and-forms.html browsers.html
commands.html common-dom-interfaces.html
common-input-element-attributes.html common-microsyntaxes.html
content-models.html dnd.html dom.html editing.html edits.html
elements.html embedded-content-1.html fetching-resources.html
forms.html grouping-content.html history.html iana.html
index.html infrastructure.html interactive-elements.html
introduction.html links.html named-character-references.html
namespaces.html number-state.html obsolete.html offline.html
origin-0.html parsing.html references.html rendering.html
scripting-1.html sections.html semantics.html spec.html
states-of-the-type-attribute.html syntax.html
tabular-data.html text-level-semantics.html
the-button-element.html the-canvas-element.html the-end.html
the-iframe-element.html the-input-element.html
the-map-element.html the-xhtml-syntax.html timers.html
toc-status.html tokenization.html urls.html webappapis.html
Log Message:
various updates to sync to upstream schema
Index: infrastructure.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/infrastructure.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- infrastructure.html 17 Jun 2011 08:49:06 -0000 1.14
+++ infrastructure.html 24 Aug 2011 07:56:04 -0000 1.15
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -392,10 +395,13 @@
elements</dfn>", when used in this specification, refers to any
element in that namespace, and thus refers to both HTML and XHTML
elements.</p><p>Except where otherwise stated, all elements defined or mentioned
- in this specification are in the
- <code>http://www.w3.org/1999/xhtml</code> namespace, and all
- attributes defined or mentioned in this specification have no
- namespace.</p><p>Attribute names are said to be <dfn id="xml-compatible">XML-compatible</dfn> if they
+ in this specification are in the <a href="namespaces.html#html-namespace-0">HTML namespace</a>
+ ("<code>http://www.w3.org/1999/xhtml</code>"), and all attributes
+ defined or mentioned in this specification have no namespace.</p><p>The term <dfn id="element-type">element type</dfn> is used to refer to the class of
+ elements have a given local name and namespace. For example,
+ <code><a href="the-button-element.html#the-button-element">button</a></code> elements are elements with the element type
+ <code><a href="the-button-element.html#the-button-element">button</a></code>, meaning they have the local name "<code title="">button</code>" and (implicitly as defined above) the
+ <a href="namespaces.html#html-namespace-0">HTML namespace</a>.</p><p>Attribute names are said to be <dfn id="xml-compatible">XML-compatible</dfn> if they
match the <a href="http://www.w3.org/TR/REC-xml/#NT-Name"><code title="">Name</code></a> production defined in XML, they contain no
U+003A COLON characters (:), and their first three characters are
not an <a href="#ascii-case-insensitive">ASCII case-insensitive</a> match for the string
@@ -427,7 +433,8 @@
<code>Document</code></a> then that <code><a href="#document">Document</a></code> is
always the <code><a href="#node">Node</a></code>'s <code><a href="#document">Document</a></code>, and the
<code><a href="#node">Node</a></code>'s <code title="dom-Node-ownerDocument"><a href="#dom-node-ownerdocument">ownerDocument</a></code> IDL attribute
- thus always returns that <code><a href="#document">Document</a></code>.</p><p>The term <dfn id="tree-order">tree order</dfn> means a pre-order, depth-first
+ thus always returns that <code><a href="#document">Document</a></code>.</p><p>The <code><a href="#document">Document</a></code> of a content attribute is the
+ <code><a href="#document">Document</a></code> of the attribute's element.</p><p>The term <dfn id="tree-order">tree order</dfn> means a pre-order, depth-first
traversal of DOM nodes involved (through the <code title="dom-Node-parentNode"><a href="#dom-node-parentnode">parentNode</a></code>/<code title="dom-Node-childNodes"><a href="#dom-node-childnodes">childNodes</a></code> relationship).</p><p>When it is stated that some element or attribute is <dfn id="ignore" title="ignore">ignored</dfn>, or treated as some other value, or
handled as if it was something else, this refers only to the
processing of the node after it is in the DOM. <span class="impl">A
@@ -438,12 +445,7 @@
only if its new value is different than its previous value; setting
an attribute to a value it already has does not change it.</p><p>The term <dfn title="">empty</dfn>, when used of an attribute
value, text node, or string, means that the length of the text is
- zero (i.e. not even containing spaces or control characters).</p><p>Nodes can be <dfn id="concept-clone" title="concept-clone">cloned</dfn>, as
- described in the DOM Core specification. For example, the <code title="dom-cloneNode">cloneNode()</code> and <code title="dom-importNode">importNode()</code> methods of the
- <code><a href="#node">Node</a></code> interface both clone nodes, as do a number of
- algorithms in this specification. Certain <a href="#html-elements">HTML elements</a>
- (in particular, <code><a href="the-input-element.html#the-input-element">input</a></code> and <code><a href="scripting-1.html#the-script-element">script</a></code>) apply
- additional requirements on how they are cloned. <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><h4 id="scripting-0"><span class="secno">2.1.4 </span>Scripting</h4><p>The construction "a <code>Foo</code> object", where
+ zero (i.e. not even containing spaces or control characters).</p><h4 id="scripting-0"><span class="secno">2.1.4 </span>Scripting</h4><p>The construction "a <code>Foo</code> object", where
<code>Foo</code> is actually an interface, is sometimes used instead
of the more accurate "an object implementing the interface
<code>Foo</code>".</p><p>An IDL attribute is said to be <dfn title="">getting</dfn> when
@@ -503,7 +505,9 @@
HZ-GB-2312, and variants of ISO-2022, even though it is possible in
these encodings for bytes like 0x70 to be part of longer sequences
that are unrelated to their interpretation as ASCII. It excludes
- such encodings as UTF-7, UTF-16, GSM03.38, and EBCDIC variants.</p><p>The term <dfn id="unicode-character">Unicode character</dfn> is used to mean a <i title="">Unicode scalar value</i> (i.e. any Unicode code point that
+ such encodings as UTF-7, UTF-16, GSM03.38, and EBCDIC variants.</p><p>The term <dfn id="a-utf-16-encoding">a UTF-16 encoding</dfn> refers to any variant of
+ UTF-16: self-describing UTF-16 with a BOM, ambiguous UTF-16 without
+ a BOM, raw UTF-16LE, and raw UTF-16BE. <a href="references.html#refsRFC2781">[RFC2781]</a></p><p>The term <dfn id="unicode-character">Unicode character</dfn> is used to mean a <i title="">Unicode scalar value</i> (i.e. any Unicode code point that
is not a surrogate code point). <a href="references.html#refsUNICODE">[UNICODE]</a></p><h3 id="conformance-requirements"><span class="secno">2.2 </span>Conformance requirements</h3><p>All diagrams, examples, and notes in this specification are
non-normative, as are all sections explicitly marked non-normative.
Everything else in this specification is normative.</p><p>The key words "MUST", "MUST NOT", "REQUIRED", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
@@ -517,6 +521,27 @@
key word ("must", "should", "may", etc) used in introducing the
algorithm.</p>
+ <div class="example">
+
+ <p>For example, were the spec to say:</p>
+
+ <pre>To eat a kiwi, the user must:
+1. Peel the kiwi.
+2. Eat the kiwi flesh.</pre>
+
+ <p>...it would be equivalent to the following:</p>
+
+ <pre>To eat a kiwi:
+1. The user must peel the kiwi.
+2. The user must eat the kiwi flesh.</pre>
+
+ <p>Here the key word is "must".</p>
+
+ <p>The former (imperative) style is generally preferred in this
+ specification for stylistic reasons.</p>
+
+ </div>
+
<p>Conformance requirements phrased as algorithms or specific steps
may be implemented in any manner, so long as the end result is
equivalent. (In particular, the algorithms defined in this
@@ -547,12 +572,6 @@
would imply that documents are not allowed to contain elements named
<code title="">foobar</code>.</p>
- <p class="note">the conformance requirements for documents include
- syntax (the <table> element is conforming as a child of
- <body>, but not as a child ot <title>), and semantics (the
- <table> elements denotes a multi-dimensional data table, not a
- piece of furniture).</p>
-
<p class="note impl">There is no implied relationship between
document conformance requirements and implementation conformance
requirements. User agents are not free to handle non-conformant
@@ -630,10 +649,18 @@
(possibly as a user option) as supporting the suggested default
rendering defined by this specification.</p>
+ <p>This is not required. In particular, even user agents that do
+ implement the suggested default rendering are encouraged to offer
+ settings that override this default to improve the experience for
+ the user, e.g. changing the color contrast, using different focus
+ styles, or otherwise making the experience more accessible and
+ usable to the user.</p>
+
<p>User agents that are designated as supporting the suggested
- default rendering must implement the rules in <a href="rendering.html#rendering">the rendering section</a> that that section
- defines as the behavior that user agents are <em>expected</em> to
- implement.</p>
+ default rendering must, while so designated, implement the rules
+ in <a href="rendering.html#rendering">the rendering section</a> that that
+ section defines as the behavior that user agents are
+ <em>expected</em> to implement.</p>
</dd>
@@ -857,10 +884,10 @@
defined, in this specification, in terms of operations on the DOM.
<a href="references.html#refsDOMCORE">[DOMCORE]</a></p>
- <p>Implementations must support some version of DOM Core and DOM
- Events, because this specification is defined in terms of the DOM,
- and some of the features are defined as extensions to the DOM Core
- interfaces. <a href="references.html#refsDOMCORE">[DOMCORE]</a> <a href="references.html#refsDOMEVENTS">[DOMEVENTS]</a></p>
+ <p>Implementations must support DOM Core and the events defined in
+ DOM Events, because this specification is defined in terms of the
+ DOM, and some of the features are defined as extensions to the DOM
+ Core interfaces. <a href="references.html#refsDOMCORE">[DOMCORE]</a> <a href="references.html#refsDOMEVENTS">[DOMEVENTS]</a></p>
<p>In particular, the following features are defined in the DOM
Core specification: <a href="references.html#refsDOMCORE">[DOMCORE]</a></p>
@@ -879,7 +906,13 @@
<li><dfn id="processinginstruction"><code>ProcessingInstruction</code></dfn> interface</li>
<li><dfn id="text"><code>Text</code></dfn> interface</li>
+ <li><dfn id="htmlcollection"><code>HTMLCollection</code></dfn> interface, and the terms <dfn id="collections">collections</dfn> and <dfn id="represented-by-the-collection">represented by the collection</dfn></li>
+
+ <li><dfn id="domtokenlist"><code>DOMTokenList</code></dfn> interface</li>
+ <li><dfn id="domsettabletokenlist"><code>DOMSettableTokenList</code></dfn> interface</li>
+
<li><dfn id="dom-domimplementation-createdocument" title="dom-DOMImplementation-createDocument"><code>createDocument()</code></dfn> method</li>
+ <li><dfn id="dom-domimplementation-createhtmldocument" title="dom-DOMImplementation-createHTMLDocument"><code>createHTMLDocument()</code></dfn> method</li>
<li><dfn id="dom-document-createelement" title="dom-Document-createElement"><code>createElement()</code></dfn> method</li>
<li><dfn id="dom-document-createelementns" title="dom-Document-createElementNS"><code>createElementNS()</code></dfn> method</li>
<li><dfn id="dom-document-getelementbyid" title="dom-Document-getElementById"><code>getElementById()</code></dfn> method</li>
@@ -893,18 +926,66 @@
<li><dfn id="dom-element-tagname" title="dom-Element-tagName"><code>tagName</code></dfn> attribute</li>
<li><dfn id="textcontent"><code>textContent</code></dfn> attribute</li>
- </ul><p>The following features are defined in the DOM Events
+ <li><dfn id="event"><code>Event</code></dfn> interface</li>
+ <li><dfn id="eventtarget"><code>EventTarget</code></dfn> interface</li>
+ <li>The <dfn id="concept-event-type" title="concept-event-type">type</dfn> of an event</li>
+
+ <li><dfn id="dom-event-target" title="dom-Event-target"><code>target</code></dfn> attribute</li>
+
+ <li>The <dfn id="document-s-character-encoding" title="document's character encoding">character encoding</dfn> and <dfn id="concept-document-media-type" title="concept-document-media-type">media type</dfn> of a <code><a href="#document">Document</a></code></li>
+ <li>The distinction between <dfn id="xml-documents">XML documents</dfn> and <dfn id="html-documents">HTML documents</dfn></li>
+ <li>The terms <dfn id="quirks-mode">quirks mode</dfn>, <dfn id="limited-quirks-mode">limited-quirks mode</dfn>, and <dfn id="no-quirks-mode">no-quirks mode</dfn></li>
+ <li>The algorithm to <dfn id="concept-node-clone" title="concept-node-clone">clone</dfn> a <code><a href="#node">Node</a></code>, and the concept of <dfn id="concept-node-clone-ext" title="concept-node-clone-ext">cloning steps</dfn> used by tat algorithm</li>
+ <li>The concept of <span>base URL change steps</span> and the definition of what happens when an element is <span>affected by a base URL change</span>.</li>
+
+ </ul><p>The following <code><a href="#domexception">DOMException</a></code> codes are defined in
+ the DOM Core specification: <a href="references.html#refsDOMCORE">[DOMCORE]</a></p>
+
+ <ol class="brief"><li value="1"><dfn id="index_size_err"><code>INDEX_SIZE_ERR</code></dfn></li>
+ <li value="2"><dfn id="domstring_size_err"><code>DOMSTRING_SIZE_ERR</code></dfn></li>
+ <li value="3"><dfn id="hierarchy_request_err"><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
+ <li value="4"><dfn id="wrong_document_err"><code>WRONG_DOCUMENT_ERR</code></dfn></li>
+ <li value="5"><dfn id="invalid_character_err"><code>INVALID_CHARACTER_ERR</code></dfn></li>
+ <li value="6"><dfn id="no_data_allowed_err"><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
+ <li value="7"><dfn id="no_modification_allowed_err"><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
+ <li value="8"><dfn id="not_found_err"><code>NOT_FOUND_ERR</code></dfn></li>
+ <li value="9"><dfn id="not_supported_err"><code>NOT_SUPPORTED_ERR</code></dfn></li>
+ <li value="10"><dfn id="inuse_attribute_err"><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
+ <li value="11"><dfn id="invalid_state_err"><code>INVALID_STATE_ERR</code></dfn></li>
+ <li value="12"><dfn id="syntax_err"><code>SYNTAX_ERR</code></dfn></li>
+ <li value="13"><dfn id="invalid_modification_err"><code>INVALID_MODIFICATION_ERR</code></dfn></li>
+ <li value="14"><dfn id="namespace_err"><code>NAMESPACE_ERR</code></dfn></li>
+ <li value="15"><dfn id="invalid_access_err"><code>INVALID_ACCESS_ERR</code></dfn></li>
+ <li value="16"><dfn id="validation_err"><code>VALIDATION_ERR</code></dfn></li>
+ <li value="17"><dfn id="type_mismatch_err"><code>TYPE_MISMATCH_ERR</code></dfn></li>
+ <li value="18"><dfn id="security_err"><code>SECURITY_ERR</code></dfn></li>
+ <li value="19"><dfn id="network_err"><code>NETWORK_ERR</code></dfn></li>
+ <li value="20"><dfn id="abort_err"><code>ABORT_ERR</code></dfn></li>
+ <li value="21"><dfn id="url_mismatch_err"><code>URL_MISMATCH_ERR</code></dfn></li>
+ <li value="22"><dfn id="quota_exceeded_err"><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
+ <li value="23"><dfn id="timeout_err"><code>TIMEOUT_ERR</code></dfn></li>
+ <li value="24"><dfn id="invalid_node_type_err"><code>INVALID_NODE_TYPE_ERR</code></dfn></li>
+ <li value="25"><dfn id="data_clone_err"><code>DATA_CLONE_ERR</code></dfn></li>
+ </ol><p>When this specification requires that a user agent <i>throw</i>
+ or <i>raise</i> an exception named using a code listed above, it
+ means that the user agent is required to create a
+ <code><a href="#domexception">DOMException</a></code> exception object configured to represent
+ the condition with the given code, then handle that object as a
+ thrown exception as defined in the JavaScript specification. <a href="references.html#refsECMA262">[ECMA262]</a></p>
+
+ <p class="example">For example, to <i>throw a
+ <code><a href="#timeout_err">TIMEOUT_ERR</a></code> exception</i>, a user agent would
+ construct a <code><a href="#domexception">DOMException</a></code> object whose code was set to
+ 23 and actually throw that object as an exception.</p>
+
+ <p>The following features are defined in the DOM Events
specification: <a href="references.html#refsDOMEVENTS">[DOMEVENTS]</a></p>
- <ul class="brief"><li><dfn id="event"><code>Event</code></dfn> interface</li>
- <li><dfn id="eventtarget"><code>EventTarget</code></dfn> interface</li>
- <li><dfn id="uievent"><code>UIEvent</code></dfn> interface</li>
+ <ul class="brief"><li><dfn id="uievent"><code>UIEvent</code></dfn> interface</li>
<li><dfn id="mouseevent"><code>MouseEvent</code></dfn> interface</li>
<li><dfn id="event-click" title="event-click"><code>click</code></dfn> event</li>
- <li><dfn id="dom-event-target" title="dom-Event-target"><code>target</code></dfn> attribute</li>
-
</ul></dd>
<dt>File API</dt>
@@ -914,9 +995,9 @@
<p>This specification uses the following interfaces defined in the
File API specification: <a href="references.html#refsFILEAPI">[FILEAPI]</a></p>
- <ul class="brief"><li><dfn id="blob">Blob</dfn></li>
- <li><dfn id="file">File</dfn></li>
- <li><dfn id="filelist">FileList</dfn></li>
+ <ul class="brief"><li><dfn id="blob"><code>Blob</code></dfn></li>
+ <li><dfn id="file"><code>File</code></dfn></li>
+ <li><dfn id="filelist"><code>FileList</code></dfn></li>
</ul></dd>
@@ -929,19 +1010,20 @@
specification. <a href="references.html#refsWEBIDL">[WEBIDL]</a></p>
<p>The terms <dfn id="supported-property-indices">supported property indices</dfn>, <dfn id="supported-property-names">supported
- property names</dfn>, and <dfn id="dfn-read-only-array" title="dfn-read-only-array">read
- only</dfn> (when applied to arrays) are used as defined in the
- WebIDL specification.</p>
+ property names</dfn>, <dfn id="determine-the-value-of-an-indexed-property">determine the value of an indexed
+ property</dfn>, <dfn id="determine-the-value-of-a-named-property">determine the value of a named
+ property</dfn>, <dfn id="platform-array-objects">platform array objects</dfn>, and <dfn id="dfn-read-only-array" title="dfn-read-only-array">read only</dfn> (when applied to
+ arrays) are used as defined in the WebIDL specification.</p>
<p id="float-nan">Except where otherwise specified, if an IDL
attribute that is a floating point number type (<code title="">double</code>) is assigned an Infinity or Not-a-Number
- (NaN) value, a <code><a href="common-dom-interfaces.html#not_supported_err">NOT_SUPPORTED_ERR</a></code> exception must be
+ (NaN) value, a <code><a href="#not_supported_err">NOT_SUPPORTED_ERR</a></code> exception must be
raised.</p>
<p>Except where otherwise specified, if a method with an argument
that is a floating point number type (<code title="">double</code>)
is passed an Infinity or Not-a-Number (NaN) value, a
- <code><a href="common-dom-interfaces.html#not_supported_err">NOT_SUPPORTED_ERR</a></code> exception must be raised.</p>
+ <code><a href="#not_supported_err">NOT_SUPPORTED_ERR</a></code> exception must be raised.</p>
</dd>
@@ -967,8 +1049,7 @@
<dd>
- <p>Implementations must support some version of the Media Queries
- language. <a href="references.html#refsMQ">[MQ]</a></p>
+ <p>Implementations must support the Media Queries language. <a href="references.html#refsMQ">[MQ]</a></p>
</dd>
@@ -1002,6 +1083,8 @@
<ul class="brief"><li><dfn id="cross-origin-request">cross-origin request</dfn>
</li><li><dfn id="cross-origin-request-status">cross-origin request status</dfn>
+ </li><li><dfn id="custom-request-headers">custom request headers</dfn>
+ </li><li><dfn id="simple-cross-origin-request">simple cross-origin request</dfn>
</li><li><dfn id="redirect-steps">redirect steps</dfn>
</li><li><dfn id="credential-flag">credential flag</dfn>
</li><li><dfn id="resource-sharing-check">resource sharing check</dfn>
@@ -1032,6 +1115,16 @@
cannot be parsed, as closing the open construct does not result
in a viable value.</p>
+ <p>The term <dfn id="css-element-reference-identifier">CSS element reference identifier</dfn> is used as
+ defined in the <cite>CSS Image Values and Replaced Content</cite>
+ specification to define the API that declares identifiers for use
+ with the CSS 'element()' function. <a href="references.html#refsCSSIMAGES">[CSSIMAGES]</a></p>
+
+ <p>Similarly, the term <dfn id="provides-a-paint-source">provides a paint source</dfn> is used
+ as defined in the <cite>CSS Image Values and Replaced
+ Content</cite> specification to define the interaction of certain
+ HTML elements with the CSS 'element()' function. <a href="references.html#refsCSSIMAGES">[CSSIMAGES]</a></p>
+
</dd>
Index: text-level-semantics.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/text-level-semantics.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- text-level-semantics.html 17 Jun 2011 08:49:07 -0000 1.12
+++ text-level-semantics.html 24 Aug 2011 07:56:05 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -347,7 +350,7 @@
stringifier attribute DOMString <a href="#dom-a-href" title="dom-a-href">href</a>;
attribute DOMString <a href="#dom-a-target" title="dom-a-target">target</a>;
attribute DOMString <a href="#dom-a-rel" title="dom-a-rel">rel</a>;
- readonly attribute <a href="common-dom-interfaces.html#domtokenlist">DOMTokenList</a> <a href="#dom-a-rellist" title="dom-a-relList">relList</a>;
+ readonly attribute <a href="infrastructure.html#domtokenlist">DOMTokenList</a> <a href="#dom-a-rellist" title="dom-a-relList">relList</a>;
attribute DOMString <a href="#dom-a-media" title="dom-a-media">media</a>;
attribute DOMString <a href="#dom-a-hreflang" title="dom-a-hreflang">hreflang</a>;
attribute DOMString <a href="#dom-a-type" title="dom-a-type">type</a>;
@@ -385,10 +388,10 @@
</nav></pre>
</div><div class="impl">
- <p>The <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code>, <code title="attr-hyperlink-target"><a href="links.html#attr-hyperlink-target">target</a></code>
- attributes affect what
- happens when users <a href="links.html#following-hyperlinks" title="following hyperlinks">follow
- hyperlinks</a> created using the <code><a href="#the-a-element">a</a></code> element. The
+ <p>The <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code>,
+ <code title="attr-hyperlink-target"><a href="links.html#attr-hyperlink-target">target</a></code>,
+ attributes affect what happens when users <a href="links.html#following-hyperlinks" title="following hyperlinks">follow hyperlinks</a>
+ created using the <code><a href="#the-a-element">a</a></code> element. The
<code title="attr-hyperlink-rel"><a href="links.html#attr-hyperlink-rel">rel</a></code>, <code title="attr-hyperlink-media"><a href="links.html#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="links.html#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="links.html#attr-hyperlink-type">type</a></code> attributes may be used to
indicate to the user the likely nature of the target resource before
the user follows the link.</p>
@@ -400,14 +403,14 @@
<ol><li><p>If the <code title="event-click"><a href="infrastructure.html#event-click">click</a></code> event in
question is not <a href="infrastructure.html#concept-events-trusted" title="concept-events-trusted">trusted</a>
(i.e. a <code title="dom-click"><a href="editing.html#dom-click">click()</a></code> method call was the
- reason for the event being dispatched), and the <code><a href="#the-a-element">a</a></code>
+ reason for the event being dispatched), and either the <code><a href="#the-a-element">a</a></code>
element's <code title="attr-hyperlink-target"><a href="links.html#attr-hyperlink-target">target</a></code>
attribute is present and applying <a href="browsers.html#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name">the rules for choosing a
browsing context given a browsing context name</a>, using the
value of the <code title="attr-hyperlink-target"><a href="links.html#attr-hyperlink-target">target</a></code>
attribute as the browsing context name, would result in there not
being a chosen browsing context, then raise an
- <code><a href="common-dom-interfaces.html#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception and abort these
steps.</p></li>
<li><p>If the target of the <code title="event-click"><a href="infrastructure.html#event-click">click</a></code>
@@ -434,10 +437,11 @@
</ol></li>
- <li><p>Finally, the user agent must <a href="links.html#following-hyperlinks" title="following hyperlinks">follow the hyperlink</a> created by the
- <code><a href="#the-a-element">a</a></code> element. If the steps above defined a <var><a href="#hyperlink-suffix">hyperlink
- suffix</a></var>, then take that into account when following the
- hyperlink.</p></li>
+ <li><p>Finally, the user agent must <a href="links.html#following-hyperlinks" title="following hyperlinks">follow the hyperlink</a>
+ created by the <code><a href="#the-a-element">a</a></code> element, as determined by
+ any expressed user preference. If the steps above defined a
+ <var><a href="#hyperlink-suffix">hyperlink suffix</a></var>, then take that into account when
+ following or downloading the hyperlink.</p></li>
</ol></div><dl class="domintro"><dt><var title="">a</var> . <code title="dom-a-text"><a href="#dom-a-text">text</a></code></dt>
@@ -449,7 +453,8 @@
</dl><div class="impl">
- <p>The IDL attributes <dfn id="dom-a-href" title="dom-a-href"><code>href</code></dfn>,
+ <p>The IDL attributes
+ <dfn id="dom-a-href" title="dom-a-href"><code>href</code></dfn>,
<dfn id="dom-a-target" title="dom-a-target"><code>target</code></dfn>, <dfn id="dom-a-rel" title="dom-a-rel"><code>rel</code></dfn>, <dfn id="dom-a-media" title="dom-a-media"><code>media</code></dfn>, <dfn id="dom-a-hreflang" title="dom-a-hreflang"><code>hreflang</code></dfn>, and <dfn id="dom-a-type" title="dom-a-type"><code>type</code></dfn>, must
<a href="common-dom-interfaces.html#reflect">reflect</a> the respective content attributes of the same
name.</p>
@@ -1303,10 +1308,11 @@
<dd><a href="elements.html#global-attributes">Global attributes</a></dd>
<dt>DOM interface:</dt>
<dd>Uses <code><a href="elements.html#htmlelement">HTMLElement</a></code>.</dd>
- </dl><p>The <code><a href="#the-var-element">var</a></code> element <a href="rendering.html#represents">represents</a> a
- variable. This could be an actual variable in a mathematical
- expression or programming context, or it could just be a term used
- as a placeholder in prose.</p><div class="example">
+ </dl><p>The <code><a href="#the-var-element">var</a></code> element <a href="rendering.html#represents">represents</a> a variable.
+ This could be an actual variable in a mathematical expression or
+ programming context, an identifier representing a constant, a
+ function parameter, or just be a term used as a placeholder in
+ prose.</p><div class="example">
<p>In the paragraph below, the letter "n" is being used as a
variable in prose:</p>
<pre><p>If there are <var>n</var> pipes leading to the ice
@@ -1338,6 +1344,16 @@
</figcaption>
</figure></pre>
+ </div><div class="example">
+
+ <p>Here, the equation describing mass-energy equivalence is used in
+ a sentence, and the <code><a href="#the-var-element">var</a></code> element is used to mark the
+ variables and constants in that equation:</p>
+
+ <pre><p>Then he turned to the blackboard and picked up the chalk. After a few moment's
+thought, he wrote <var>E</var> = <var>m</var> <var>c</var><sup>2</sup>. The teacher
+looked pleased.</p></pre>
+
</div><h4 id="the-samp-element"><span class="secno">4.6.13 </span>The <dfn><code>samp</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="content-models.html#flow-content">Flow content</a>.</dd>
<dd><a href="content-models.html#phrasing-content">Phrasing content</a>.</dd>
@@ -1607,7 +1623,7 @@
the person writing this quote is clearly not American.</p></pre>
<p>(If the goal was to mark the element as misspelt, however, the
<code><a href="#the-u-element">u</a></code> element, possibly with a class, would be more
- appropriate.</p>
+ appropriate.)</p>
</div><div class="example">
<p>Another example of the <code><a href="#the-mark-element">mark</a></code> element is highlighting
@@ -1736,7 +1752,7 @@
reading in hiragana.</p>
<pre lang="ja">...
-<ruby>漢<rt>かん</rt>字<rt>じ　</rt></ruby>
+<ruby>漢<rt>かん</rt>字<rt>じ</rt></ruby>
...</pre>
<p>This might be rendered as:</p>
@@ -1751,7 +1767,7 @@
<span lang="zh-TW" title="">漢字</span> is annotated
with its bopomofo reading.</p>
- <pre lang="zh-TW"><ruby>漢<rt>ㄏㄢˋ</rt>字<rt>ㄗˋ　</rt></ruby></pre>
+ <pre lang="zh-TW"><ruby>漢<rt>ㄏㄢˋ</rt>字<rt>ㄗˋ</rt></ruby></pre>
<p>This might be rendered as:</p>
@@ -1765,7 +1781,7 @@
<span lang="zh-CN" title="">汉字</span> is annotated
with its pinyin reading.</p>
- <pre lang="zh-CN">...<ruby>汉<rt>hàn</rt>字<rt>zì </rt></ruby>...</pre>
+ <pre lang="zh-CN">...<ruby>汉<rt>hàn</rt>字<rt>zì</rt></ruby>...</pre>
<p>This might be rendered as:</p>
@@ -2038,6 +2054,17 @@
<pre><p>So then he pointed at the tiger and screamed
"there<wbr>is<wbr>no<wbr>way<wbr>you<wbr>are<wbr>ever<wbr>going<wbr>to<wbr>catch<wbr>me"!</p></pre>
+ </div><div class="example">
+
+ <p>Here, especially long lines of code in a program listing have
+ suggested wrapping points given using <code><a href="#the-wbr-element">wbr</a></code>
+ elements.</p>
+
+ <pre><pre>...
+Heading heading = Helm.HeadingFactory(HeadingCoordinates[1], <wbr>HeadingCoordinates[2], <wbr>HeadingCoordinates[3], <wbr>HeadingCoordinates[4]);
+Course course = Helm.CourseFactory(Heading, <wbr>Maps.MapFactoryFromHeading(heading), <wbr>Speeds.GetMaximumSpeed().ConvertToWarp());
+...</pre></pre>
+
</div><div class="impl">
<p>Any content inside <code><a href="#the-wbr-element">wbr</a></code> elements must not be
Index: scripting-1.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/scripting-1.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- scripting-1.html 17 Jun 2011 08:49:07 -0000 1.13
+++ scripting-1.html 24 Aug 2011 07:56:04 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -425,7 +428,7 @@
algorithms below (in this section) describe the core of this
processing, but these algorithms reference and are referenced by the
parsing rules for <code><a href="#the-script-element">script</a></code> <a href="tree-construction.html#scriptTag">start</a>
- and <a href="tree-construction.html#scriptEndTag">end</a> tags in HTML, <a href="tree-construction.html#scriptForeignEndTag">in foreign content</a>, and <a href="the-xhtml-syntax.html#scriptTagXML">in XML</a>, the rules for the <code title="dom-document-write"><a href="apis-in-html-documents.html#dom-document-write">document.write()</a></code> method, the
+ and <a href="tree-construction.html#scriptEndTag">end</a> tags in HTML, <a href="tree-construction.html#scriptForeignEndTag">in foreign content</a>, and <a href="the-xhtml-syntax.html#scriptTagXML">in XML</a>, the rules for the <code title="dom-document-write"><a href="content-models.html#dom-document-write">document.write()</a></code> method, the
handling of <a href="webappapis.html#scripting">scripting</a>, etc.</p><p>The <code title="attr-script-defer"><a href="#attr-script-defer">defer</a></code> attribute may be
specified even if the <code title="attr-script-async"><a href="#attr-script-async">async</a></code>
attribute is specified, to cause legacy Web browsers that only
@@ -440,9 +443,9 @@
<p>The first is a flag indicating whether or not the script block
has been <dfn id="already-started">"already started"</dfn>. Initially,
<code><a href="#the-script-element">script</a></code> elements must have this flag unset (script
- blocks, when created, are not "already started"). When a
- <code><a href="#the-script-element">script</a></code> element is <a href="infrastructure.html#concept-clone" title="concept-clone">cloned</a>, the "already started" flag, if
- set, must be propagated to the clone when it is created.</p>
+ blocks, when created, are not "already started"). The <a href="infrastructure.html#concept-node-clone-ext" title="concept-node-clone-ext">cloning steps</a> for
+ <code><a href="#the-script-element">script</a></code> elements must set the "already started" flag on
+ the copy if it is set on the element being cloned.</p>
<p>The second is a flag indicating whether the element was
<dfn id="parser-inserted">"parser-inserted"</dfn>. Initially, <code><a href="#the-script-element">script</a></code>
@@ -568,8 +571,7 @@
script block's type</a></var> for this <code><a href="#the-script-element">script</a></code> element be
the value of that attribute with any leading or trailing sequences
of <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a>
- removed.</p>
-
+ removed.</p>
<p>Otherwise, the element has a non-empty <code title="attr-script-language"><a href="obsolete.html#attr-script-language">language</a></code> attribute; let
<var><a href="#the-script-block-s-type">the script block's type</a></var> for this <code><a href="#the-script-element">script</a></code>
element be the concatenation of the string "<code title="">text/</code>" followed by the value of the <code title="attr-script-language"><a href="obsolete.html#attr-script-language">language</a></code> attribute.</p>
@@ -663,7 +665,7 @@
<p>Otherwise, let <var><a href="#the-script-block-s-fallback-character-encoding">the script block's fallback character
encoding</a></var> for this <code><a href="#the-script-element">script</a></code> element be the same as
- <a href="dom.html#document-s-character-encoding" title="document's character encoding">the encoding of the
+ <a href="infrastructure.html#document-s-character-encoding" title="document's character encoding">the encoding of the
document itself</a>.</p>
<p class="note">Only one of these two pieces of state is set.</p>
@@ -996,7 +998,7 @@
<li>
<p>If the script is from an external file, then increment the
- <a href="apis-in-html-documents.html#ignore-destructive-writes-counter">ignore-destructive-writes counter</a> of the
+ <a href="content-models.html#ignore-destructive-writes-counter">ignore-destructive-writes counter</a> of the
<code><a href="#the-script-element">script</a></code> element's <code><a href="infrastructure.html#document">Document</a></code>. Let <var title="">neutralized doc</var> be that
<code><a href="infrastructure.html#document">Document</a></code>.</p>
@@ -1016,7 +1018,7 @@
<li>
- <p>Decrement the <a href="apis-in-html-documents.html#ignore-destructive-writes-counter">ignore-destructive-writes
+ <p>Decrement the <a href="content-models.html#ignore-destructive-writes-counter">ignore-destructive-writes
counter</a> of <var title="">neutralized doc</var>, if it
was incremented in the earlier step.</p>
@@ -1069,14 +1071,14 @@
</dl><div class="impl">
<p>The IDL attribute <dfn id="dom-script-text" title="dom-script-text"><code>text</code></dfn> must return a
- concatenation of the contents of all the <a href="infrastructure.html#text-node" title="text node">text nodes</a> that are direct children of the
- <code><a href="#the-script-element">script</a></code> element (ignoring any other nodes such as
- comments or elements), in tree order. On setting, it must act the
- same way as the <code><a href="infrastructure.html#textcontent">textContent</a></code> IDL attribute.</p>
+ concatenation of the contents of all the <a href="infrastructure.html#text-node" title="text node">text nodes</a> that are children of the <code><a href="#the-script-element">script</a></code>
+ element (ignoring any other nodes such as comments or elements), in
+ tree order. On setting, it must act the same way as the
+ <code><a href="infrastructure.html#textcontent">textContent</a></code> IDL attribute.</p>
- </div><p class="note">When inserted using the <code title="dom-document-write"><a href="apis-in-html-documents.html#dom-document-write">document.write()</a></code> method,
+ </div><p class="note">When inserted using the <code title="dom-document-write"><a href="content-models.html#dom-document-write">document.write()</a></code> method,
<code><a href="#the-script-element">script</a></code> elements execute (typically synchronously), but
- when inserted using <code title="dom-innerHTML"><a href="apis-in-html-documents.html#dom-innerhtml">innerHTML</a></code> and <code title="dom-outerHTML"><a href="apis-in-html-documents.html#dom-outerhtml">outerHTML</a></code> attributes, they do not
+ when inserted using <code title="dom-innerHTML"><a href="content-models.html#dom-innerhtml">innerHTML</a></code> and <code title="dom-outerHTML"><a href="content-models.html#dom-outerhtml">outerHTML</a></code> attributes, they do not
execute at all.</p><div class="example">
<p>In this example, two <code><a href="#the-script-element">script</a></code> elements are used. One
@@ -1323,8 +1325,8 @@
<dd><a href="content-models.html#flow-content">Flow content</a>.</dd>
<dd><a href="content-models.html#phrasing-content">Phrasing content</a>.</dd>
<dt>Contexts in which this element can be used:</dt>
- <dd>In a <code><a href="semantics.html#the-head-element">head</a></code> element of an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, if there are no ancestor <code><a href="#the-noscript-element">noscript</a></code> elements.</dd>
- <dd>Where <a href="content-models.html#phrasing-content">phrasing content</a> is expected in <a href="dom.html#html-documents">HTML documents</a>, if there are no ancestor <code><a href="#the-noscript-element">noscript</a></code> elements.</dd>
+ <dd>In a <code><a href="semantics.html#the-head-element">head</a></code> element of an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, if there are no ancestor <code><a href="#the-noscript-element">noscript</a></code> elements.</dd>
+ <dd>Where <a href="content-models.html#phrasing-content">phrasing content</a> is expected in <a href="infrastructure.html#html-documents">HTML documents</a>, if there are no ancestor <code><a href="#the-noscript-element">noscript</a></code> elements.</dd>
<dt>Content model:</dt>
<dd>When <a href="webappapis.html#concept-n-noscript" title="concept-n-noscript">scripting is disabled</a>, in a <code><a href="semantics.html#the-head-element">head</a></code> element: in any order, zero or more <code><a href="semantics.html#the-link-element">link</a></code> elements, zero or more <code><a href="semantics.html#the-style-element">style</a></code> elements, and zero or more <code><a href="semantics.html#the-meta-element">meta</a></code> elements.</dd>
<dd>When <a href="webappapis.html#concept-n-noscript" title="concept-n-noscript">scripting is disabled</a>, not in a <code><a href="semantics.html#the-head-element">head</a></code> element: <a href="content-models.html#transparent">transparent</a>, but there must be no <code><a href="#the-noscript-element">noscript</a></code> element descendants.</dd>
@@ -1338,7 +1340,7 @@
<a href="rendering.html#represents">represents</a> its children if <a href="webappapis.html#concept-n-noscript" title="concept-n-noscript">scripting is disabled</a>. It is used
to present different markup to user agents that support scripting
and those that don't support scripting, by affecting how the
- document is parsed.</p><p>When used in <a href="dom.html#html-documents">HTML documents</a>, the allowed content
+ document is parsed.</p><p>When used in <a href="infrastructure.html#html-documents">HTML documents</a>, the allowed content
model is as follows:</p><dl><dt>In a <code><a href="semantics.html#the-head-element">head</a></code> element, if <a href="webappapis.html#concept-n-noscript" title="concept-n-noscript">scripting is disabled</a> for the
<code><a href="#the-noscript-element">noscript</a></code> element</dt>
@@ -1403,7 +1405,7 @@
<a href="infrastructure.html#text-node">text node</a> children of the <code><a href="#the-noscript-element">noscript</a></code>
element.</li>
- <li>Set the <code title="dom-innerHTML"><a href="apis-in-html-documents.html#dom-innerhtml">innerHTML</a></code>
+ <li>Set the <code title="dom-innerHTML"><a href="content-models.html#dom-innerhtml">innerHTML</a></code>
attribute of the <var title="">parent element</var> to the value
of <var title="">s</var>. (This, as a side-effect, causes the
<code><a href="#the-noscript-element">noscript</a></code> element to be removed from the
@@ -1424,7 +1426,7 @@
</dl><p class="note">All these contortions are required because, for
historical reasons, the <code><a href="#the-noscript-element">noscript</a></code> element is handled
differently by the <a href="parsing.html#html-parser">HTML parser</a> based on whether <a href="parsing.html#scripting-flag" title="scripting flag">scripting was enabled or not</a> when the
- parser was invoked.</p><p>The <code><a href="#the-noscript-element">noscript</a></code> element must not be used in <a href="dom.html#xml-documents">XML
+ parser was invoked.</p><p>The <code><a href="#the-noscript-element">noscript</a></code> element must not be used in <a href="infrastructure.html#xml-documents">XML
documents</a>.</p><p class="note">The <code><a href="#the-noscript-element">noscript</a></code> element is only effective
in <a href="syntax.html#syntax">the HTML syntax</a>, it has no effect in <a href="the-xhtml-syntax.html#the-xhtml-syntax">the XHTML
syntax</a>. This is because the way it works is by essentially
Index: the-map-element.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/the-map-element.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- the-map-element.html 17 Jun 2011 08:49:08 -0000 1.12
+++ the-map-element.html 24 Aug 2011 07:56:05 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -339,8 +342,8 @@
<dd>
<pre class="idl">interface <dfn id="htmlmapelement">HTMLMapElement</dfn> : <a href="elements.html#htmlelement">HTMLElement</a> {
attribute DOMString <a href="#dom-map-name" title="dom-map-name">name</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-map-areas" title="dom-map-areas">areas</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-map-images" title="dom-map-images">images</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-map-areas" title="dom-map-areas">areas</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-map-images" title="dom-map-images">images</a>;
};</pre>
</dd>
</dl><p>The <code><a href="#the-map-element">map</a></code> element, in conjunction with any
@@ -357,7 +360,7 @@
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-area-element">area</a></code> elements in the <code><a href="#the-map-element">map</a></code>.</p>
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-area-element">area</a></code> elements in the <code><a href="#the-map-element">map</a></code>.</p>
</dd>
@@ -365,19 +368,19 @@
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="embedded-content-1.html#the-img-element">img</a></code> and <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements that use the <code><a href="#the-map-element">map</a></code>.</p>
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="embedded-content-1.html#the-img-element">img</a></code> and <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements that use the <code><a href="#the-map-element">map</a></code>.</p>
</dd>
</dl><div class="impl">
<p>The <dfn id="dom-map-areas" title="dom-map-areas"><code>areas</code></dfn> attribute
- must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="#the-map-element">map</a></code> element, whose filter matches only
<code><a href="#the-area-element">area</a></code> elements.</p>
<p>The <dfn id="dom-map-images" title="dom-map-images"><code>images</code></dfn>
- attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only
<code><a href="embedded-content-1.html#the-img-element">img</a></code> and <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements that are
associated with this <code><a href="#the-map-element">map</a></code> element according to the
@@ -443,7 +446,7 @@
stringifier attribute DOMString <a href="#dom-area-href" title="dom-area-href">href</a>;
attribute DOMString <a href="#dom-area-target" title="dom-area-target">target</a>;
attribute DOMString <a href="#dom-area-rel" title="dom-area-rel">rel</a>;
- readonly attribute <a href="common-dom-interfaces.html#domtokenlist">DOMTokenList</a> <a href="#dom-area-rellist" title="dom-area-relList">relList</a>;
+ readonly attribute <a href="infrastructure.html#domtokenlist">DOMTokenList</a> <a href="#dom-area-rellist" title="dom-area-relList">relList</a>;
attribute DOMString <a href="#dom-area-media" title="dom-area-media">media</a>;
attribute DOMString <a href="#dom-area-hreflang" title="dom-area-hreflang">hreflang</a>;
attribute DOMString <a href="#dom-area-type" title="dom-area-type">type</a>;
@@ -534,12 +537,13 @@
right side, and the distance from the top edge to the bottom side,
all in CSS pixels.</p><div class="impl">
- <p>When user agents allow users to <a href="links.html#following-hyperlinks" title="following hyperlinks">follow hyperlinks</a> created using the
- <code><a href="#the-area-element">area</a></code> element, as described in the next section, the
+ <p>When user agents allow users to <a href="links.html#following-hyperlinks" title="following hyperlinks">follow hyperlinks</a>
+ created using the <code><a href="#the-area-element">area</a></code> element, as described in the
+ next section, the
<code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code>,
- <code title="attr-hyperlink-target"><a href="links.html#attr-hyperlink-target">target</a></code>
- attributes decide how the
- link is followed. The <code title="attr-hyperlink-rel"><a href="links.html#attr-hyperlink-rel">rel</a></code>,
+ <code title="attr-hyperlink-target"><a href="links.html#attr-hyperlink-target">target</a></code>,
+ attributes decide how the link is followed.
+ The <code title="attr-hyperlink-rel"><a href="links.html#attr-hyperlink-rel">rel</a></code>,
<code title="attr-hyperlink-media"><a href="links.html#attr-hyperlink-media">media</a></code>, <code title="attr-hyperlink-hreflang"><a href="links.html#attr-hyperlink-hreflang">hreflang</a></code>, and <code title="attr-hyperlink-type"><a href="links.html#attr-hyperlink-type">type</a></code> attributes may be used to
indicate to the user the likely nature of the target resource before
the user follows the link.</p>
@@ -562,11 +566,12 @@
value of the <code title="attr-hyperlink-target"><a href="links.html#attr-hyperlink-target">target</a></code>
attribute as the browsing context name, would result in there not
being a chosen browsing context, then raise an
- <code><a href="common-dom-interfaces.html#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception and abort these
steps.</p></li>
- <li>Otherwise, the user agent must <a href="links.html#following-hyperlinks" title="following hyperlinks">follow the hyperlink</a> created by the
- <code><a href="#the-area-element">area</a></code> element, if any.</li>
+ <li><p>Otherwise, the user agent must <a href="links.html#following-hyperlinks" title="following hyperlinks">follow the hyperlink</a>
+ created by the <code><a href="#the-area-element">area</a></code> element, if any, and as determined by
+ any expressed user preference.</p></li>
</ol><p>The IDL attributes <dfn id="dom-area-alt" title="dom-area-alt"><code>alt</code></dfn>, <dfn id="dom-area-coords" title="dom-area-coords"><code>coords</code></dfn>, <dfn id="dom-area-href" title="dom-area-href"><code>href</code></dfn>, <dfn id="dom-area-target" title="dom-area-target"><code>target</code></dfn>,
<dfn id="dom-area-rel" title="dom-area-rel"><code>rel</code></dfn>, <dfn id="dom-area-media" title="dom-area-media"><code>media</code></dfn>, <dfn id="dom-area-hreflang" title="dom-area-hreflang"><code>hreflang</code></dfn>, and <dfn id="dom-area-type" title="dom-area-type"><code>type</code></dfn>, each must
@@ -794,9 +799,14 @@
</dd>
</dl><p>For historical reasons, the coordinates must be interpreted
- relative to the <em>displayed</em> image, even if it stretched
- using CSS or the image element's <code title="">width</code> and
- <code title="">height</code> attributes.</p>
+ relative to the <em>displayed</em> image after any stretching
+ caused by the CSS 'width' and 'height' properties (or, for non-CSS
+ browsers, the image element's <code title="">width</code> and
+ <code title="">height</code> attributes — CSS browsers map
+ those attributes to the aforementioned CSS properties).</p>
+
+ <p class="note">Browser zoom features and transforms applied using
+ CSS or SVG do not affect the coordinates.</p>
</li>
@@ -896,7 +906,7 @@
</div><p>When the SVG <code title="">foreignObject</code> element contains
elements from the <a href="namespaces.html#html-namespace-0">HTML namespace</a>, such elements must
all be <a href="content-models.html#flow-content">flow content</a>. <a href="references.html#refsSVG">[SVG]</a></p><p>The content model for <code title="">title</code> elements in the
- <a href="namespaces.html#svg-namespace">SVG namespace</a> inside <a href="dom.html#html-documents">HTML documents</a> is
+ <a href="namespaces.html#svg-namespace">SVG namespace</a> inside <a href="infrastructure.html#html-documents">HTML documents</a> is
<a href="content-models.html#phrasing-content">phrasing content</a>. (This further constrains the
requirements given in the SVG specification.)</p><p>The semantics of SVG elements are defined by the SVG
specification and <a href="infrastructure.html#other-applicable-specifications">other applicable specifications</a>. <a href="references.html#refsSVG">[SVG]</a></p><p>The SVG specification includes requirements regarding the
Index: the-canvas-element.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/the-canvas-element.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- the-canvas-element.html 17 Jun 2011 08:49:08 -0000 1.14
+++ the-canvas-element.html 24 Aug 2011 07:56:05 -0000 1.15
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -343,10 +346,10 @@
attribute unsigned long <a href="#dom-canvas-width" title="dom-canvas-width">width</a>;
attribute unsigned long <a href="#dom-canvas-height" title="dom-canvas-height">height</a>;
- DOMString <a href="#dom-canvas-todataurl" title="dom-canvas-toDataURL">toDataURL</a>(in optional DOMString type, in any... args);
- void <a href="#dom-canvas-toblob" title="dom-canvas-toBlob">toBlob</a>(in <span>FileCallback</span>? callback, in optional DOMString type, in any... args);
+ DOMString <a href="#dom-canvas-todataurl" title="dom-canvas-toDataURL">toDataURL</a>(optional DOMString type, any... args);
+ void <a href="#dom-canvas-toblob" title="dom-canvas-toBlob">toBlob</a>(<span>FileCallback</span>? callback, optional DOMString type, any... args);
- object? <a href="#dom-canvas-getcontext" title="dom-canvas-getContext">getContext</a>(in DOMString contextId, in any... args);
+ object? <a href="#dom-canvas-getcontext" title="dom-canvas-getContext">getContext</a>(DOMString contextId, any... args);
};</pre>
</dd>
</dl><p>The <code><a href="#the-canvas-element">canvas</a></code> element provides scripts with a
@@ -386,7 +389,7 @@
keyboard-accessible: authors should have a one-to-one mapping of
interactive regions to focusable elements in the <a href="content-models.html#fallback-content">fallback
content</a>. (Focus has no effect on mouse interaction
- events.) <a href="#DOMEVENTS">[DOMEVENTS]</a></p><p>The <code><a href="#the-canvas-element">canvas</a></code> element has two attributes to control the
+ events.) <a href="references.html#refsDOMEVENTS">[DOMEVENTS]</a></p><p>The <code><a href="#the-canvas-element">canvas</a></code> element has two attributes to control the
size of the coordinate space: <dfn id="attr-canvas-width" title="attr-canvas-width"><code>width</code></dfn> and <dfn id="attr-canvas-height" title="attr-canvas-height"><code>height</code></dfn>. These
attributes, when specified, must have values that are <a href="common-microsyntaxes.html#valid-non-negative-integer" title="valid non-negative integer">valid non-negative
integers</a>. <span class="impl">The <a href="common-microsyntaxes.html#rules-for-parsing-non-negative-integers">rules for parsing
@@ -418,6 +421,12 @@
<p>When the canvas is initialized, its bitmap must be cleared to
transparent black.</p>
+ <p>When a <code><a href="#the-canvas-element">canvas</a></code> element does not represent its
+ <a href="content-models.html#fallback-content">fallback content</a>, it <a href="infrastructure.html#provides-a-paint-source">provides a paint
+ source</a> whose width is the element's intrinsic width, whose
+ height is the element's intrinsic height, and whose appearance is
+ the element's bitmap.</p>
+
<p>The <dfn id="dom-canvas-width" title="dom-canvas-width"><code>width</code></dfn> and
<dfn id="dom-canvas-height" title="dom-canvas-height"><code>height</code></dfn> IDL
attributes must <a href="common-dom-interfaces.html#reflect">reflect</a> the respective content
@@ -768,20 +777,20 @@
drawn.)</p></li>
</ul><p>Whenever the <code title="dom-canvas-toDataURL"><a href="#dom-canvas-todataurl">toDataURL()</a></code> method of a
<code><a href="#the-canvas-element">canvas</a></code> element whose <i>origin-clean</i> flag is set to
- false is called, the method must raise a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code>
+ false is called, the method must raise a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code>
exception.</p>
<p>Whenever the <code title="dom-context-2d-getImageData">getImageData()</code> method of
the 2D context of a <code><a href="#the-canvas-element">canvas</a></code> element whose
<i>origin-clean</i> flag is set to false is called with otherwise
- correct arguments, the method must raise a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code>
+ correct arguments, the method must raise a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code>
exception.</p>
<p>Whenever the <code title="dom-context-2d-measureText">measureText()</code> method of
the 2D context of a <code><a href="#the-canvas-element">canvas</a></code> element ends up using a font
that has an <a href="origin-0.html#origin">origin</a> that is not the <a href="origin-0.html#same-origin" title="same origin">same</a> as that of the <code><a href="infrastructure.html#document">Document</a></code> object that
owns the <code><a href="#the-canvas-element">canvas</a></code> element, the method must raise a
- <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception.</p>
+ <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception.</p>
<p class="note">Even resetting the canvas state by changing its
<code title="attr-canvas-width"><a href="#attr-canvas-width">width</a></code> or <code title="attr-canvas-height"><a href="#attr-canvas-height">height</a></code> attributes doesn't reset
Index: tabular-data.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/tabular-data.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- tabular-data.html 17 Jun 2011 08:49:07 -0000 1.13
+++ tabular-data.html 24 Aug 2011 07:56:05 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -354,31 +357,29 @@
attribute <a href="#htmltablesectionelement">HTMLTableSectionElement</a>? <a href="#dom-table-tfoot" title="dom-table-tFoot">tFoot</a>;
<a href="elements.html#htmlelement">HTMLElement</a> <a href="#dom-table-createtfoot" title="dom-table-createTFoot">createTFoot</a>();
void <a href="#dom-table-deletetfoot" title="dom-table-deleteTFoot">deleteTFoot</a>();
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-table-tbodies" title="dom-table-tBodies">tBodies</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-table-tbodies" title="dom-table-tBodies">tBodies</a>;
<a href="elements.html#htmlelement">HTMLElement</a> <a href="#dom-table-createtbody" title="dom-table-createTBody">createTBody</a>();
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-table-rows" title="dom-table-rows">rows</a>;
- <a href="elements.html#htmlelement">HTMLElement</a> <a href="#dom-table-insertrow" title="dom-table-insertRow">insertRow</a>(in optional long index);
- void <a href="#dom-table-deleterow" title="dom-table-deleteRow">deleteRow</a>(in long index);
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-table-rows" title="dom-table-rows">rows</a>;
+ <a href="elements.html#htmlelement">HTMLElement</a> <a href="#dom-table-insertrow" title="dom-table-insertRow">insertRow</a>(optional long index);
+ void <a href="#dom-table-deleterow" title="dom-table-deleteRow">deleteRow</a>(long index);
attribute DOMString <a href="#dom-table-border" title="dom-table-border">border</a>;
};</pre>
</dd>
</dl><p>The <code><a href="#the-table-element">table</a></code> element <a href="rendering.html#represents">represents</a> data with
- more than one dimension, in the form of a <a href="#concept-table" title="concept-table">table</a>.</p><div class="impl">
- <p>The <code><a href="#the-table-element">table</a></code> element takes part in the <a href="#table-model">table
- model</a>.</p>
- </div><p>Tables have rows, columns, and cells given by their descendants.
- The rows and columns form a grid; a table's cells must completely
- cover that grid without overlap.</p><div class="impl">
+ more than one dimension, in the form of a <a href="#concept-table" title="concept-table">table</a>.</p><p><span class="impl">The <code><a href="#the-table-element">table</a></code> element takes part in
+ the <a href="#table-model">table model</a>.</span> Tables have rows, columns, and
+ cells given by their descendants. The rows and columns form a grid;
+ a table's cells must completely cover that grid without overlap.</p><div class="impl">
<p class="note">Precise rules for determining whether this
conformance requirement is met are described in the description of
the <a href="#table-model">table model</a>.</p>
- </div><hr/><p>Authors are encouraged to provide information describing how to
+ </div><p>Authors are encouraged to provide information describing how to
interpret complex tables. Guidance on how <a href="#table-descriptions-techniques">provide such information</a>
is given below.</p><div class="impl">
- <p>If a <code><a href="#the-table-element">table</a></code> element has a <code title="attr-table-summary"><a href="obsolete.html#attr-table-summary">summary</a></code> attribute, and the user
+ <p>If a <code><a href="#the-table-element">table</a></code> element has a (non-conforming) <code title="attr-table-summary"><a href="obsolete.html#attr-table-summary">summary</a></code> attribute, and the user
agent has not classified the table as a layout table, the user agent
may report the contents of that attribute to the user.</p>
- </div><hr/><p>Tables should not be used as layout aids.
+ </div><p>Tables should not be used as layout aids.
Historically, many Web authors have tables in HTML as a way to
control their page layout making it difficult to extract tabular
@@ -401,8 +402,8 @@
either be the empty string or the value "<code title="">1</code>".
The attribute is used by certain user agents as an indication that
borders should be drawn around cells of the table.</p><div class="impl">
- <p>Tables can be complicated to understand and navigate. To help
- users with this, user agents should clearly dilineate cells in a
+ <hr/><p>Tables can be complicated to understand and navigate. To help
+ users with this, user agents should clearly delineate cells in a
table from each other, unless the user agent has classified the
table as a
layout table.</p>
@@ -434,12 +435,17 @@
</td><td>Probably a non-layout table
</td></tr></tbody><tbody><tr><td>The use of the <code title="attr-table-summary"><a href="obsolete.html#attr-table-summary">summary</a></code> attribute
</td><td>Not a good indicator (both layout and non-layout tables have historically been given this attribute)
- </td></tr></tbody></table></div><hr/><dl class="domintro"><dt><var title="">table</var> . <code title="dom-table-caption"><a href="#dom-table-caption">caption</a></code> [ = <var title="">value</var> ]</dt>
+ </td></tr></tbody></table><p class="note">It is quite possible that the above suggestions are
+ wrong. Implementors are urged to provide feedback elaborating on
+ their experiences with trying to create a layout table detection
+ heuristic.</p>
+
+ </div><hr/><dl class="domintro"><dt><var title="">table</var> . <code title="dom-table-caption"><a href="#dom-table-caption">caption</a></code> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the table's <code><a href="#the-caption-element">caption</a></code> element.</p>
<p>Can be set, to replace the <code><a href="#the-caption-element">caption</a></code> element. If the
new value is not a <code><a href="#the-caption-element">caption</a></code> element, throws a
- <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
+ <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
</dd>
<dt><var title="">caption</var> = <var title="">table</var> . <code title="dom-table-createCaption"><a href="#dom-table-createcaption">createCaption</a></code>()</dt>
@@ -457,7 +463,7 @@
<p>Returns the table's <code><a href="#the-thead-element">thead</a></code> element.</p>
<p>Can be set, to replace the <code><a href="#the-thead-element">thead</a></code> element. If the
new value is not a <code><a href="#the-thead-element">thead</a></code> element, throws a
- <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
+ <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
</dd>
<dt><var title="">thead</var> = <var title="">table</var> . <code title="dom-table-createTHead"><a href="#dom-table-createthead">createTHead</a></code>()</dt>
@@ -475,7 +481,7 @@
<p>Returns the table's <code><a href="#the-tfoot-element">tfoot</a></code> element.</p>
<p>Can be set, to replace the <code><a href="#the-tfoot-element">tfoot</a></code> element. If the
new value is not a <code><a href="#the-tfoot-element">tfoot</a></code> element, throws a
- <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
+ <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
</dd>
<dt><var title="">tfoot</var> = <var title="">table</var> . <code title="dom-table-createTFoot"><a href="#dom-table-createtfoot">createTFoot</a></code>()</dt>
@@ -490,7 +496,7 @@
<dt><var title="">table</var> . <code title="dom-table-tBodies"><a href="#dom-table-tbodies">tBodies</a></code></dt>
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-tbody-element">tbody</a></code> elements of the table.</p>
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-tbody-element">tbody</a></code> elements of the table.</p>
</dd>
<dt><var title="">tbody</var> = <var title="">table</var> . <code title="dom-table-createTBody"><a href="#dom-table-createtbody">createTBody</a></code>()</dt>
@@ -500,21 +506,21 @@
<dt><var title="">table</var> . <code title="dom-table-rows"><a href="#dom-table-rows">rows</a></code></dt>
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-tr-element">tr</a></code> elements of the table.</p>
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-tr-element">tr</a></code> elements of the table.</p>
</dd>
<dt><var title="">tr</var> = <var title="">table</var> . <code title="dom-table-insertRow"><a href="#dom-table-insertrow">insertRow</a></code>(<var title="">index</var>)</dt>
<dd>
<p>Creates a <code><a href="#the-tr-element">tr</a></code> element, along with a <code><a href="#the-tbody-element">tbody</a></code> if required, inserts them into the table at the position given by the argument, and returns the <code><a href="#the-tr-element">tr</a></code>.</p>
<p>The position is relative to the rows in the table. The index −1 is equivalent to inserting at the end of the table.</p>
- <p>If the given position is less than −1 or greater than the number of rows, throws an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
+ <p>If the given position is less than −1 or greater than the number of rows, throws an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
</dd>
<dt><var title="">table</var> . <code title="dom-table-deleteRow"><a href="#dom-table-deleterow">deleteRow</a></code>(<var title="">index</var>)</dt>
<dd>
<p>Removes the <code><a href="#the-tr-element">tr</a></code> element with the given position in the table.</p>
<p>The position is relative to the rows in the table. The index −1 is equivalent to deleting the last row of the table.</p>
- <p>If the given position is less than −1 or greater than the index of the last row, or if there are no rows, throws an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
+ <p>If the given position is less than −1 or greater than the index of the last row, or if there are no rows, throws an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
</dd>
</dl><div class="impl">
@@ -527,7 +533,7 @@
<code><a href="#the-table-element">table</a></code> element, if any, must be removed, and the new
value must be inserted as the first node of the <code><a href="#the-table-element">table</a></code>
element. If the new value is not a <code><a href="#the-caption-element">caption</a></code> element,
- then a <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> DOM exception must be
+ then a <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> DOM exception must be
raised instead.</p>
<p>The <dfn id="dom-table-createcaption" title="dom-table-createCaption"><code>createCaption()</code></dfn>
@@ -551,7 +557,7 @@
element nor a <code><a href="#the-colgroup-element">colgroup</a></code> element, if any, or at the end
of the table if there are no such elements. If the new value is not
a <code><a href="#the-thead-element">thead</a></code> element, then a
- <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> DOM exception must be raised
+ <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> DOM exception must be raised
instead.</p>
<p>The <dfn id="dom-table-createthead" title="dom-table-createTHead"><code>createTHead()</code></dfn>
@@ -578,7 +584,7 @@
element, a <code><a href="#the-colgroup-element">colgroup</a></code> element, nor a <code><a href="#the-thead-element">thead</a></code>
element, if any, or at the end of the table if there are no such
elements. If the new value is not a <code><a href="#the-tfoot-element">tfoot</a></code> element, then
- a <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> DOM exception must be raised
+ a <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> DOM exception must be raised
instead.</p>
<p>The <dfn id="dom-table-createtfoot" title="dom-table-createTFoot"><code>createTFoot()</code></dfn>
@@ -596,7 +602,7 @@
<code><a href="#the-table-element">table</a></code> element, if any.</p>
<p>The <dfn id="dom-table-tbodies" title="dom-table-tBodies"><code>tBodies</code></dfn>
- attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="#the-table-element">table</a></code> node, whose filter matches only
<code><a href="#the-tbody-element">tbody</a></code> elements that are children of the
<code><a href="#the-table-element">table</a></code> element.</p>
@@ -610,7 +616,7 @@
<code><a href="#the-tbody-element">tbody</a></code> element.</p>
<p>The <dfn id="dom-table-rows" title="dom-table-rows"><code>rows</code></dfn> attribute
- must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="#the-table-element">table</a></code> node, whose filter matches only <code><a href="#the-tr-element">tr</a></code>
elements that are either children of the <code><a href="#the-table-element">table</a></code> element,
or children of <code><a href="#the-thead-element">thead</a></code>, <code><a href="#the-tbody-element">tbody</a></code>, or
@@ -632,7 +638,7 @@
the number of elements in <code title="dom-table-rows"><a href="#dom-table-rows">rows</a></code>
collection:</dt>
- <dd>The method must raise an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code>
+ <dd>The method must raise an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code>
exception.</dd>
<dt>If the <code title="dom-table-rows"><a href="#dom-table-rows">rows</a></code> collection has
@@ -677,7 +683,7 @@
<li><p>Now, if <var title="">index</var> is less than zero, or
greater than or equal to the number of elements in the <code title="dom-table-rows"><a href="#dom-table-rows">rows</a></code> collection, the method must
- instead raise an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> exception, and these
+ instead raise an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception, and these
steps must be aborted.</p></li>
<li><p>Otherwise, the method must remove the <var title="">index</var>th element in the <code title="dom-table-rows"><a href="#dom-table-rows">rows</a></code> collection from its parent.</p>
@@ -1047,9 +1053,9 @@
<dt>DOM interface:</dt>
<dd>
<pre class="idl">interface <dfn id="htmltablesectionelement">HTMLTableSectionElement</dfn> : <a href="elements.html#htmlelement">HTMLElement</a> {
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-tbody-rows" title="dom-tbody-rows">rows</a>;
- <a href="elements.html#htmlelement">HTMLElement</a> <a href="#dom-tbody-insertrow" title="dom-tbody-insertRow">insertRow</a>(in optional long index);
- void <a href="#dom-tbody-deleterow" title="dom-tbody-deleteRow">deleteRow</a>(in long index);
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-tbody-rows" title="dom-tbody-rows">rows</a>;
+ <a href="elements.html#htmlelement">HTMLElement</a> <a href="#dom-tbody-insertrow" title="dom-tbody-insertRow">insertRow</a>(optional long index);
+ void <a href="#dom-tbody-deleterow" title="dom-tbody-deleteRow">deleteRow</a>(long index);
};</pre>
<p>The <code><a href="#htmltablesectionelement">HTMLTableSectionElement</a></code> interface is also
used for <code><a href="#the-thead-element">thead</a></code> and <code><a href="#the-tfoot-element">tfoot</a></code> elements.</p>
@@ -1063,27 +1069,27 @@
</div><dl class="domintro"><dt><var title="">tbody</var> . <code title="dom-tbody-rows"><a href="#dom-tbody-rows">rows</a></code></dt>
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-tr-element">tr</a></code> elements of the table section.</p>
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-tr-element">tr</a></code> elements of the table section.</p>
</dd>
<dt><var title="">tr</var> = <var title="">tbody</var> . <code title="dom-tbody-insertRow"><a href="#dom-tbody-insertrow">insertRow</a></code>( [ <var title="">index</var> ] )</dt>
<dd>
<p>Creates a <code><a href="#the-tr-element">tr</a></code> element, inserts it into the table section at the position given by the argument, and returns the <code><a href="#the-tr-element">tr</a></code>.</p>
<p>The position is relative to the rows in the table section. The index −1, which is the default if the argument is omitted, is equivalent to inserting at the end of the table section.</p>
- <p>If the given position is less than −1 or greater than the number of rows, throws an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
+ <p>If the given position is less than −1 or greater than the number of rows, throws an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
</dd>
<dt><var title="">tbody</var> . <code title="dom-tbody-deleteRow"><a href="#dom-tbody-deleterow">deleteRow</a></code>(<var title="">index</var>)</dt>
<dd>
<p>Removes the <code><a href="#the-tr-element">tr</a></code> element with the given position in the table section.</p>
<p>The position is relative to the rows in the table section. The index −1 is equivalent to deleting the last row of the table section.</p>
- <p>If the given position is less than −1 or greater than the index of the last row, or if there are no rows, throws an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
+ <p>If the given position is less than −1 or greater than the index of the last row, or if there are no rows, throws an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
</dd>
</dl><div class="impl">
<p>The <dfn id="dom-tbody-rows" title="dom-tbody-rows"><code>rows</code></dfn> attribute
- must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the element,
+ must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the element,
whose filter matches only <code><a href="#the-tr-element">tr</a></code> elements that are children
of the element.</p>
@@ -1092,7 +1098,7 @@
<p>If <var title="">index</var> is less than −1 or greater than the
number of elements in the <code title="dom-tbody-rows"><a href="#dom-tbody-rows">rows</a></code>
- collection, the method must raise an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code>
+ collection, the method must raise an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code>
exception.</p>
<p>If <var title="">index</var> is missing, equal to −1, or
@@ -1109,7 +1115,7 @@
<p>The <dfn id="dom-tbody-deleterow" title="dom-tbody-deleteRow"><code>deleteRow(<var title="">index</var>)</code></dfn> method must remove the <var title="">index</var>th element in the <code title="dom-tbody-rows"><a href="#dom-tbody-rows">rows</a></code> collection from its parent. If
<var title="">index</var> is less than zero or greater than or equal
to the number of elements in the <code title="dom-tbody-rows"><a href="#dom-tbody-rows">rows</a></code> collection, the method must
- instead raise an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
+ instead raise an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
</div><h4 id="the-thead-element"><span class="secno">4.9.6 </span>The <dfn><code>thead</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd>None.</dd>
@@ -1219,9 +1225,9 @@
<pre class="idl">interface <dfn id="htmltablerowelement">HTMLTableRowElement</dfn> : <a href="elements.html#htmlelement">HTMLElement</a> {
readonly attribute long <a href="#dom-tr-rowindex" title="dom-tr-rowIndex">rowIndex</a>;
readonly attribute long <a href="#dom-tr-sectionrowindex" title="dom-tr-sectionRowIndex">sectionRowIndex</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-tr-cells" title="dom-tr-cells">cells</a>;
- <a href="elements.html#htmlelement">HTMLElement</a> <a href="#dom-tr-insertcell" title="dom-tr-insertCell">insertCell</a>(in optional long index);
- void <a href="#dom-tr-deletecell" title="dom-tr-deleteCell">deleteCell</a>(in long index);
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-tr-cells" title="dom-tr-cells">cells</a>;
+ <a href="elements.html#htmlelement">HTMLElement</a> <a href="#dom-tr-insertcell" title="dom-tr-insertCell">insertCell</a>(optional long index);
+ void <a href="#dom-tr-deletecell" title="dom-tr-deleteCell">deleteCell</a>(long index);
};</pre>
</dd>
</dl><p>The <code><a href="#the-tr-element">tr</a></code> element <a href="rendering.html#represents">represents</a> a <a href="#concept-row" title="concept-row">row</a> of <a href="#concept-cell" title="concept-cell">cells</a> in a <a href="#concept-table" title="concept-table">table</a>.</p><div class="impl">
@@ -1252,7 +1258,7 @@
<dt><var title="">tr</var> . <code title="dom-tr-cells"><a href="#dom-tr-cells">cells</a></code></dt>
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-td-element">td</a></code> and <code><a href="#the-th-element">th</a></code> elements of the row.</p>
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="#the-td-element">td</a></code> and <code><a href="#the-th-element">th</a></code> elements of the row.</p>
</dd>
@@ -1269,7 +1275,7 @@
is equivalent to inserting at the end of the row.</p>
<p>If the given position is less than −1 or greater than
- the number of cells, throws an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code>
+ the number of cells, throws an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code>
exception.</p>
</dd>
@@ -1285,7 +1291,7 @@
<p>If the given position is less than −1 or greater than
the index of the last cell, or if there are no cells, throws an
- <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
+ <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
</dd>
@@ -1311,7 +1317,7 @@
must return −1.</p>
<p>The <dfn id="dom-tr-cells" title="dom-tr-cells"><code>cells</code></dfn> attribute
- must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="#the-tr-element">tr</a></code> element, whose filter matches only <code><a href="#the-td-element">td</a></code>
and <code><a href="#the-th-element">th</a></code> elements that are children of the
<code><a href="#the-tr-element">tr</a></code> element.</p>
@@ -1320,7 +1326,7 @@
<p>If <var title="">index</var> is less than −1 or greater than the
number of elements in the <code title="dom-tr-cells"><a href="#dom-tr-cells">cells</a></code>
- collection, the method must raise an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code>
+ collection, the method must raise an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code>
exception.</p>
<p>If <var title="">index</var> is missing, equal to −1, or
@@ -1337,7 +1343,7 @@
<p>The <dfn id="dom-tr-deletecell" title="dom-tr-deleteCell"><code>deleteCell(<var title="">index</var>)</code></dfn> method must remove the <var title="">index</var>th element in the <code title="dom-tr-cells"><a href="#dom-tr-cells">cells</a></code> collection from its parent. If
<var title="">index</var> is less than zero or greater than or equal
to the number of elements in the <code title="dom-tr-cells"><a href="#dom-tr-cells">cells</a></code> collection, the method must
- instead raise an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
+ instead raise an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception.</p>
</div><h4 id="the-td-element"><span class="secno">4.9.9 </span>The <dfn><code>td</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="sections.html#sectioning-root">Sectioning root</a>.</dd>
@@ -1501,7 +1507,7 @@
interface:</p><pre class="idl">interface <dfn id="htmltablecellelement">HTMLTableCellElement</dfn> : <a href="elements.html#htmlelement">HTMLElement</a> {
attribute unsigned long <a href="#dom-tdth-colspan" title="dom-tdth-colSpan">colSpan</a>;
attribute unsigned long <a href="#dom-tdth-rowspan" title="dom-tdth-rowSpan">rowSpan</a>;
- [PutForwards=<a href="common-dom-interfaces.html#dom-domsettabletokenlist-value" title="dom-DOMSettableTokenList-value">value</a>] readonly attribute <a href="common-dom-interfaces.html#domsettabletokenlist">DOMSettableTokenList</a> <a href="#dom-tdth-headers" title="dom-tdth-headers">headers</a>;
+ [PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <a href="infrastructure.html#domsettabletokenlist">DOMSettableTokenList</a> <a href="#dom-tdth-headers" title="dom-tdth-headers">headers</a>;
readonly attribute long <a href="#dom-tdth-cellindex" title="dom-tdth-cellIndex">cellIndex</a>;
};</pre><dl class="domintro"><dt><var title="">cell</var> . <code title="dom-tdth-cellIndex"><a href="#dom-tdth-cellindex">cellIndex</a></code></dt>
Index: the-iframe-element.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/the-iframe-element.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- the-iframe-element.html 17 Jun 2011 08:49:08 -0000 1.14
+++ the-iframe-element.html 24 Aug 2011 07:56:05 -0000 1.15
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
[...1617 lines suppressed...]
</dd>
@@ -7445,7 +7746,7 @@
<p>Returns the time for the end of the range with the given index.</p>
- <p>Throws an <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> if the index is out of range.</p>
+ <p>Throws an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> if the index is out of range.</p>
</dd>
@@ -7464,7 +7765,7 @@
the object, in seconds measured from the start of the timeline that
the object covers.</p>
- <p>These methods must raise <code><a href="common-dom-interfaces.html#index_size_err">INDEX_SIZE_ERR</a></code> exceptions
+ <p>These methods must raise <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exceptions
if called with an <var title="">index</var> argument greater than or
equal to the number of ranges represented by the object.</p>
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/Overview.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -d -r1.18 -r1.19
--- Overview.html 17 Jun 2011 08:49:02 -0000 1.18
+++ Overview.html 24 Aug 2011 07:56:02 -0000 1.19
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
[...9593 lines suppressed...]
+ Leonard Rosenthol,
Leons Petrazickis,
Lobotom Dysmon,
Logan,
@@ -72118,6 +72873,7 @@
Philip Jägenstedt,
Philip Taylor,
Philip TAYLOR,
+ Philippe De Ryck,
Prateek Rungta,
Pravir Gupta,
Rachid Finge,
@@ -72138,6 +72894,7 @@
Riona Macnamara,
Rob Ennals,
Rob Jellinghaus,
+ Rob S,
Robert Blaut,
Robert Collins,
Robert O'Callahan,
Index: the-end.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/the-end.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- the-end.html 17 Jun 2011 08:49:08 -0000 1.14
+++ the-end.html 24 Aug 2011 07:56:05 -0000 1.15
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -405,6 +408,10 @@
for these <a href="webappapis.html#concept-task" title="concept-task">tasks</a> is the
<a href="webappapis.html#networking-task-source">networking task source</a>.</p></li>
+ <li><p>If the <code><a href="infrastructure.html#document">Document</a></code>'s <a href="timers.html#print-when-loaded">print when
+ loaded</a> flag is set, then run the <a href="timers.html#printing-steps">printing
+ steps</a>.</p></li>
+
<li><p>The <code><a href="infrastructure.html#document">Document</a></code> is now <dfn id="ready-for-post-load-tasks">ready for post-load
tasks</dfn>.</p></li>
@@ -497,8 +504,8 @@
<p>If the tool has no way to convey out-of-band information, then
the tool may drop the following information:</p>
- <ul><li>Whether the document is set to <i><a href="dom.html#no-quirks-mode">no-quirks mode</a></i>,
- <i><a href="dom.html#limited-quirks-mode">limited-quirks mode</a></i>, or <i><a href="dom.html#quirks-mode">quirks mode</a></i></li>
+ <ul><li>Whether the document is set to <i><a href="infrastructure.html#no-quirks-mode">no-quirks mode</a></i>,
+ <i><a href="infrastructure.html#limited-quirks-mode">limited-quirks mode</a></i>, or <i><a href="infrastructure.html#quirks-mode">quirks mode</a></i></li>
<li>The association between form controls and forms that aren't
their nearest <code><a href="forms.html#the-form-element">form</a></code> element ancestor (use of the
@@ -995,7 +1002,7 @@
</dl><p>Other node types (e.g. <code title="">Attr</code>) cannot
occur as children of elements. If, despite this, they somehow do
occur, this algorithm must raise an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception.</p>
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception.</p>
</li>
@@ -1030,11 +1037,11 @@
<p>This can enable cross-site scripting attacks. An example of this
would be a page that lets the user enter some font names that are
then inserted into a CSS <code><a href="semantics.html#the-style-element">style</a></code> block via the DOM and
- which then uses the <code title="dom-innerHTML"><a href="apis-in-html-documents.html#dom-innerhtml">innerHTML</a></code>
+ which then uses the <code title="dom-innerHTML"><a href="content-models.html#dom-innerhtml">innerHTML</a></code>
IDL attribute to get the HTML serialization of that
<code><a href="semantics.html#the-style-element">style</a></code> element: if the user enters
"<code></style><script>attack</script></code>" as a font
- name, <code title="dom-innerHTML"><a href="apis-in-html-documents.html#dom-innerhtml">innerHTML</a></code> will return
+ name, <code title="dom-innerHTML"><a href="content-models.html#dom-innerhtml">innerHTML</a></code> will return
markup that, if parsed in a different context, would contain a
<code><a href="scripting-1.html#the-script-element">script</a></code> node, even though no <code><a href="scripting-1.html#the-script-element">script</a></code> node
existed in the original DOM.</p>
@@ -1079,7 +1086,7 @@
<ol><li>
<p>Create a new <code><a href="infrastructure.html#document">Document</a></code> node, and mark it as being
- an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>.</p>
+ an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>.</p>
</li>
@@ -1087,12 +1094,12 @@
<p>If there is a <var title="concept-frag-parse-context"><a href="#concept-frag-parse-context">context</a></var> element, and the
<code><a href="infrastructure.html#document">Document</a></code> of the <var title="concept-frag-parse-context"><a href="#concept-frag-parse-context">context</a></var> element is in
- <a href="dom.html#quirks-mode">quirks mode</a>, then let the <code><a href="infrastructure.html#document">Document</a></code> be in
- <a href="dom.html#quirks-mode">quirks mode</a>. Otherwise, if there is a <var title="concept-frag-parse-context"><a href="#concept-frag-parse-context">context</a></var> element, and the
+ <a href="infrastructure.html#quirks-mode">quirks mode</a>, then let the <code><a href="infrastructure.html#document">Document</a></code> be in
+ <a href="infrastructure.html#quirks-mode">quirks mode</a>. Otherwise, if there is a <var title="concept-frag-parse-context"><a href="#concept-frag-parse-context">context</a></var> element, and the
<code><a href="infrastructure.html#document">Document</a></code> of the <var title="concept-frag-parse-context"><a href="#concept-frag-parse-context">context</a></var> element is in
- <a href="dom.html#limited-quirks-mode">limited-quirks mode</a>, then let the
- <code><a href="infrastructure.html#document">Document</a></code> be in <a href="dom.html#limited-quirks-mode">limited-quirks mode</a>.
- Otherwise, leave the <code><a href="infrastructure.html#document">Document</a></code> in <a href="dom.html#no-quirks-mode">no-quirks
+ <a href="infrastructure.html#limited-quirks-mode">limited-quirks mode</a>, then let the
+ <code><a href="infrastructure.html#document">Document</a></code> be in <a href="infrastructure.html#limited-quirks-mode">limited-quirks mode</a>.
+ Otherwise, leave the <code><a href="infrastructure.html#document">Document</a></code> in <a href="infrastructure.html#no-quirks-mode">no-quirks
mode</a>.</p>
</li>
Index: history.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/history.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- history.html 17 Jun 2011 08:49:06 -0000 1.14
+++ history.html 24 Aug 2011 07:56:04 -0000 1.15
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -394,7 +397,12 @@
history by that document.</p><p><dfn id="an-entry-with-persisted-user-state">An entry with persisted user state</dfn> is one that also
has user-agent defined state. This specification does not specify
what kind of state can be stored.</p><p class="example">For example, some user agents might want to
- persist the scroll position, or the values of form controls.</p><p>Entries that consist of <a href="#state-object" title="state object">state
+ persist the scroll position, or the values of form controls.</p><p class="note">User agents that persist the value of form controls
+ are encouraged to also persist their directionality (the value of
+ the element's <code title="attr-dir"><a href="elements.html#the-dir-attribute">dir</a></code> attribute). This
+ prevents values from being displayed incorrectly after a history
+ traversal when the user had originally entered the values with an
+ explicit, non-default directionality.</p><p>Entries that consist of <a href="#state-object" title="state object">state
objects</a> share the same <code><a href="infrastructure.html#document">Document</a></code> as the entry for
the page that was active when they were added.</p><p>Contiguous entries that differ just by fragment identifier also
share the same <code><a href="infrastructure.html#document">Document</a></code>.</p><p class="note">All entries that share the same
@@ -419,11 +427,11 @@
</div><h4 id="the-history-interface"><span class="secno">5.4.2 </span>The <code><a href="#history-0">History</a></code> interface</h4><pre class="idl">interface <dfn id="history-0">History</dfn> {
readonly attribute long <a href="#dom-history-length" title="dom-history-length">length</a>;
readonly attribute any <a href="#dom-history-state" title="dom-history-state">state</a>;
- void <a href="#dom-history-go" title="dom-history-go">go</a>(in optional long delta);
+ void <a href="#dom-history-go" title="dom-history-go">go</a>(optional long delta);
void <a href="#dom-history-back" title="dom-history-back">back</a>();
void <a href="#dom-history-forward" title="dom-history-forward">forward</a>();
- void <a href="#dom-history-pushstate" title="dom-history-pushState">pushState</a>(in any data, in DOMString title, in optional DOMString url);
- void <a href="#dom-history-replacestate" title="dom-history-replaceState">replaceState</a>(in any data, in DOMString title, in optional DOMString url);
+ void <a href="#dom-history-pushstate" title="dom-history-pushState">pushState</a>(any data, DOMString title, optional DOMString url);
+ void <a href="#dom-history-replacestate" title="dom-history-replaceState">replaceState</a>(any data, DOMString title, optional DOMString url);
};</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-history"><a href="#dom-history">history</a></code> . <code title="dom-history-length"><a href="#dom-history-length">length</a></code></dt>
<dd>
@@ -603,19 +611,19 @@
<ol><li><a href="urls.html#resolve-a-url" title="resolve a url">Resolve</a> the value of the
third argument, relative to the <a href="browsers.html#entry-script">entry script</a>'s <a href="webappapis.html#script-s-base-url" title="script's base URL">base URL</a>.</li>
- <li>If that fails, raise a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception
+ <li>If that fails, raise a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception
and abort these steps.</li>
<li>Compare the resulting <a href="urls.html#absolute-url">absolute URL</a> to <a href="dom.html#the-document-s-address">the
document's address</a>. If any part of these two <a href="urls.html#url" title="URL">URLs</a> differ other than the <a href="urls.html#url-path" title="url-path"><path></a>, <a href="urls.html#url-query" title="url-query"><query></a>, and <a href="urls.html#url-fragment" title="url-fragment"><fragment></a> components, then
- raise a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception and abort these
+ raise a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception and abort these
steps.</li>
<li>If the <a href="origin-0.html#origin">origin</a> of the resulting <a href="urls.html#absolute-url">absolute
URL</a> is not the same as the <a href="origin-0.html#origin">origin</a> of the
<a href="browsers.html#entry-script">entry script</a>'s <a href="webappapis.html#script-s-document" title="script's document">document</a>, and either the <a href="urls.html#url-path" title="url-path"><path></a> or <a href="urls.html#url-query" title="url-query"><query></a> components of the two
<a href="urls.html#url" title="URL">URLs</a> compared in the previous step
- differ, raise a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception and abort
+ differ, raise a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception and abort
these steps. (This prevents sandboxed content from spoofing other
pages on the same origin.)</li>
@@ -672,6 +680,12 @@
</ol></li>
+ <li><p>If the <a href="#current-entry">current entry</a> in the session history
+ represents a non-GET request (e.g. it was the result of a POST
+ submission) then update it to instead represent a GET request
+ (<a href="fetching-resources.html#concept-http-equivalent-get" title="concept-http-equivalent-get">or
+ equivalent</a>).</p></li>
+
<li>
<p>If the third argument is present, set <a href="dom.html#the-document-s-current-address">the document's
@@ -824,8 +838,8 @@
<a href="browsers.html#browsing-context">browsing context</a>'s session history to be changed, by
adding or replacing entries in the <code title="dom-history"><a href="#dom-history">history</a></code> object.</p><pre class="idl">interface <dfn id="location">Location</dfn> {
stringifier attribute DOMString <a href="#dom-location-href" title="dom-location-href">href</a>;
- void <a href="#dom-location-assign" title="dom-location-assign">assign</a>(in DOMString url);
- void <a href="#dom-location-replace" title="dom-location-replace">replace</a>(in DOMString url);
+ void <a href="#dom-location-assign" title="dom-location-assign">assign</a>(DOMString url);
+ void <a href="#dom-location-replace" title="dom-location-replace">replace</a>(DOMString url);
void <a href="#dom-location-reload" title="dom-location-reload">reload</a>();
// <a href="urls.html#url-decomposition-idl-attributes">URL decomposition IDL attributes</a>
@@ -838,7 +852,7 @@
attribute DOMString <a href="#dom-location-hash" title="dom-location-hash">hash</a>;
// resolving relative URLs
- DOMString <a href="#dom-location-resolveurl" title="dom-location-resolveURL">resolveURL</a>(in DOMString url);
+ DOMString <a href="#dom-location-resolveurl" title="dom-location-resolveURL">resolveURL</a>(DOMString url);
};</pre><dl class="domintro"><dt><var title="">location</var> . <code title="dom-location-href"><a href="#dom-location-href">href</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -921,7 +935,7 @@
<p>If the <a href="urls.html#resolve-a-url" title="resolve a url">resolving</a> step of the
<code title="dom-location-assign"><a href="#dom-location-assign">assign()</a></code> and <code title="dom-location-replace"><a href="#dom-location-replace">replace()</a></code> methods is not
successful, then the user agent must instead throw a
- <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception.</p>
+ <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception.</p>
<p>When the <dfn id="dom-location-reload" title="dom-location-reload"><code>reload()</code></dfn> method is
invoked, the user agent must run the appropriate steps from the
@@ -981,14 +995,14 @@
<hr/><p>The <dfn id="dom-location-resolveurl" title="dom-location-resolveURL"><code>resolveURL(<var title="">url</var>)</code></dfn> method must <a href="urls.html#resolve-a-url" title="resolve a url">resolve</a> its <var title="">url</var> argument, relative
to the <a href="browsers.html#entry-script">entry script</a>'s <a href="webappapis.html#script-s-base-url" title="script's base URL">base URL</a>, and if that succeeds, return the resulting
<a href="urls.html#absolute-url">absolute URL</a>. If it fails, it must throw a
- <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception instead.</p>
+ <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception instead.</p>
</div><div class="impl">
<h5 id="security-location"><span class="secno">5.4.3.1 </span>Security</h5>
<p id="security-3">User agents must raise a
- <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception whenever any of the members of a
+ <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception whenever any of the members of a
<code><a href="#location">Location</a></code> object are accessed by scripts whose
<a href="origin-0.html#effective-script-origin">effective script origin</a> is not the <a href="origin-0.html#same-origin" title="same origin">same</a> as the <code><a href="#location">Location</a></code> object's associated
<code><a href="infrastructure.html#document">Document</a></code>'s <a href="origin-0.html#effective-script-origin">effective script origin</a>, with
@@ -1251,7 +1265,16 @@
origin</a> as the original resource, or the resource is being
obtained using the POST method or a safe method (in HTTP terms),
return to <a href="#navigate-fragid-step">the step labeled
- "fragment identifiers"</a> with the new resource.</p>
+ "fragment identifiers"</a> with the new resource, except that if
+ the <a href="urls.html#url">URL</a> of the target of the redirect does not have a
+ fragment identifier and the <a href="urls.html#url">URL</a> of the resource that
+ led to the redirect does, then the fragment identifier of the
+ resource that led to the redirect must be propagated to the
+ <a href="urls.html#url">URL</a> of the target of the redirect.</p>
+
+ <p class="example">So for instance, if the original URL was "<code title="">http://example.com/#!sample</code>" and "<code title="">http://example.com/</code>" is found to redirect to
+ "<code title="">https://example.com/</code>", the URL of the new
+ resource will be "<code title="">https://example.com/#!sample</code>".</p>
<p>Otherwise, if fetching the resource results in a redirect but
the <a href="urls.html#url">URL</a> of the target of the redirect does not have
@@ -1300,19 +1323,26 @@
</li>
- <li><p>If the document's out-of-band metadata (e.g. HTTP headers),
- not counting any <a href="fetching-resources.html#content-type" title="Content-Type">type information</a>
- (such as the Content-Type HTTP header), requires some sort of
- processing that will not affect the browsing context, then perform
- that processing and abort these steps.</p>
+ <li>
+
+ <p>If the document's out-of-band metadata (e.g. HTTP headers), not
+ counting any <a href="fetching-resources.html#content-type" title="Content-Type">type information</a>
+ (such as the Content-Type HTTP header), requires some sort of
+ processing that will not affect the browsing context, then perform
+ that processing and abort these steps.</p>
+
+ <div class="note">
+ <p>Such processing might be triggered by, amongst other things, the
+ following:</p>
+ <ul class="brief"><li>HTTP status codes (e.g. 204 No Content or 205 Reset Content)</li>
+ <li>Network errors (e.g. the network interface being unavailable)</li>
+ <li>Cryptographic protocol failures (e.g. an incorrect TLS certificate)</li>
+
+
+
+
+ </ul></div>
- <div class="note">
- <p>Such processing might be triggered by, amongst other things, the
- following:</p>
- <ul class="brief"><li>HTTP status codes (e.g. 204 No Content or 205 Reset Content)</li>
- <li>HTTP Content-Disposition headers</li>
- <li>Network errors</li>
- </ul></div>
<p>HTTP 401 responses that do not include a challenge recognized
@@ -1321,7 +1351,7 @@
OK.</p>
<p>User agents may show the entity body of an HTTP 401 response
- even when the response do include a recognized challenge, with the
+ even when the response does include a recognized challenge, with the
option to login being included in a non-modal fashion, to enable
the information provided by the server to be used by the user
before authenticating. Similarly, user agents should allow the
@@ -1526,14 +1556,12 @@
<p>When an HTML document is to be loaded in a <a href="browsers.html#browsing-context">browsing
context</a>, the user agent must <a href="webappapis.html#queue-a-task">queue a task</a> to
<a href="#create-a-document-object">create a <code>Document</code> object</a>, mark it as being
- an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, create an
- <a href="parsing.html#html-parser">HTML parser</a>, and associate it with the document. Each
- <a href="webappapis.html#concept-task" title="concept-task">task</a> that the <a href="webappapis.html#networking-task-source">networking
- task source</a> places on the <a href="webappapis.html#task-queue">task queue</a> while the
- <a href="fetching-resources.html#fetch" title="fetch">fetching algorithm</a> runs must then fill
- the parser's <a href="parsing.html#the-input-stream">input stream</a> with the fetched bytes and
- cause the <a href="parsing.html#html-parser">HTML parser</a> to perform the appropriate
- processing of the input stream.</p>
+ an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, set its <a href="infrastructure.html#concept-document-media-type" title="concept-document-media-type">media type</a> to "<code title="">text/html</code>", create an <a href="parsing.html#html-parser">HTML parser</a>, and
+ associate it with the document. Each <a href="webappapis.html#concept-task" title="concept-task">task</a> that the <a href="webappapis.html#networking-task-source">networking task
+ source</a> places on the <a href="webappapis.html#task-queue">task queue</a> while the <a href="fetching-resources.html#fetch" title="fetch">fetching algorithm</a> runs must then fill the
+ parser's <a href="parsing.html#the-input-stream">input stream</a> with the fetched bytes and cause
+ the <a href="parsing.html#html-parser">HTML parser</a> to perform the appropriate processing
+ of the input stream.</p>
<p class="note">The <a href="parsing.html#the-input-stream">input stream</a> converts bytes into
characters for use in the <a href="tokenization.html#tokenization" title="tokenization">tokenizer</a>. This process relies, in part,
@@ -1564,14 +1592,14 @@
<p>When faced with displaying an XML file inline, user agents must
first <a href="#create-a-document-object">create a <code>Document</code> object</a>, following
the requirements of the XML and Namespaces in XML recommendations,
- RFC 3023, DOM3 Core, and other relevant specifications. <a href="references.html#refsXML">[XML]</a> <a href="references.html#refsXMLNS">[XMLNS]</a> <a href="references.html#refsRFC3023">[RFC3023]</a> <a href="references.html#refsDOMCORE">[DOMCORE]</a></p>
+ RFC 3023, DOM Core, and other relevant specifications. <a href="references.html#refsXML">[XML]</a> <a href="references.html#refsXMLNS">[XMLNS]</a> <a href="references.html#refsRFC3023">[RFC3023]</a> <a href="references.html#refsDOMCORE">[DOMCORE]</a></p>
<p>The actual HTTP headers and other metadata, not the headers as
mutated or implied by the algorithms given in this specification,
are the ones that must be used when determining the character
encoding according to the rules given in the above
specifications. Once the character encoding is established, the
- <a href="dom.html#document-s-character-encoding">document's character encoding</a> must be set to that
+ <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a> must be set to that
character encoding.</p>
<p>If the root element, as parsed according to the XML
@@ -1621,22 +1649,24 @@
<p>When a plain text document is to be loaded in a <a href="browsers.html#browsing-context">browsing
context</a>, the user agent should <a href="webappapis.html#queue-a-task">queue a task</a> to
<a href="#create-a-document-object">create a <code>Document</code> object</a>, mark it as being
- an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, create an
- <a href="parsing.html#html-parser">HTML parser</a>, associate it with the document, act as if
- the tokenizer had emitted a start tag token with the tag name "pre"
- followed by a single U+000A LINE FEED (LF) character, and switch the <a href="parsing.html#html-parser">HTML parser</a>'s tokenizer
- to the <a href="tokenization.html#plaintext-state">PLAINTEXT state</a>. Each <a href="webappapis.html#concept-task" title="concept-task">task</a> that the <a href="webappapis.html#networking-task-source">networking task
- source</a> places on the <a href="webappapis.html#task-queue">task queue</a> while the <a href="fetching-resources.html#fetch" title="fetch">fetching algorithm</a> runs must then fill the
- parser's <a href="parsing.html#the-input-stream">input stream</a> with the fetched bytes and cause
- the <a href="parsing.html#html-parser">HTML parser</a> to perform the appropriate processing
- of the input stream.</p>
+ an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, set its <a href="infrastructure.html#concept-document-media-type" title="concept-document-media-type">media type</a> to "<code title="">text/plain</code>", create an <a href="parsing.html#html-parser">HTML parser</a>,
+ associate it with the document, act as if the tokenizer had emitted
+ a start tag token with the tag name "pre" followed by a single
+ U+000A LINE FEED (LF) character, and switch
+ the <a href="parsing.html#html-parser">HTML parser</a>'s tokenizer to the <a href="tokenization.html#plaintext-state">PLAINTEXT
+ state</a>. Each <a href="webappapis.html#concept-task" title="concept-task">task</a> that the
+ <a href="webappapis.html#networking-task-source">networking task source</a> places on the <a href="webappapis.html#task-queue">task
+ queue</a> while the <a href="fetching-resources.html#fetch" title="fetch">fetching algorithm</a>
+ runs must then fill the parser's <a href="parsing.html#the-input-stream">input stream</a> with the
+ fetched bytes and cause the <a href="parsing.html#html-parser">HTML parser</a> to perform the
+ appropriate processing of the input stream.</p>
<p>The rules for how to convert the bytes of the plain text document
into actual characters, and the rules for actually rendering the
text to the user, are defined in RFC 2046, RFC 3676, and subsequent
versions thereof. <a href="references.html#refsRFC2046">[RFC2046]</a> <a href="references.html#refsRFC3676">[RFC3676]</a></p>
- <p>The <a href="dom.html#document-s-character-encoding">document's character encoding</a> must be set to the
+ <p>The <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a> must be set to the
character encoding used to decode the document.</p>
<p>Upon creation of the <code><a href="infrastructure.html#document">Document</a></code> object, the user agent
@@ -1672,12 +1702,14 @@
<p>When an image resource is to be loaded in a <a href="browsers.html#browsing-context">browsing
context</a>, the user agent should <a href="#create-a-document-object">create a
- <code>Document</code> object</a>, mark it as being an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, append an
- <code><a href="semantics.html#the-html-element">html</a></code> element to the <code><a href="infrastructure.html#document">Document</a></code>, append a
- <code><a href="semantics.html#the-head-element">head</a></code> element and a <code><a href="sections.html#the-body-element">body</a></code> element to the
- <code><a href="semantics.html#the-html-element">html</a></code> element, append an <code><a href="embedded-content-1.html#the-img-element">img</a></code> to the
- <code><a href="sections.html#the-body-element">body</a></code> element, and set the <code title="attr-img-src"><a href="embedded-content-1.html#attr-img-src">src</a></code> attribute of the <code><a href="embedded-content-1.html#the-img-element">img</a></code>
- element to the address of the image.</p>
+ <code>Document</code> object</a>, mark it as being an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, set its <a href="infrastructure.html#concept-document-media-type" title="concept-document-media-type">media type</a> to the sniffed
+ MIME type of the resource (<var title="">type</var> in the
+ <a href="#navigate">navigate</a> algorithm), append an <code><a href="semantics.html#the-html-element">html</a></code>
+ element to the <code><a href="infrastructure.html#document">Document</a></code>, append a <code><a href="semantics.html#the-head-element">head</a></code>
+ element and a <code><a href="sections.html#the-body-element">body</a></code> element to the <code><a href="semantics.html#the-html-element">html</a></code>
+ element, append an <code><a href="embedded-content-1.html#the-img-element">img</a></code> to the <code><a href="sections.html#the-body-element">body</a></code>
+ element, and set the <code title="attr-img-src"><a href="embedded-content-1.html#attr-img-src">src</a></code> attribute
+ of the <code><a href="embedded-content-1.html#the-img-element">img</a></code> element to the address of the image.</p>
<p>Then, the user agent must act as if it had <a href="the-end.html#stop-parsing" title="stop parsing">stopped parsing</a>.</p>
@@ -1702,12 +1734,16 @@
<p>When a resource that requires an external resource to be rendered
is to be loaded in a <a href="browsers.html#browsing-context">browsing context</a>, the user agent
should <a href="#create-a-document-object">create a <code>Document</code> object</a>, mark it
- as being an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>,
- append an <code><a href="semantics.html#the-html-element">html</a></code> element to the <code><a href="infrastructure.html#document">Document</a></code>,
- append a <code><a href="semantics.html#the-head-element">head</a></code> element and a <code><a href="sections.html#the-body-element">body</a></code> element
- to the <code><a href="semantics.html#the-html-element">html</a></code> element, append an <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> to
- the <code><a href="sections.html#the-body-element">body</a></code> element, and set the <code title="attr-embed-src"><a href="the-iframe-element.html#attr-embed-src">src</a></code> attribute of the
- <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> element to the address of the resource.</p>
+ as being an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, set
+ its <a href="infrastructure.html#concept-document-media-type" title="concept-document-media-type">media type</a> to
+ the sniffed MIME type of the resource (<var title="">type</var> in
+ the <a href="#navigate">navigate</a> algorithm), append an <code><a href="semantics.html#the-html-element">html</a></code>
+ element to the <code><a href="infrastructure.html#document">Document</a></code>, append a <code><a href="semantics.html#the-head-element">head</a></code>
+ element and a <code><a href="sections.html#the-body-element">body</a></code> element to the <code><a href="semantics.html#the-html-element">html</a></code>
+ element, append an <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> to the <code><a href="sections.html#the-body-element">body</a></code>
+ element, and set the <code title="attr-embed-src"><a href="the-iframe-element.html#attr-embed-src">src</a></code>
+ attribute of the <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> element to the address of the
+ resource.</p>
<p>Then, the user agent must act as if it had <a href="the-end.html#stop-parsing" title="stop parsing">stopped parsing</a>.</p>
@@ -1736,11 +1772,11 @@
<p>When the user agent is to display a user agent page inline in a
<a href="browsers.html#browsing-context">browsing context</a>, the user agent should <a href="#create-a-document-object">create a
- <code>Document</code> object</a>, mark it as being an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, and then either
- associate that <code><a href="infrastructure.html#document">Document</a></code> with a custom rendering that is
- not rendered using the normal <code><a href="infrastructure.html#document">Document</a></code> rendering rules,
- or mutate that <code><a href="infrastructure.html#document">Document</a></code> until it represents the content
- the user agent wants to render.</p>
+ <code>Document</code> object</a>, mark it as being an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, set its <a href="infrastructure.html#concept-document-media-type" title="concept-document-media-type">media type</a> to "<code title="">text/html</code>", and then either associate that
+ <code><a href="infrastructure.html#document">Document</a></code> with a custom rendering that is not rendered
+ using the normal <code><a href="infrastructure.html#document">Document</a></code> rendering rules, or mutate
+ that <code><a href="infrastructure.html#document">Document</a></code> until it represents the content the user
+ agent wants to render.</p>
<p>Once the page has been set up, the user agent must act as if it
@@ -2016,7 +2052,7 @@
is fired in certain cases when navigating to a <a href="#session-history-entry">session history
entry</a>.</p><pre class="idl">interface <dfn id="popstateevent">PopStateEvent</dfn> : <a href="infrastructure.html#event">Event</a> {
readonly attribute any <a href="#dom-popstateevent-state" title="dom-PopStateEvent-state">state</a>;
- void <a href="#dom-popstateevent-initpopstateevent" title="dom-PopStateEvent-initPopStateEvent">initPopStateEvent</a>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any stateArg);
+ void <a href="#dom-popstateevent-initpopstateevent" title="dom-PopStateEvent-initPopStateEvent">initPopStateEvent</a>(DOMString typeArg, boolean canBubbleArg, boolean cancelableArg, any stateArg);
};</pre><dl class="domintro"><dt><var title="">event</var> . <code title="dom-PopStateEvent-state"><a href="#dom-popstateevent-state">state</a></code></dt>
<dd>
@@ -2042,7 +2078,7 @@
previous one only in the fragment identifier.</p><pre class="idl">interface <dfn id="hashchangeevent">HashChangeEvent</dfn> : <a href="infrastructure.html#event">Event</a> {
readonly attribute DOMString <a href="#dom-hashchangeevent-oldurl" title="dom-HashChangeEvent-oldURL">oldURL</a>;
readonly attribute DOMString <a href="#dom-hashchangeevent-newurl" title="dom-HashChangeEvent-newURL">newURL</a>;
- void <a href="#dom-hashchangeevent-inithashchangeevent" title="dom-HashChangeEvent-initHashChangeEvent">initHashChangeEvent</a>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMString oldURLArg, in DOMString newURLArg);
+ void <a href="#dom-hashchangeevent-inithashchangeevent" title="dom-HashChangeEvent-initHashChangeEvent">initHashChangeEvent</a>(DOMString typeArg, boolean canBubbleArg, boolean cancelableArg, DOMString oldURLArg, DOMString newURLArg);
};</pre><dl class="domintro"><dt><var title="">event</var> . <code title="dom-HashChangeEvent-oldURL"><a href="#dom-hashchangeevent-oldurl">oldURL</a></code></dt>
<dd>
@@ -2084,7 +2120,7 @@
event is fired when traversing <em>from</em> a <a href="#session-history-entry">session history
entry</a>.</p><pre class="idl">interface <dfn id="pagetransitionevent">PageTransitionEvent</dfn> : <a href="infrastructure.html#event">Event</a> {
readonly attribute boolean <a href="#dom-pagetransitionevent-persisted" title="dom-PageTransitionEvent-persisted">persisted</a>;
- void <a href="#dom-pagetransitionevent-initpagetransitionevent" title="dom-PageTransitionEvent-initPageTransitionEvent">initPageTransitionEvent</a>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in boolean persistedArg);
+ void <a href="#dom-pagetransitionevent-initpagetransitionevent" title="dom-PageTransitionEvent-initPageTransitionEvent">initPageTransitionEvent</a>(DOMString typeArg, boolean canBubbleArg, boolean cancelableArg, boolean persistedArg);
};</pre><dl class="domintro"><dt><var title="">event</var> . <code title="dom-PageTransitionEvent-persisted"><a href="#dom-pagetransitionevent-persisted">persisted</a></code></dt>
<dd>
@@ -2176,7 +2212,7 @@
</ol><p>When a user agent is to <dfn id="unload-a-document">unload a document</dfn>, it must run
the following steps. These steps are passed an argument, <var title="">recycle</var>, which is either true or false, indicating
whether the <code><a href="infrastructure.html#document">Document</a></code> object is going to be
- re-used. (This is set by the <code title="dom-document-open"><a href="apis-in-html-documents.html#dom-document-open">document.open()</a></code> method.)</p>
+ re-used. (This is set by the <code title="dom-document-open"><a href="content-models.html#dom-document-open">document.open()</a></code> method.)</p>
<ol><li><p>Fire a <code title="event-pagehide"><a href="#event-pagehide">pagehide</a></code> event at
the <code><a href="browsers.html#window">Window</a></code> object of the <code><a href="infrastructure.html#document">Document</a></code>, but
Index: common-dom-interfaces.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/common-dom-interfaces.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- common-dom-interfaces.html 17 Jun 2011 08:49:05 -0000 1.13
+++ common-dom-interfaces.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -325,7 +328,7 @@
<a href="namespaces.html" class="next">2.9 Namespaces</a>
<ol class="toc"><li><ol><li><a href="common-dom-interfaces.html#common-dom-interfaces"><span class="secno">2.8 </span>Common DOM interfaces</a>
<ol><li><a href="common-dom-interfaces.html#reflecting-content-attributes-in-idl-attributes"><span class="secno">2.8.1 </span>Reflecting content attributes in IDL attributes</a></li><li><a href="common-dom-interfaces.html#collections-0"><span class="secno">2.8.2 </span>Collections</a>
- <ol><li><a href="common-dom-interfaces.html#htmlcollection-0"><span class="secno">2.8.2.1 </span>HTMLCollection</a></li><li><a href="common-dom-interfaces.html#htmlallcollection-0"><span class="secno">2.8.2.2 </span>HTMLAllCollection</a></li><li><a href="common-dom-interfaces.html#htmlformcontrolscollection-0"><span class="secno">2.8.2.3 </span>HTMLFormControlsCollection</a></li><li><a href="common-dom-interfaces.html#htmloptionscollection-0"><span class="secno">2.8.2.4 </span>HTMLOptionsCollection</a></li></ol></li><li><a href="common-dom-interfaces.html#domtokenlist-0"><span class="secno">2.8.3 </span>DOMTokenList</a></li><li><a href="common-dom-interfaces.html#domsettabletokenlist-0"><span class="secno">2.8.4 </span>DOMSettableTokenList</a></li><li><a href="common-dom-interfaces.html#safe-passing-of-structured-data"><span class="secno">2.8.5 </span>Safe passing of structured data</a></li><li><a href="common-dom-interfaces.html#domstringmap-0"><span class="secno">2.8.6 </span>DOMStringMap</a></li><i><a href="common-dom-interfaces.html#dom-feature-strings"><span class="secno">2.8.7 </span>DOM feature strings</a></li><li><a href="common-dom-interfaces.html#exceptions"><span class="secno">2.8.8 </span>Exceptions</a></li><li><a href="common-dom-interfaces.html#garbage-collection"><span class="secno">2.8.9 </span>Garbage collection</a></li></ol></li></ol></li></ol></div><h3 id="common-dom-interfaces"><span class="secno">2.8 </span>Common DOM interfaces</h3><h4 id="reflecting-content-attributes-in-idl-attributes"><span class="secno">2.8.1 </span>Reflecting content attributes in IDL attributes</h4><p>Some IDL attributes are defined to <dfn id="reflect">reflect</dfn> a
+ <ol><li><a href="common-dom-interfaces.html#htmlallcollection-0"><span class="secno">2.8.2.1 </span>HTMLAllCollection</a></li><li><a href="common-dom-interfaces.html#htmlformcontrolscollection-0"><span class="secno">2.8.2.2 </span>HTMLFormControlsCollection</a></li><li><a href="common-dom-interfaces.html#htmloptionscollection-0"><span class="secno">2.8.2.3 </span>HTMLOptionsCollection</a></li></ol></li><li><a href="common-dom-interfaces.html#domstringmap-0"><span class="secno">2.8.3 </span>DOMStringMap</a></li><li><a href="common-dom-interfaces.html#transferable-objects"><span class="secno">2.8.4 </span>Transferable objects</a></li><li><a href="common-dom-interfaces.html#safe-passing-of-structured-data"><span class="secno">2.8.5 </span>Safe passing of structured data</a></li><li><a href="common-dom-interfaces.html#dom-feature-strings"><span class="secno">2.8.6 </span>DOM feature strings</a></li><li><a href="common-dom-interfaces.html#garbage-collection"><span class="secno">2.8.7 </span>Garbage collecion</a></li></ol></li></ol></li></ol></div><h3 id="common-dom-interfaces"><span class="secno">2.8 </span>Common DOM interfaces</h3><h4 id="reflecting-content-attributes-in-idl-attributes"><span class="secno">2.8.1 </span>Reflecting content attributes in IDL attributes</h4><p>Some IDL attributes are defined to <dfn id="reflect">reflect</dfn> a
particular content attribute. This means that on getting, the IDL
attribute returns the current value of the content attribute, and on
setting, the IDL attribute changes the value of the content
@@ -402,7 +405,7 @@
value, or if the attribute is absent, the default value must be
returned instead, or −1 if there is no default value. On
setting, if the value is negative, the user agent must throw an
- <code><a href="#index_size_err">INDEX_SIZE_ERR</a></code> exception. Otherwise, the given value
+ <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception. Otherwise, the given value
must be converted to the shortest possible string representing the
number as a <a href="common-microsyntaxes.html#valid-non-negative-integer">valid non-negative integer</a> and then that
string must be used as the new content attribute value.</p>
@@ -431,12 +434,12 @@
fails or returns an out of range value, or if the attribute is
absent, the default value must be returned instead, or 1 if there is
no default value. On setting, if the value is zero, the user agent
- must throw an <code><a href="#index_size_err">INDEX_SIZE_ERR</a></code> exception. Otherwise, the
+ must throw an <code><a href="infrastructure.html#index_size_err">INDEX_SIZE_ERR</a></code> exception. Otherwise, the
given value must be converted to the shortest possible string
representing the number as a <a href="common-microsyntaxes.html#valid-non-negative-integer">valid non-negative integer</a>
and then that string must be used as the new content attribute
value.</p>
-
+
<p>If a reflecting IDL attribute has a floating point number type
(<code>double</code>), then, on getting, the content attribute must
be parsed according to the <a href="common-microsyntaxes.html#rules-for-parsing-floating-point-number-values">rules for parsing floating point
@@ -448,14 +451,30 @@
floating point number</a> and then that string must be used as
the new content attribute value.</p>
+ <p>If a reflecting IDL attribute has a floating point number type
+ (<code>double</code>) that is <dfn id="limited-to-numbers-greater-than-zero">limited to numbers greater than
+ zero</dfn>, then the behavior is similar to the previous case, but
+ zero and negative values are not allowed. On getting, the content
+ attribute must be parsed according to the <a href="common-microsyntaxes.html#rules-for-parsing-floating-point-number-values">rules for parsing
+ floating point number values</a>, and if that is successful and
+ the value is greater than 0.0, the resulting value must be returned.
+ If, on the other hand, it fails or returns an out of range value, or
+ if the attribute is absent, the default value must be returned
+ instead, or 0.0 if there is no default value. On setting, if the
+ value is less than or equal to zero, then the value must be ignored.
+ Otherwise, the given value must be converted to the <a href="common-microsyntaxes.html#best-representation-of-the-number-as-a-floating-point-number">best
+ representation of the number as a floating point number</a> and
+ then that string must be used as the new content attribute
+ value.</p>
+
<p class="note">The values Infinity and Not-a-Number (NaN) values
throw an exception on setting, as <a href="infrastructure.html#float-nan">defined
earlier</a>.</p>
<p>If a reflecting IDL attribute has the type
- <code><a href="#domtokenlist">DOMTokenList</a></code> or <code><a href="#domsettabletokenlist">DOMSettableTokenList</a></code>, then
- on getting it must return a <code><a href="#domtokenlist">DOMTokenList</a></code> or
- <code><a href="#domsettabletokenlist">DOMSettableTokenList</a></code> object (as appropriate) whose
+ <code><a href="infrastructure.html#domtokenlist">DOMTokenList</a></code> or <code><a href="infrastructure.html#domsettabletokenlist">DOMSettableTokenList</a></code>, then
+ on getting it must return a <code><a href="infrastructure.html#domtokenlist">DOMTokenList</a></code> or
+ <code><a href="infrastructure.html#domsettabletokenlist">DOMSettableTokenList</a></code> object (as appropriate) whose
underlying string is the element's corresponding content attribute.
When the object mutates its underlying string, the content attribute
must itself be immediately mutated. When the attribute is absent,
@@ -463,15 +482,15 @@
the object mutates this empty string, the user agent must add the
corresponding content attribute, with its value set to the value it
would have been set to after mutating the empty string. The same
- <code><a href="#domtokenlist">DOMTokenList</a></code> or <code><a href="#domsettabletokenlist">DOMSettableTokenList</a></code>
+ <code><a href="infrastructure.html#domtokenlist">DOMTokenList</a></code> or <code><a href="infrastructure.html#domsettabletokenlist">DOMSettableTokenList</a></code>
object must be returned every time for each attribute.</p>
<div class="example">
- <p>If an element with no attributes has its <code title="dom-tokenlist-remove"><a href="#dom-tokenlist-remove">element.classList.remove()</a></code>
+ <p>If an element with no attributes has its <code title="dom-tokenlist-remove">element.classList.remove()</code>
method invoked, the underlying string won't be changed, since the
result of removing any token from the empty string is still the
- empty string. However, if the <code title="dom-tokenlist-add"><a href="#dom-tokenlist-add">element.classList.add()</a></code> method is
+ empty string. However, if the <code title="dom-tokenlist-add">element.classList.add()</code> method is
then invoked, a <code title="attr-class"><a href="elements.html#classes">class</a></code> attribute
will be added to the element with the value of the token to be
added.</p>
@@ -489,7 +508,7 @@
<li>Let <var title="">candidate</var> be the element that the <code title="dom-Document-getElementById"><a href="infrastructure.html#dom-document-getelementbyid">document.getElementById()</a></code> method
would find when called on the content attribute's document if it
- was passed as its argument the current value of the corresponding
+ were passed as its argument the current value of the corresponding
content attribute.</li>
<li>If <var title="">candidate</var> is null, or if it is not
@@ -500,116 +519,27 @@
</ol><p>On setting, if the given element has an <code title="attr-id"><a href="elements.html#the-id-attribute">id</a></code> attribute, then the content attribute must
be set to the value of that <code title="attr-id"><a href="elements.html#the-id-attribute">id</a></code>
- attribute. Otherwise, the IDL attribute must be set to the empty
+ attribute. Otherwise, the content attribute must be set to the empty
string.</p>
- </div><h4 id="collections-0"><span class="secno">2.8.2 </span>Collections</h4><p>The <code><a href="#htmlcollection">HTMLCollection</a></code>, <code><a href="#htmlallcollection">HTMLAllCollection</a></code>,
+ </div><h4 id="collections-0"><span class="secno">2.8.2 </span>Collections</h4><p>The <code><a href="#htmlallcollection">HTMLAllCollection</a></code>,
<code><a href="#htmlformcontrolscollection">HTMLFormControlsCollection</a></code>,
<code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code>,
- interfaces represent various
- lists of DOM nodes. Collectively, objects implementing these
- interfaces are called <dfn id="collections">collections</dfn>.</p><p>When a <a href="#collections" title="collections">collection</a> is created, a
- filter and a root are associated with the collection.</p><p class="example">For example, when the <code><a href="#htmlcollection">HTMLCollection</a></code>
- object for the <code title="dom-document-images"><a href="dom.html#dom-document-images">document.images</a></code> attribute is
- created, it is associated with a filter that selects only
- <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements, and rooted at the root of the
- document.</p><p>The <a href="#collections" title="collections">collection</a> then <dfn id="represented-by-the-collection" title="represented by the collection">represents</dfn> a
- <a href="infrastructure.html#live">live</a> view of the subtree rooted at the collection's
- root, containing only nodes that match the given filter. The view is
- linear. <span class="impl">In the absence of specific requirements
- to the contrary, the nodes within the collection must be sorted in
- <a href="infrastructure.html#tree-order">tree order</a>.</span></p><div class="impl">
-
- <p class="note">The <code title="dom-table-rows"><a href="tabular-data.html#dom-table-rows">rows</a></code> list is
- not in tree order.</p>
-
- <p>An attribute that returns a collection must return the same
- object every time it is retrieved.</p>
-
- </div><h5 id="htmlcollection-0"><span class="secno">2.8.2.1 </span>HTMLCollection</h5><p>The <code><a href="#htmlcollection">HTMLCollection</a></code> interface represents a generic
- <a href="#collections" title="collections">collection</a> of elements.</p><pre class="idl">interface <dfn id="htmlcollection">HTMLCollection</dfn> {
- readonly attribute unsigned long <a href="#dom-htmlcollection-length" title="dom-HTMLCollection-length">length</a>;
- caller getter <a href="infrastructure.html#element">Element</a>? <a href="#dom-htmlcollection-item" title="dom-HTMLCollection-item">item</a>(in unsigned long index);
- caller getter object? <a href="#dom-htmlcollection-nameditem" title="dom-HTMLCollection-namedItem">namedItem</a>(in DOMString name); // only returns Element
-};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length"><a href="#dom-htmlcollection-length">length</a></code></dt>
- <dd>
- <p>Returns the number of elements in the collection.</p>
- </dd>
-
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item"><a href="#dom-htmlcollection-item">item</a></code>(<var title="">index</var>)</dt>
- <dt><var title="">collection</var>[<var title="">index</var>]</dt>
- <dt><var title="">collection</var>(<var title="">index</var>)</dt>
- <dd>
- <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href="infrastructure.html#tree-order">tree order</a>.</p>
- </dd>
-
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-namedItem"><a href="#dom-htmlcollection-nameditem">namedItem</a></code>(<var title="">name</var>)</dt>
- <dt><var title="">collection</var>[<var title="">name</var>]</dt>
- <dt><var title="">collection</var>(<var title="">name</var>)</dt>
- <dd>
- <p>Returns the first item with <a href="elements.html#concept-id" title="concept-id">ID</a> or name <var title="">name</var>
- from the collection.</p>
- <p>Only <code><a href="text-level-semantics.html#the-a-element">a</a></code>, <code><a href="obsolete.html#the-applet-element">applet</a></code>, <code><a href="the-map-element.html#the-area-element">area</a></code>,
- <code><a href="the-iframe-element.html#the-embed-element">embed</a></code>, <code><a href="forms.html#the-form-element">form</a></code>, <code><a href="obsolete.html#frame">frame</a></code>,
- <code><a href="obsolete.html#frameset">frameset</a></code>, <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code>, <code><a href="embedded-content-1.html#the-img-element">img</a></code>, and
- <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements can have a name for the purpose of
- this method; their name is given by the value of their <code title="">name</code> attribute.</p>
- </dd>
- </dl><div class="impl">
-
- <p>The object's <a href="infrastructure.html#supported-property-indices">supported property indices</a> are the
- numbers in the range zero to one less than the number of nodes
- <a href="#represented-by-the-collection">represented by the collection</a>. If there are no such
- elements, then there are no <a href="infrastructure.html#supported-property-indices">supported property
- indices</a>.</p>
-
- <p>The <dfn id="dom-htmlcollection-length" title="dom-HTMLCollection-length"><code>length</code></dfn>
- attribute must return the number of nodes <a href="#represented-by-the-collection">represented by the
- collection</a>.</p>
-
- <p>The <dfn id="dom-htmlcollection-item" title="dom-HTMLCollection-item"><code>item(<var title="">index</var>)</code></dfn> method must return the <var title="">index</var>th node in the collection. If there is no <var title="">index</var>th node in the collection, then the method must
- return null.</p>
-
- <p>The <a href="infrastructure.html#supported-property-names">supported property names</a> consist
- of the values of the <code title="">name</code> attributes of each
- <code><a href="text-level-semantics.html#the-a-element">a</a></code>, <code><a href="obsolete.html#the-applet-element">applet</a></code>, <code><a href="the-map-element.html#the-area-element">area</a></code>,
- <code><a href="the-iframe-element.html#the-embed-element">embed</a></code>, <code><a href="forms.html#the-form-element">form</a></code>, <code><a href="obsolete.html#frame">frame</a></code>,
- <code><a href="obsolete.html#frameset">frameset</a></code>, <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code>, <code><a href="embedded-content-1.html#the-img-element">img</a></code>, and
- <code><a href="the-iframe-element.html#the-object-element">object</a></code> element <a href="#represented-by-the-collection">represented by the
- collection</a> with a <code title="">name</code> attribute, plus
- the list of IDs that the elements <a href="#represented-by-the-collection">represented by the
- collection</a> have.</p>
-
- <p>The <dfn id="dom-htmlcollection-nameditem" title="dom-HTMLCollection-namedItem"><code>namedItem(<var title="">key</var>)</code></dfn> method must return the first node
- in the collection that matches either of the following
- requirements:</p>
-
- <ul><li>It is an <code><a href="text-level-semantics.html#the-a-element">a</a></code>, <code><a href="obsolete.html#the-applet-element">applet</a></code>,
- <code><a href="the-map-element.html#the-area-element">area</a></code>, <code><a href="the-iframe-element.html#the-embed-element">embed</a></code>, <code><a href="forms.html#the-form-element">form</a></code>,
- <code><a href="obsolete.html#frame">frame</a></code>, <code><a href="obsolete.html#frameset">frameset</a></code>, <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code>,
- <code><a href="embedded-content-1.html#the-img-element">img</a></code>, or <code><a href="the-iframe-element.html#the-object-element">object</a></code> element with a <code title="">name</code> attribute equal to <var title="">key</var>,
- or,</li>
-
- <li>It is an element with an <a href="elements.html#concept-id" title="concept-id">ID</a>
- equal to <var title="">key</var>.</li>
-
- </ul><p>If no such elements are found, then the method must return
- null.</p>
-
- </div><h5 id="htmlallcollection-0"><span class="secno">2.8.2.2 </span>HTMLAllCollection</h5><p>The <code><a href="#htmlallcollection">HTMLAllCollection</a></code> interface represents a generic
- <a href="#collections" title="collections">collection</a> of elements just like
- <code><a href="#htmlcollection">HTMLCollection</a></code>, with the exception that its <code title="dom-HTMLAllCollection-namedItem"><a href="#dom-htmlallcollection-nameditem">namedItem()</a></code> method
+ interfaces are <a href="infrastructure.html#collections">collections</a> derived from the
+ <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> interface.</p><h5 id="htmlallcollection-0"><span class="secno">2.8.2.1 </span>HTMLAllCollection</h5><p>The <code><a href="#htmlallcollection">HTMLAllCollection</a></code> interface represents a generic
+ <a href="infrastructure.html#collections" title="collections">collection</a> of elements just like
+ <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code>, with the exception that its <code title="dom-HTMLAllCollection-namedItem"><a href="#dom-htmlallcollection-nameditem">namedItem()</a></code> method
returns an <code><a href="#htmlallcollection">HTMLAllCollection</a></code> object when there are
- multiple matching elements.</p><pre class="idl">interface <dfn id="htmlallcollection">HTMLAllCollection</dfn> : <a href="#htmlcollection">HTMLCollection</a> {
- // inherits <a href="#dom-htmlcollection-length" title="dom-HTMLCollection-length">length</a> and <a href="#dom-htmlcollection-item" title="dom-HTMLCollection-item">item</a>()
- caller getter object? <a href="#dom-htmlallcollection-nameditem" title="dom-HTMLAllCollection-namedItem">namedItem</a>(in DOMString name); // overrides inherited namedItem()
- <a href="#htmlallcollection">HTMLAllCollection</a> <a href="#dom-htmlallcollection-tags" title="dom-HTMLAllCollection-tags">tags</a>(in DOMString tagName);
-};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length"><a href="#dom-htmlcollection-length">length</a></code></dt>
+ multiple matching elements.</p><pre class="idl">interface <dfn id="htmlallcollection">HTMLAllCollection</dfn> : <a href="infrastructure.html#htmlcollection">HTMLCollection</a> {
+ // inherits <span title="dom-HTMLCollection-length">length</span> and <span title="dom-HTMLCollection-item">item</span>()
+ caller getter object? <a href="#dom-htmlallcollection-nameditem" title="dom-HTMLAllCollection-namedItem">namedItem</a>(DOMString name); // overrides inherited namedItem()
+ <a href="#htmlallcollection">HTMLAllCollection</a> <a href="#dom-htmlallcollection-tags" title="dom-HTMLAllCollection-tags">tags</a>(DOMString tagName);
+};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length">length</code></dt>
<dd>
<p>Returns the number of elements in the collection.</p>
</dd>
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item"><a href="#dom-htmlcollection-item">item</a></code>(<var title="">index</var>)</dt>
+ <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item">item</code>(<var title="">index</var>)</dt>
<dt><var title="">collection</var>[<var title="">index</var>]</dt>
<dt><var title="">collection</var>(<var title="">index</var>)</dt>
<dd>
@@ -639,7 +569,7 @@
<p>The object's <a href="infrastructure.html#supported-property-indices">supported property indices</a> and
<a href="infrastructure.html#supported-property-names">supported property names</a> are as defined for
- <code><a href="#htmlcollection">HTMLCollection</a></code> objects.</p>
+ <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> objects.</p>
<p>The <dfn id="dom-htmlallcollection-nameditem" title="dom-HTMLAllCollection-namedItem"><code>namedItem(<var title="">key</var>)</code></dfn> method must act according to the
following algorithm:</p>
@@ -679,25 +609,25 @@
invoked, whose filter matches only <a href="infrastructure.html#html-elements">HTML elements</a> whose
local name is the <var title="">tagName</var> argument and that
already match the filter of the <code><a href="#htmlallcollection">HTMLAllCollection</a></code>
- object on which the method was invoked. In <a href="dom.html#html-documents">HTML
+ object on which the method was invoked. In <a href="infrastructure.html#html-documents">HTML
documents</a>, the argument must first be <a href="infrastructure.html#converted-to-ascii-lowercase">converted to
ASCII lowercase</a>.</p>
- </div><h5 id="htmlformcontrolscollection-0"><span class="secno">2.8.2.3 </span>HTMLFormControlsCollection</h5><p>The <code><a href="#htmlformcontrolscollection">HTMLFormControlsCollection</a></code> interface represents
- a <a href="#collections" title="collections">collection</a> of <a href="forms.html#category-listed" title="category-listed">listed elements</a> in <code><a href="forms.html#the-form-element">form</a></code>
- and <code><a href="forms.html#the-fieldset-element">fieldset</a></code> elements.</p><pre class="idl">interface <dfn id="htmlformcontrolscollection">HTMLFormControlsCollection</dfn> : <a href="#htmlcollection">HTMLCollection</a> {
- // inherits <a href="#dom-htmlcollection-length" title="dom-HTMLCollection-length">length</a> and <a href="#dom-htmlcollection-item" title="dom-HTMLCollection-item">item</a>()
- caller getter object? <a href="#dom-htmlformcontrolscollection-nameditem" title="dom-HTMLFormControlsCollection-namedItem">namedItem</a>(in DOMString name); // overrides inherited namedItem()
+ </div><h5 id="htmlformcontrolscollection-0"><span class="secno">2.8.2.2 </span>HTMLFormControlsCollection</h5><p>The <code><a href="#htmlformcontrolscollection">HTMLFormControlsCollection</a></code> interface represents
+ a <a href="infrastructure.html#collections" title="collections">collection</a> of <a href="forms.html#category-listed" title="category-listed">listed elements</a> in <code><a href="forms.html#the-form-element">form</a></code>
+ and <code><a href="forms.html#the-fieldset-element">fieldset</a></code> elements.</p><pre class="idl">interface <dfn id="htmlformcontrolscollection">HTMLFormControlsCollection</dfn> : <a href="infrastructure.html#htmlcollection">HTMLCollection</a> {
+ // inherits <span title="dom-HTMLCollection-length">length</span> and <span title="dom-HTMLCollection-item">item</span>()
+ caller getter object? <a href="#dom-htmlformcontrolscollection-nameditem" title="dom-HTMLFormControlsCollection-namedItem">namedItem</a>(DOMString name); // overrides inherited namedItem()
};
interface <dfn id="radionodelist">RadioNodeList</dfn> : <a href="infrastructure.html#nodelist">NodeList</a> {
attribute DOMString <a href="#dom-radionodelist-value" title="dom-RadioNodeList-value">value</a>;
-};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length"><a href="#dom-htmlcollection-length">length</a></code></dt>
+};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length">length</code></dt>
<dd>
<p>Returns the number of elements in the collection.</p>
</dd>
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item"><a href="#dom-htmlcollection-item">item</a></code>(<var title="">index</var>)</dt>
+ <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item">item</code>(<var title="">index</var>)</dt>
<dt><var title="">collection</var>[<var title="">index</var>]</dt>
<dt><var title="">collection</var>(<var title="">index</var>)</dt>
<dd>
@@ -722,11 +652,11 @@
</dl><div class="impl">
<p>The object's <a href="infrastructure.html#supported-property-indices">supported property indices</a> are as
- defined for <code><a href="#htmlcollection">HTMLCollection</a></code> objects.</p>
+ defined for <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> objects.</p>
<p>The <a href="infrastructure.html#supported-property-names">supported property names</a> consist of the values
of all the <code title="attr-id"><a href="elements.html#the-id-attribute">id</a></code> and <code title="attr-fe-name"><a href="association-of-controls-and-forms.html#attr-fe-name">name</a></code> attributes of all the elements
- <a href="#represented-by-the-collection">represented by the collection</a>.</p>
+ <a href="infrastructure.html#represented-by-the-collection">represented by the collection</a>.</p>
<p>The <dfn id="dom-htmlformcontrolscollection-nameditem" title="dom-HTMLFormControlsCollection-namedItem"><code>namedItem(<var title="">name</var>)</code></dfn> method must act according to the
following algorithm:</p>
@@ -786,16 +716,19 @@
<li><p>If <var title="">element</var> is not null, then set its
<a href="association-of-controls-and-forms.html#concept-fe-checked" title="concept-fe-checked">checkedness</a> to true.</p>
- </li></ol></div><h5 id="htmloptionscollection-0"><span class="secno">2.8.2.4 </span>HTMLOptionsCollection</h5><p>The <code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> interface represents a
+ </li></ol></div><h5 id="htmloptionscollection-0"><span class="secno">2.8.2.3 </span>HTMLOptionsCollection</h5><p>The <code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> interface represents a
list of <code><a href="the-button-element.html#the-option-element">option</a></code> elements. It is always rooted on a
<code><a href="the-button-element.html#the-select-element">select</a></code> element and has attributes and methods that
- manipulate that element's descendants.</p><pre class="idl">interface <dfn id="htmloptionscollection">HTMLOptionsCollection</dfn> : <a href="#htmlcollection">HTMLCollection</a> {
- // inherits <a href="#dom-htmlcollection-item" title="dom-HTMLCollection-item">item</a>()
+ manipulate that element's descendants.</p><pre class="idl">interface <dfn id="htmloptionscollection">HTMLOptionsCollection</dfn> : <a href="infrastructure.html#htmlcollection">HTMLCollection</a> {
+ // inherits <span title="dom-HTMLCollection-item">item</span>()
attribute unsigned long <a href="#dom-htmloptionscollection-length" title="dom-HTMLOptionsCollection-length">length</a>; // overrides inherited length
- caller getter object? <a href="#dom-htmloptionscollection-nameditem" title="dom-HTMLOptionsCollection-namedItem">namedItem</a>(in DOMString name); // overrides inherited namedItem()
- void <a href="#dom-htmloptionscollection-add" title="dom-HTMLOptionsCollection-add">add</a>(in <a href="elements.html#htmlelement">HTMLElement</a> element, in optional <a href="elements.html#htmlelement">HTMLElement</a>? before);
- void <a href="#dom-htmloptionscollection-add" title="dom-HTMLOptionsCollection-add">add</a>(in <a href="elements.html#htmlelement">HTMLElement</a> element, in long before);
- void <a href="#dom-htmloptionscollection-remove" title="dom-HTMLOptionsCollection-remove">remove</a>(in long index);
+ caller getter object? <a href="#dom-htmloptionscollection-nameditem" title="dom-HTMLOptionsCollection-namedItem">namedItem</a>(DOMString name); // overrides inherited namedItem()
+ <a href="#dom-htmloptionscollection-setter" title="dom-HTMLOptionsCollection-setter">setter creator</a> void (unsigned long index, <a href="the-button-element.html#htmloptionelement">HTMLOptionElement</a> option);
+ void <a href="#dom-htmloptionscollection-add" title="dom-HTMLOptionsCollection-add">add</a>(<a href="the-button-element.html#htmloptionelement">HTMLOptionElement</a> element, optional <a href="elements.html#htmlelement">HTMLElement</a>? before);
+ void <a href="#dom-htmloptionscollection-add" title="dom-HTMLOptionsCollection-add">add</a>(<a href="the-button-element.html#htmloptgroupelement">HTMLOptGroupElement</a> element, optional <a href="elements.html#htmlelement">HTMLElement</a>? before);
+ void <a href="#dom-htmloptionscollection-add" title="dom-HTMLOptionsCollection-add">add</a>(<a href="the-button-element.html#htmloptionelement">HTMLOptionElement</a> element, long before);
+ void <a href="#dom-htmloptionscollection-add" title="dom-HTMLOptionsCollection-add">add</a>(<a href="the-button-element.html#htmloptgroupelement">HTMLOptGroupElement</a> element, long before);
+ void <a href="#dom-htmloptionscollection-remove" title="dom-HTMLOptionsCollection-remove">remove</a>(long index);
attribute long <a href="#dom-htmloptionscollection-selectedindex" title="dom-HTMLOptionsCollection-selectedIndex">selectedIndex</a>;
};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLOptionsCollection-length"><a href="#dom-htmloptionscollection-length">length</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -804,7 +737,7 @@
<p>When set to a greater number, adds new blank <code><a href="the-button-element.html#the-option-element">option</a></code> elements to that container.</p>
</dd>
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item"><a href="#dom-htmlcollection-item">item</a></code>(<var title="">index</var>)</dt>
+ <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item">item</code>(<var title="">index</var>)</dt>
<dt><var title="">collection</var>[<var title="">index</var>]</dt>
<dt><var title="">collection</var>(<var title="">index</var>)</dt>
<dd>
@@ -830,10 +763,9 @@
<p>If <var title="">before</var> is omitted, null, or a number out
of range, then <var title="">element</var> will be added at the
end of the list.</p>
- <p>This method will throw a <code><a href="#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code>
+ <p>This method will throw a <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code>
exception if <var title="">element</var> is an ancestor of the
- element into which it is to be inserted. If <var title="">element</var> is not an <code><a href="the-button-element.html#the-option-element">option</a></code> or
- <code><a href="the-button-element.html#the-optgroup-element">optgroup</a></code> element, then the method does nothing.</p>
+ element into which it is to be inserted.</p>
</dd>
<dt><var title="">collection</var> . <code title="dom-HTMLOptionsCollection-selectedIndex"><a href="#dom-htmloptionscollection-selectedindex">selectedIndex</a></code> [ = <var title="">value</var> ]</dt>
@@ -850,15 +782,15 @@
</dl><div class="impl">
<p>The object's <a href="infrastructure.html#supported-property-indices">supported property indices</a> are as
- defined for <code><a href="#htmlcollection">HTMLCollection</a></code> objects.</p>
+ defined for <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> objects.</p>
<p>On getting, the <dfn id="dom-htmloptionscollection-length" title="dom-HTMLOptionsCollection-length"><code>length</code></dfn>
- attribute must return the number of nodes <a href="#represented-by-the-collection">represented by the
+ attribute must return the number of nodes <a href="infrastructure.html#represented-by-the-collection">represented by the
collection</a>.</p>
<p>On setting, the behavior depends on whether the new value is
equal to, greater than, or less than the number of nodes
- <a href="#represented-by-the-collection">represented by the collection</a> at that time. If the
+ <a href="infrastructure.html#represented-by-the-collection">represented by the collection</a> at that time. If the
number is the same, then setting the attribute must do nothing. If
the new value is greater, then <var title="">n</var> new
<code><a href="the-button-element.html#the-option-element">option</a></code> elements with no attributes and no child nodes
@@ -866,7 +798,7 @@
<code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> is rooted, where <var title="">n</var> is the difference between the two numbers (new
value minus old value). Mutation events must be fired as if a
<code><a href="infrastructure.html#documentfragment">DocumentFragment</a></code> containing the new <code><a href="the-button-element.html#the-option-element">option</a></code>
- elements had been inserted. If the new value is lower, then the
+ elements had been inserted. If the new value is lower, then the
last <var title="">n</var> nodes in the collection must be removed
from their parent nodes, where <var title="">n</var> is the
difference between the two numbers (old value minus new value).</p>
@@ -878,7 +810,7 @@
<p>The <a href="infrastructure.html#supported-property-names">supported property names</a> consist of the values
of all the <code title="attr-id"><a href="elements.html#the-id-attribute">id</a></code> and <code title="attr-option-name"><a href="obsolete.html#attr-option-name">name</a></code> attributes of all the elements
- <a href="#represented-by-the-collection">represented by the collection</a>.</p>
+ <a href="infrastructure.html#represented-by-the-collection">represented by the collection</a>.</p>
<p>The <dfn id="dom-htmloptionscollection-nameditem" title="dom-HTMLOptionsCollection-namedItem"><code>namedItem(<var title="">name</var>)</code></dfn> method must act according to the
following algorithm:</p>
@@ -900,22 +832,41 @@
<li>Return that <code><a href="infrastructure.html#nodelist">NodeList</a></code> object.</li>
+ </ol><p>When the user agent is to <dfn id="dom-htmloptionscollection-setter" title="dom-HTMLOptionsCollection-setter">set the value of a new
+ indexed property</dfn> for a given property index <var title="">index</var> to a new value <var title="">value</var>, it
+ must run the following algorithm:</p>
+
+ <ol><li><p>Let <var title="">length</var> be the number of nodes
+ <a href="infrastructure.html#represented-by-the-collection">represented by the collection</a>.</p></li>
+
+ <li><p>Let <var title="">n</var> be <var title="">index</var> minus
+ <var title="">length</var>.</p></li>
+
+ <li><p>If <var title="">n</var> is greater than zero, then append
+ <span title=""><var title="">n</var>-1</span> new
+ <code><a href="the-button-element.html#the-option-element">option</a></code> elements with no attributes and no child nodes
+ to the <code><a href="the-button-element.html#the-select-element">select</a></code> element on which the
+ <code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> is rooted. Mutation events must
+ be fired as if a <code><a href="infrastructure.html#documentfragment">DocumentFragment</a></code> containing the new
+ <code><a href="the-button-element.html#the-option-element">option</a></code> elements had been inserted.</p></li>
+
+ <li><p>If <var title="">n</var> is greater than or equal to zero,
+ append <var title="">value</var> to the <code><a href="the-button-element.html#the-select-element">select</a></code>
+ element. Otherwise, replace the <var title="">index</var>th element
+ in the collection by <var title="">value</var>.</p></li>
+
</ol><p>The <dfn id="dom-htmloptionscollection-add" title="dom-HTMLOptionsCollection-add"><code>add(<var title="">element</var>, <var title="">before</var>)</code></dfn>
method must act according to the following algorithm:</p>
- <ol><li><p>If <var title="">element</var> is not an <code><a href="the-button-element.html#the-option-element">option</a></code>
- or <code><a href="the-button-element.html#the-optgroup-element">optgroup</a></code> element, then return and abort these
- steps.</p></li>
-
- <li><p>If <var title="">element</var> is an ancestor of the
+ <ol><li><p>If <var title="">element</var> is an ancestor of the
<code><a href="the-button-element.html#the-select-element">select</a></code> element on which the
<code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> is rooted, then throw a
- <code><a href="#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p></li>
+ <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p></li>
<li><p>If <var title="">before</var> is an element, but that
element isn't a descendant of the <code><a href="the-button-element.html#the-select-element">select</a></code> element on
which the <code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> is rooted, then throw
- a <code><a href="#not_found_err">NOT_FOUND_ERR</a></code> exception.</p></li>
+ a <code><a href="infrastructure.html#not_found_err">NOT_FOUND_ERR</a></code> exception.</p></li>
<li><p>If <var title="">element</var> and <var title="">before</var> are the same element, then return and abort
these steps.</p></li>
@@ -932,11 +883,11 @@
</li></ol><p>The <dfn id="dom-htmloptionscollection-remove" title="dom-HTMLOptionsCollection-remove"><code>remove(<var title="">index</var>)</code></dfn> method must act according to
the following algorithm:</p>
- <ol><li><p>If the number of nodes <a href="#represented-by-the-collection">represented by the
+ <ol><li><p>If the number of nodes <a href="infrastructure.html#represented-by-the-collection">represented by the
collection</a> is zero, abort these steps.</p></li>
<li><p>If <var title="">index</var> is not a number greater than or
- equal to 0 and less than the number of nodes <a href="#represented-by-the-collection">represented by
+ equal to 0 and less than the number of nodes <a href="infrastructure.html#represented-by-the-collection">represented by
the collection</a>, let <var title="">element</var> be the first
element in the collection. Otherwise, let <var title="">element</var> be the <var title="">index</var>th element
in the collection.</p></li>
@@ -951,231 +902,135 @@
- </div><h4 id="domtokenlist-0"><span class="secno">2.8.3 </span>DOMTokenList</h4><p>The <code><a href="#domtokenlist">DOMTokenList</a></code> interface represents an interface
- to an underlying string that consists of a <a href="common-microsyntaxes.html#set-of-space-separated-tokens">set of
- space-separated tokens</a>.</p><p class="note"><code><a href="#domtokenlist">DOMTokenList</a></code> objects are always
- <a href="infrastructure.html#case-sensitive">case-sensitive</a>, even when the underlying string might
- ordinarily be treated in a case-insensitive manner.</p><pre class="idl">interface <dfn id="domtokenlist">DOMTokenList</dfn> {
- readonly attribute unsigned long <a href="#dom-tokenlist-length" title="dom-tokenlist-length">length</a>;
- getter DOMString? <a href="#dom-tokenlist-item" title="dom-tokenlist-item">item</a>(in unsigned long index);
- boolean <a href="#dom-tokenlist-contains" title="dom-tokenlist-contains">contains</a>(in DOMString token);
- void <a href="#dom-tokenlist-add" title="dom-tokenlist-add">add</a>(in DOMString token);
- void <a href="#dom-tokenlist-remove" title="dom-tokenlist-remove">remove</a>(in DOMString token);
- boolean <a href="#dom-tokenlist-toggle" title="dom-tokenlist-toggle">toggle</a>(in DOMString token);
- <a href="#dom-tokenlist-tostring" title="dom-tokenlist-toString">stringifier</a> DOMString ();
-};</pre><dl class="domintro"><dt><var title="">tokenlist</var> . <code title="dom-tokenlist-length"><a href="#dom-tokenlist-length">length</a></code></dt>
- <dd>
- <p>Returns the number of tokens in the string.</p>
- </dd>
-
- <dt><var title="">element</var> = <var title="">tokenlist</var> . <code title="dom-tokenlist-item"><a href="#dom-tokenlist-item">item</a></code>(<var title="">index</var>)</dt>
- <dt><var title="">tokenlist</var>[<var title="">index</var>]</dt>
- <dd>
- <p>Returns the token with index <var title="">index</var>. The tokens are returned in the order they are found in the underlying string.</p>
- </dd>
-
- <dt><var title="">hastoken</var> = <var title="">tokenlist</var> . <code title="dom-tokenlist-contains"><a href="#dom-tokenlist-contains">contains</a></code>(<var title="">token</var>)</dt>
- <dd>
- <p>Returns true if the <var title="">token</var> is present; false otherwise.</p>
- <p>Throws a <code><a href="#syntax_err">SYNTAX_ERR</a></code> exception if <var title="">token</var> is empty.</p>
- <p>Throws an <code><a href="#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if <var title="">token</var> contains any spaces.</p>
- </dd>
-
- <dt><var title="">tokenlist</var> . <code title="dom-tokenlist-add"><a href="#dom-tokenlist-add">add</a></code>(<var title="">token</var>)</dt>
- <dd>
- <p>Adds <var title="">token</var>, unless it is already present.</p>
- <p>Throws a <code><a href="#syntax_err">SYNTAX_ERR</a></code> exception if <var title="">token</var> is empty.</p>
- <p>Throws an <code><a href="#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if <var title="">token</var> contains any spaces.</p>
- </dd>
-
- <dt><var title="">tokenlist</var> . <code title="dom-tokenlist-remove"><a href="#dom-tokenlist-remove">remove</a></code>(<var title="">token</var>)</dt>
- <dd>
- <p>Removes <var title="">token</var> if it is present.</p>
- <p>Throws a <code><a href="#syntax_err">SYNTAX_ERR</a></code> exception if <var title="">token</var> is empty.</p>
- <p>Throws an <code><a href="#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if <var title="">token</var> contains any spaces.</p>
- </dd>
-
- <dt><var title="">hastoken</var> = <var title="">tokenlist</var> . <code title="dom-tokenlist-toggle"><a href="#dom-tokenlist-toggle">toggle</a></code>(<var title="">token</var>)</dt>
- <dd>
- <p>Adds <var title="">token</var> if it is not present, or removes
- it if it is. Returns true if <var title="">token</var> is now
- present (it was added); returns false if it is not (it was
- removed).</p>
- <p>Throws a <code><a href="#syntax_err">SYNTAX_ERR</a></code> exception if <var title="">token</var> is empty.</p>
- <p>Throws an <code><a href="#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if <var title="">token</var> contains any spaces.</p>
- </dd>
-
- </dl><div class="impl">
-
- <p>The <dfn id="dom-tokenlist-length" title="dom-tokenlist-length"><code>length</code></dfn>
- attribute must return the number of tokens that result from <a href="common-microsyntaxes.html#split-a-string-on-spaces" title="split a string on spaces">splitting the underlying string on
- spaces</a>. This is the <var title="dom-tokenlist-length"><a href="#dom-tokenlist-length">length</a></var>.</p>
-
- <p>The object's <a href="infrastructure.html#supported-property-indices">supported property indices</a> are the
- numbers in the range zero to <span title=""><var title="dom-tokenlist-length"><a href="#dom-tokenlist-length">length</a></var>-1</span>, unless the <var title="dom-tokenlist-length"><a href="#dom-tokenlist-length">length</a></var> is zero, in which case
- there are no <a href="infrastructure.html#supported-property-indices">supported property indices</a>.</p>
-
- <p>The <dfn id="dom-tokenlist-item" title="dom-tokenlist-item"><code>item(<var title="">index</var>)</code></dfn> method must <a href="common-microsyntaxes.html#split-a-string-on-spaces" title="split a string on spaces">split the underlying string on spaces</a>,
- preserving the order of the tokens as found in the underlying
- string, and then return the <var title="">index</var>th item in this
- list. If <var title="">index</var> is equal to or greater than the
- number of tokens, then the method must return null.</p>
-
- <p class="example">For example, if the string is "<code title="">a b
- a c</code>" then there are four tokens: the token with index 0 is
- "<code title="">a</code>", the token with index 1 is "<code title="">b</code>", the token with index 2 is "<code title="">a</code>", and the token with index 3 is "<code title="">c</code>".</p>
-
- <p>The <dfn id="dom-tokenlist-contains" title="dom-tokenlist-contains"><code>contains(<var title="">token</var>)</code></dfn> method must run the following
- algorithm:</p>
-
- <ol><li>If the <var title="">token</var> argument is the empty string,
- then raise a <code><a href="#syntax_err">SYNTAX_ERR</a></code> exception and stop the
- algorithm.</li>
-
- <li>If the <var title="">token</var> argument contains any <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a>, then raise an
- <code><a href="#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception and stop the
- algorithm.</li>
-
- <li>Otherwise, <a href="common-microsyntaxes.html#split-a-string-on-spaces" title="split a string on spaces">split the
- underlying string on spaces</a> to get the list of tokens in the
- <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying string.</li>
-
- <li>If the token indicated by <var title="">token</var> is a
- <a href="infrastructure.html#case-sensitive">case-sensitive</a> match for one of the tokens in the
- <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying string then return
- true and stop this algorithm.</li>
-
- <li>Otherwise, return false.</li>
-
- </ol><p>The <dfn id="dom-tokenlist-add" title="dom-tokenlist-add"><code>add(<var title="">token</var>)</code></dfn> method must run the following
- algorithm:</p>
-
- <ol><li>If the <var title="">token</var> argument is the empty string,
- then raise a <code><a href="#syntax_err">SYNTAX_ERR</a></code> exception and stop the
- algorithm.</li>
-
- <li>If the <var title="">token</var> argument contains any <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a>, then raise an
- <code><a href="#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception and stop the
- algorithm.</li>
-
- <li>Otherwise, <a href="common-microsyntaxes.html#split-a-string-on-spaces" title="split a string on spaces">split the
- underlying string on spaces</a> to get the list of tokens in the
- <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying string.</li>
-
- <li>If the given <var title="">token</var> is a
- <a href="infrastructure.html#case-sensitive">case-sensitive</a> match for one of the tokens in the
- <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying string then stop the
- algorithm.</li>
-
- <li>Otherwise, if the <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying
- string is not the empty string and the last character of that
- string is not a <a href="common-microsyntaxes.html#space-character">space character</a>, then append a U+0020
- SPACE character to the end of that string.</li>
-
- <li>Append the value of <var title="">token</var> to the end of the
- <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying string.</li>
-
- </ol><p>The <dfn id="dom-tokenlist-remove" title="dom-tokenlist-remove"><code>remove(<var title="">token</var>)</code></dfn> method must run the following
- algorithm:</p>
-
- <ol><li>If the <var title="">token</var> argument is the empty string,
- then raise a <code><a href="#syntax_err">SYNTAX_ERR</a></code> exception and stop the
- algorithm.</li>
+ </div><h4 id="domstringmap-0"><span class="secno">2.8.3 </span>DOMStringMap</h4><p>The <code><a href="#domstringmap">DOMStringMap</a></code> interface represents a set of
+ name-value pairs. It exposes these using the scripting language's
+ native mechanisms for property access.</p><div class="impl">
- <li>If the <var title="">token</var> argument contains any <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a>, then raise an
- <code><a href="#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception and stop the
- algorithm.</li>
+ <p>When a <code><a href="#domstringmap">DOMStringMap</a></code> object is instantiated, it is
+ associated with three algorithms, one for getting the list of
+ name-value pairs, one for setting names to certain values, and one
+ for deleting names.</p>
- <li>Otherwise, <a href="common-microsyntaxes.html#remove-a-token-from-a-string" title="remove a token from a string">remove
- the given <var title="">token</var> from the underlying
- string</a>.</li>
+ <pre class="idl">interface <dfn id="domstringmap">DOMStringMap</dfn> {
+ <a href="#dom-domstringmap-nameditem" title="dom-DOMStringMap-namedItem">getter</a> DOMString (DOMString name);
+ <a href="#dom-domstringmap-setitem" title="dom-DOMStringMap-setItem">setter</a> void (DOMString name, DOMString value);
+ <a href="#dom-domstringmap-additem" title="dom-DOMStringMap-addItem">creator</a> void (DOMString name, DOMString value);
+ <a href="#dom-domstringmap-removeitem" title="dom-DOMStringMap-removeItem">deleter</a> void (DOMString name);
+};</pre>
- </ol><p>The <dfn id="dom-tokenlist-toggle" title="dom-tokenlist-toggle"><code>toggle(<var title="">token</var>)</code></dfn> method must run the following
- algorithm:</p>
+ <p>The <a href="infrastructure.html#supported-property-names">supported property names</a> on a
+ <code><a href="#domstringmap">DOMStringMap</a></code> object at any instant are the names of
+ each pair returned from the algorithm for getting the list of
+ name-value pairs at that instant.</p>
- <ol><li>If the <var title="">token</var> argument is the empty string,
- then raise a <code><a href="#syntax_err">SYNTAX_ERR</a></code> exception and stop the
- algorithm.</li>
+ <p>To <dfn id="dom-domstringmap-nameditem" title="dom-DOMStringMap-namedItem">determine the value of
+ a named property</dfn> <var title="">name</var> in a
+ <code><a href="#domstringmap">DOMStringMap</a></code>, the user agent must return the value
+ component of the name-value pair whose name component is <var title="">name</var> in the list returned by the algorithm for
+ getting the list of name-value pairs.</p>
- <li>If the <var title="">token</var> argument contains any <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a>, then raise an
- <code><a href="#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception and stop the
- algorithm.</li>
+ <p>To set the value of a <dfn id="dom-domstringmap-additem" title="dom-DOMStringMap-addItem">new</dfn> or <dfn id="dom-domstringmap-setitem" title="dom-DOMStringMap-setItem">existing</dfn> named property <var title="">name</var> to value <var title="">value</var>, the
+ algorithm for setting names to certain values must be run, passing
+ <var title="">name</var> as the name and the result of converting
+ <var title="">value</var> to a <code>DOMString</code> as the
+ value.</p>
- <li>Otherwise, <a href="common-microsyntaxes.html#split-a-string-on-spaces" title="split a string on spaces">split the
- underlying string on spaces</a> to get the list of tokens in the
- <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying string.</li>
+ <p>To <dfn id="dom-domstringmap-removeitem" title="dom-DOMStringMap-removeItem">delete an existing
+ named property</dfn> <var title="">name</var>, the algorithm for
+ deleting names must be run, passing <var title="">name</var> as the
+ name.</p>
- <li>If the given <var title="">token</var> is a
- <a href="infrastructure.html#case-sensitive">case-sensitive</a> match for one of the tokens in the
- <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying string then <a href="common-microsyntaxes.html#remove-a-token-from-a-string" title="remove a token from a string">remove the given <var title="">token</var> from the underlying string</a> and stop the
- algorithm, returning false.</li>
+ <p class="note">The <code><a href="#domstringmap">DOMStringMap</a></code> interface definition
+ here is only intended for JavaScript environments. Other language
+ bindings will need to define how <code><a href="#domstringmap">DOMStringMap</a></code> is to be
+ implemented for those languages.</p>
- <li>Otherwise, if the <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying
- string is not the empty string and the last character of that
- string is not a <a href="common-microsyntaxes.html#space-character">space character</a>, then append a U+0020
- SPACE character to the end of that string.</li>
+ </div><div class="example">
- <li>Append the value of <var title="">token</var> to the end of the
- <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying string.</li>
+ <p>The <code title="dom-dataset"><a href="elements.html#dom-dataset">dataset</a></code> attribute on
+ elements exposes the <code title="attr-data-*"><a href="elements.html#attr-data">data-*</a></code>
+ attributes on the element.</p>
- <li>Return true.</li>
+ <p>Given the following fragment and elements with similar
+ constructions:</p>
- </ol><p>A <code><a href="#domtokenlist">DOMTokenList</a></code> object must <dfn id="dom-tokenlist-tostring" title="dom-tokenlist-toString">stringify</dfn> to the value of the
- <code><a href="#domtokenlist">DOMTokenList</a></code> object's underlying string.</p>
+ <pre><img class="tower" id="tower5" data-x="12" data-y="5"
+ data-ai="robotarget" data-hp="46" data-ability="flames"
+ src="towers/rocket.png alt="Rocket Tower"></pre>
- </div><h4 id="domsettabletokenlist-0"><span class="secno">2.8.4 </span>DOMSettableTokenList</h4><p>The <code><a href="#domsettabletokenlist">DOMSettableTokenList</a></code> interface is the same as the
- <code><a href="#domtokenlist">DOMTokenList</a></code> interface, except that it allows the
- underlying string to be directly changed.</p><pre class="idl">interface <dfn id="domsettabletokenlist">DOMSettableTokenList</dfn> : <a href="#domtokenlist">DOMTokenList</a> {
- attribute DOMString <a href="#dom-domsettabletokenlist-value" title="dom-DOMSettableTokenList-value">value</a>;
-};</pre><dl class="domintro"><dt><var title="">tokenlist</var> . <code title="dom-DOMSettableTokenList-value"><a href="#dom-domsettabletokenlist-value">value</a></code></dt>
- <dd>
- <p>Returns the underlying string.</p>
- <p>Can be set, to change the underlying string.</p>
- </dd>
+ <p>...one could imagine a function <code title="">splashDamage()</code> that takes some arguments, the first
+ of which is the element to process:</p>
- </dl><div class="impl">
+ <pre>function splashDamage(node, x, y, damage) {
+ if (node.classList.contains('tower') && // checking the 'class' attribute
+ node.dataset.x == x && // reading the 'data-x' attribute
+ node.dataset.y == y) { // reading the 'data-y' attribute
+ var hp = parseInt(node.dataset.hp); // reading the 'data-hp' attribute
+ hp = hp - damage;
+ if (hp < 0) {
+ hp = 0;
+ node.dataset.ai = 'dead'; // setting the 'data-ai' attribute
+ delete node.dataset.ability; // removing the 'data-ability' attribute
+ }
+ node.dataset.hp = hp; // setting the 'data-hp' attribute
+ }
+}</pre>
- <p>An object implementing the <code><a href="#domsettabletokenlist">DOMSettableTokenList</a></code>
- interface must act as defined for the <code><a href="#domtokenlist">DOMTokenList</a></code>
- interface, except for the <code title="dom-DOMSettableTokenList-value"><a href="#dom-domsettabletokenlist-value">value</a></code> attribute defined
- here.</p>
+ </div><h4 id="transferable-objects"><span class="secno">2.8.4 </span>Transferable objects</h4><p>Some objects support being copied and closed in one operation.
+ This is called <i>transferring</i> the object, and is used in
+ particular to transfer ownership of unsharable or expensive
+ resources across worker boundaries.</p><pre class="idl">[NoInterfaceObject]
+interface <dfn id="transferable">Transferable</dfn> { };</pre><div class="impl">
- <p>The <dfn id="dom-domsettabletokenlist-value" title="dom-DOMSettableTokenList-value"><code>value</code></dfn>
- attribute must return the underlying string on getting, and must
- replace the underlying string with the new value on setting.</p>
+ <p>To <dfn id="transfer-a-transferable-object">transfer a <code>Transferable</code> object</dfn> to a
+ new owner, the user agent must run the steps defined for the type of
+ object in question. The steps will return a new object of the same
+ type, and will permanently neuter the original object. (This is an
+ irreversible and non-idempotent operation; once an object has been
+ transferred, it cannot be transferred, or indeed used, again.)</p>
- </div><div class="impl">
+ </div><p>The following <code><a href="#transferable">Transferable</a></code> types exist:</p><ul class="brief"><li><code>MessagePort</code>
+
+ </li></ul><div class="impl">
<h4 id="safe-passing-of-structured-data"><span class="secno">2.8.5 </span>Safe passing of structured data</h4>
<p>When a user agent is required to obtain a <dfn id="structured-clone">structured
- clone</dfn> of a value, it must run the following algorithm, which
- either returns a separate value, or throws an exception.</p>
+ clone</dfn> of a value, optionally with a <i>transfer map</i>, it
+ must run the following algorithm, which either returns a separate
+ value, or throws an exception. If a <i>transfer map</i> is provided,
+ it consists of a association list of pairs of
+ <code><a href="#transferable">Transferable</a></code> objects; in each pair, one is the
+ <em>old</em> object and one is the <em>new</em> object.</p>
<ol><li><p>Let <var title="">input</var> be the value being
cloned.</p></li>
+ <li><p>Let <var title="">transfer map</var> be the <i>transfer
+ map</i> passed to the algorithm, if any, or the empty list
+ otherwise.</p></li>
+
<li><p>Let <var title="">memory</var> be an association list of
pairs of objects, initially empty. This is used to handle duplicate
references. In each pair of objects, one is called the
<em>source</em> object and the other the <em>destination</em>
object.</p></li>
+ <li><p>For each pair of objects in <var title="">transfer
+ map</var>, add a mapping from the old object (the source object) to
+ the new object (the destination object) to <var title="">memory</var>.</p></li>
+
<li><p>Let <var title="">output</var> be the value resulting from
calling the <a href="#internal-structured-cloning-algorithm">internal structured cloning algorithm</a> with
<var title="">input</var> as the "<var title="">input</var>"
- argument, <var title="">memory</var> as the "<var title="">memory</var>" argument, and zero as the "<var title="">depth</var>" argument.</p></li>
+ argument, and <var title="">memory</var> as the "<var title="">memory</var>" argument.</p></li>
<li><p>Return <var title="">output</var>.</p></li>
</ol><p>The <dfn id="internal-structured-cloning-algorithm">internal structured cloning algorithm</dfn> is always
- called with three arguments, <var title="">input</var>, <var title="">memory</var>, and <var title="">depth</var>, and its
- behavior is as follows:</p>
-
- <ol><li><p>If <var title="">depth</var> is greater than 1, return null
- and abort these steps.</p></li>
+ called with two arguments, <var title="">input</var> and <var title="">memory</var>, and its behavior is as follows:</p>
- <li><p>If <var title="">input</var> is the source object of a pair
+ <ol><li><p>If <var title="">input</var> is the source object of a pair
of objects in <var title="">memory</var>, then return the
destination object in that pair of objects and abort these
steps.</p></li>
@@ -1235,9 +1090,19 @@
<dd><p>Let <var title="">output</var> be a newly constructed <code><a href="infrastructure.html#filelist">FileList</a></code> object containing a list of newly constructed <code><a href="infrastructure.html#file">File</a></code> objects corresponding to the same underlying data as those in <var title="">input</var>, maintaining their relative order.</p></dd>
+
<dt>If <var title="">input</var> is an Array object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed empty <code>Array</code> object.</p></dd>
+ <dd>
+
+ <p>Let <var title="">output</var> be a newly constructed empty
+ <code>Array</code> object whose <code title="">length</code> is
+ equal to the <code title="">length</code> of <var title="">input</var>.</p>
+
+ <p class="note">This means that the length of sparse arrays is
+ preserved.</p>
+
+ </dd>
<dt>If <var title="">input</var> is an Object object</dt>
@@ -1246,7 +1111,7 @@
<dt>If <var title="">input</var> is another native object type (e.g. <code>Error</code>, <code><a href="webappapis.html#function">Function</a></code>)</dt>
<dt>If <var title="">input</var> is a host object (e.g. a DOM node)</dt>
- <dd><p>Throw a <code><a href="#data_clone_err">DATA_CLONE_ERR</a></code> exception and abort
+ <dd><p>Throw a <code><a href="infrastructure.html#data_clone_err">DATA_CLONE_ERR</a></code> exception and abort
the overall <a href="#structured-clone">structured clone</a> algorithm.</p></dd>
</dl></li>
@@ -1261,11 +1126,8 @@
object, then, for each enumerable property in <var title="">input</var>, add a new property to <var title="">output</var> having the same name, and having a value
created from invoking the <a href="#internal-structured-cloning-algorithm">internal structured cloning
algorithm</a> recursively with the value of the property as the
- "<var title="">input</var>" argument, <var title="">memory</var>
- as the "<var title="">memory</var>" argument, and <span title=""><var title="">depth</var>+<var title="">newDepth</var></span> as the "<var title="">depth</var>"
- argument, where <var title="">newDepth</var> is zero except if
- obtaining the value of the property involved executing script, in
- which case it is one (1). The order of the properties in the <var title="">input</var> and <var title="">output</var> objects must
+ "<var title="">input</var>" argument and <var title="">memory</var> as the "<var title="">memory</var>"
+ argument. The order of the properties in the <var title="">input</var> and <var title="">output</var> objects must
be the same, and any properties that involve running script must
be processed in that same order. If obtaining the value of the
property involved executing script, and that script threw an
@@ -1281,6 +1143,10 @@
output it would just have the default state (typically read-write,
though that could depend on the scripting environment).</p>
+ <p class="note">Properties of Array objects are not treated any
+ differently than those of other Objects. In particular, this means
+ that non-index properties of arrays are copied as well.</p>
+
</li>
<li><p>Return <var title="">output</var>.</p></li>
@@ -1288,81 +1154,7 @@
</ol><p class="note">This algorithm preserves cycles and preserves the
identity of duplicate objects in graphs.</p>
- </div><h4 id="domstringmap-0"><span class="secno">2.8.6 </span>DOMStringMap</h4><p>The <code><a href="#domstringmap">DOMStringMap</a></code> interface represents a set of
- name-value pairs. It exposes these using the scripting language's
- native mechanisms for property access.</p><div class="impl">
-
- <p>When a <code><a href="#domstringmap">DOMStringMap</a></code> object is instantiated, it is
- associated with three algorithms, one for getting the list of
- name-value pairs, one for setting names to certain values, and one
- for deleting names.</p>
-
- <pre class="idl">interface <dfn id="domstringmap">DOMStringMap</dfn> {
- <a href="#dom-domstringmap-nameditem" title="dom-DOMStringMap-namedItem">getter</a> DOMString (in DOMString name);
- <a href="#dom-domstringmap-setitem" title="dom-DOMStringMap-setItem">setter</a> void (in DOMString name, in DOMString value);
- <a href="#dom-domstringmap-additem" title="dom-DOMStringMap-addItem">creator</a> void (in DOMString name, in DOMString value);
- <a href="#dom-domstringmap-removeitem" title="dom-DOMStringMap-removeItem">deleter</a> void (in DOMString name);
-};</pre>
-
- <p>The <a href="infrastructure.html#supported-property-names">supported property names</a> on a
- <code><a href="#domstringmap">DOMStringMap</a></code> object at any instant are the names of
- each pair returned from the algorithm for getting the list of
- name-value pairs at that instant.</p>
-
- <p>To <dfn id="dom-domstringmap-nameditem" title="dom-DOMStringMap-namedItem">determine the value of
- a named property</dfn> <var title="">name</var> in a
- <code><a href="#domstringmap">DOMStringMap</a></code>, the user agent must return the value
- component of the name-value pair whose name component is <var title="">name</var> in the list returned by the algorithm for
- getting the list of name-value pairs.</p>
-
- <p>To set the value of a <dfn id="dom-domstringmap-additem" title="dom-DOMStringMap-addItem">new</dfn> or <dfn id="dom-domstringmap-setitem" title="dom-DOMStringMap-setItem">existing</dfn> named property <var title="">name</var> to value <var title="">value</var>, the
- algorithm for setting names to certain values must be run, passing
- <var title="">name</var> as the name and the result of converting
- <var title="">value</var> to a <code>DOMString</code> as the
- value.</p>
-
- <p>To <dfn id="dom-domstringmap-removeitem" title="dom-DOMStringMap-removeItem">delete an existing
- named property</dfn> <var title="">name</var>, the algorithm for
- deleting names must be run, passing <var title="">name</var> as the
- name.</p>
-
- <p class="note">The <code><a href="#domstringmap">DOMStringMap</a></code> interface definition
- here is only intended for JavaScript environments. Other language
- bindings will need to define how <code><a href="#domstringmap">DOMStringMap</a></code> is to be
- implemented for those languages.</p>
-
- </div><div class="example">
-
- <p>The <code title="dom-dataset"><a href="elements.html#dom-dataset">dataset</a></code> attribute on
- elements exposes the <code title="attr-data-*"><a href="elements.html#attr-data">data-*</a></code>
- attributes on the element.</p>
-
- <p>Given the following fragment and elements with similar
- constructions:</p>
-
- <pre><img class="tower" id="tower5" data-x="12" data-y="5"
- data-ai="robotarget" data-hp="46" data-ability="flames"
- src="towers/rocket.png alt="Rocket Tower"></pre>
-
- <p>...one could imagine a function <code title="">splashDamage()</code> that takes some arguments, the first
- of which is the element to process:</p>
-
- <pre>function splashDamage(node, x, y, damage) {
- if (node.classList.contains('tower') && // checking the 'class' attribute
- node.dataset.x == x && // reading the 'data-x' attribute
- node.dataset.y == y) { // reading the 'data-y' attribute
- var hp = parseInt(node.dataset.hp); // reading the 'data-hp' attribute
- hp = hp - damage;
- if (hp < 0) {
- hp = 0;
- node.dataset.ai = 'dead'; // setting the 'data-ai' attribute
- delete node.dataset.ability; // removing the 'data-ability' attribute
- }
- node.dataset.hp = hp; // setting the 'data-hp' attribute
- }
-}</pre>
-
- </div><h4 id="dom-feature-strings"><span class="secno">2.8.7 </span>DOM feature strings</h4><p>DOM3 Core defines mechanisms for checking for interface support,
+ </div><h4 id="dom-feature-strings"><span class="secno">2.8.6 </span>DOM feature strings</h4><p>DOM3 Core defines mechanisms for checking for interface support,
and for obtaining implementations of interfaces, using <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMFeatures">feature
strings</a>. <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><p>Authors are strongly discouraged from using these, as they are
notoriously unreliable and imprecise. Authors are encouraged to rely
@@ -1375,41 +1167,9 @@
with <var title="">feature</var> set to either "<code title="">HTML</code>" or "<code title="">XHTML</code>" and <var title="">version</var> set to either "<code>1.0</code>" or
"<code>2.0</code>".</p>
- </div><h4 id="exceptions"><span class="secno">2.8.8 </span>Exceptions</h4><p>The following are <code><a href="infrastructure.html#domexception">DOMException</a></code> codes. <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><ol class="brief"><li value="1"><dfn id="index_size_err"><code>INDEX_SIZE_ERR</code></dfn></li>
- <li value="2"><dfn id="domstring_size_err"><code>DOMSTRING_SIZE_ERR</code></dfn></li>
- <li value="3"><dfn id="hierarchy_request_err"><code>HIERARCHY_REQUEST_ERR</code></dfn></li>
- <li value="4"><dfn id="wrong_document_err"><code>WRONG_DOCUMENT_ERR</code></dfn></li>
- <li value="5"><dfn id="invalid_character_err"><code>INVALID_CHARACTER_ERR</code></dfn></li>
- <li value="6"><dfn id="no_data_allowed_err"><code>NO_DATA_ALLOWED_ERR</code></dfn></li>
- <li value="7"><dfn id="no_modification_allowed_err"><code>NO_MODIFICATION_ALLOWED_ERR</code></dfn></li>
- <li value="8"><dfn id="not_found_err"><code>NOT_FOUND_ERR</code></dfn></li>
- <li value="9"><dfn id="not_supported_err"><code>NOT_SUPPORTED_ERR</code></dfn></li>
- <li value="10"><dfn id="inuse_attribute_err"><code>INUSE_ATTRIBUTE_ERR</code></dfn></li>
- <li value="11"><dfn id="invalid_state_err"><code>INVALID_STATE_ERR</code></dfn></li>
- <li value="12"><dfn id="syntax_err"><code>SYNTAX_ERR</code></dfn></li>
- <li value="13"><dfn id="invalid_modification_err"><code>INVALID_MODIFICATION_ERR</code></dfn></li>
- <li value="14"><dfn id="namespace_err"><code>NAMESPACE_ERR</code></dfn></li>
- <li value="15"><dfn id="invalid_access_err"><code>INVALID_ACCESS_ERR</code></dfn></li>
- <li value="16"><dfn id="validation_err"><code>VALIDATION_ERR</code></dfn></li>
- <li value="17"><dfn id="type_mismatch_err"><code>TYPE_MISMATCH_ERR</code></dfn></li>
- <li value="18"><dfn id="security_err"><code>SECURITY_ERR</code></dfn></li>
- <li value="19"><dfn id="network_err"><code>NETWORK_ERR</code></dfn></li>
- <li value="20"><dfn id="abort_err"><code>ABORT_ERR</code></dfn></li>
- <li value="21"><dfn id="url_mismatch_err"><code>URL_MISMATCH_ERR</code></dfn></li>
- <li value="22"><dfn id="quota_exceeded_err"><code>QUOTA_EXCEEDED_ERR</code></dfn></li>
- <li value="23"><dfn id="timeout_err"><code>TIMEOUT_ERR</code></dfn></li>
- <li value="25"><dfn id="data_clone_err"><code>DATA_CLONE_ERR</code></dfn></li>
- </ol><div class="impl">
-
- <pre class="idl">[Supplemental] exception DOMException {
- const unsigned short <a href="#url_mismatch_err">URL_MISMATCH_ERR</a> = 21;
- const unsigned short <a href="#quota_exceeded_err">QUOTA_EXCEEDED_ERR</a> = 22;
- const unsigned short <a href="#data_clone_err">DATA_CLONE_ERR</a> = 25;
-};</pre>
-
</div><div class="impl">
- <h4 id="garbage-collection"><span class="secno">2.8.9 </span>Garbage collection</h4>
+ <h4 id="garbage-collection"><span class="secno">2.8.7 </span>Garbage collection</h4>
<p>There is an <dfn id="implied-strong-reference">implied strong reference</dfn> from any IDL
attribute that returns a pre-existing object to that object.</p>
Index: parsing.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/parsing.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- parsing.html 17 Jun 2011 08:49:07 -0000 1.12
+++ parsing.html 24 Aug 2011 07:56:04 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -337,7 +340,7 @@
are covered by the next section, entitled "<a href="the-xhtml-syntax.html#the-xhtml-syntax">The XHTML
syntax</a>".</p>
- <p>For <a href="dom.html#html-documents">HTML documents</a>, user agents must use the parsing
+ <p>For <a href="infrastructure.html#html-documents">HTML documents</a>, user agents must use the parsing
rules described in this section to generate the DOM trees. Together,
these rules define what is referred to as the <dfn id="html-parser">HTML
parser</dfn>.</p>
@@ -390,12 +393,14 @@
<p>For the purposes of conformance checkers, if a resource is
determined to be in <a href="syntax.html#syntax">the HTML syntax</a>, then it is an
- <a href="dom.html#html-documents" title="HTML documents">HTML document</a>.</p>
+ <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>.</p>
</div><div class="impl">
<h4 id="overview-of-the-parsing-model"><span class="secno">8.2.1 </span>Overview of the parsing model</h4>
+ <p class="overview"><object data="images/parsing-model-overview.svg" height="450" width="345"><img alt="" height="450" src="http://dev.w3.org/html5/spec/images/parsing-model-overview.png" width="345"/></object></p>
+
<p>The input to the HTML parsing process consists of a stream of
Unicode code points, which is passed through a
<a href="tokenization.html#tokenization">tokenization</a> stage followed by a <a href="tree-construction.html#tree-construction">tree
@@ -408,10 +413,8 @@
still used as the model for the rest of the specification.</p>
<p>In the common case, the data handled by the tokenization stage
- comes from the network, but <a href="apis-in-html-documents.html#dynamic-markup-insertion" title="dynamic markup insertion">it can also come from script</a> running in the user
- agent, e.g. using the <code title="dom-document-write"><a href="apis-in-html-documents.html#dom-document-write">document.write()</a></code> API.</p>
-
- <p><img alt="" height="554" src="http://dev.w3.org/html5/spec/images/parsing-model-overview.png" width="427"/></p>
+ comes from the network, but <a href="content-models.html#dynamic-markup-insertion" title="dynamic markup insertion">it can also come from script</a> running in the user
+ agent, e.g. using the <code title="dom-document-write"><a href="content-models.html#dom-document-write">document.write()</a></code> API.</p>
<p id="nestedParsing">There is only one set of states for the
tokenizer stage and the tree construction stage, but the tree
@@ -625,12 +628,11 @@
is null, then jump to the second step of the overall "two
step" algorithm.</p></li>
- <li><p>If <var title="">mode</var> is true but <var title="">got pragma</var> is false, then jump to the second
+ <li><p>If <var title="">need pragma</var> is true but <var title="">got pragma</var> is false, then jump to the second
step of the overall "two step" algorithm.</p></li>
- <li><p>If <var title="">charset</var> is a UTF-16 encoding,
- change the value of <var title="">charset</var> to
- UTF-8.</p></li>
+ <li><p>If <var title="">charset</var> is <a href="infrastructure.html#a-utf-16-encoding">a UTF-16
+ encoding</a>, change the value of <var title="">charset</var> to UTF-8.</p></li>
<li><p>If <var title="">charset</var> is not a supported
character encoding, then jump to the second step of the
@@ -978,7 +980,7 @@
</td></tr></tbody></table></li>
- </ol><p>The <a href="dom.html#document-s-character-encoding">document's character encoding</a> must immediately
+ </ol><p>The <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a> must immediately
be set to the value returned from this algorithm, at the same time
as the user agent uses the returned value to select the decoder to
use for the input stream.</p>
@@ -1060,12 +1062,14 @@
violation</a> of the W3C Character Model specification, motivated
by a desire for compatibility with legacy content. <a href="references.html#refsCHARMOD">[CHARMOD]</a></p>
- <p>When a user agent is to use the UTF-16 encoding but no BOM has
- been found, user agents must default to UTF-16LE.</p>
+ <p>When a user agent is to use the self-describing UTF-16 encoding
+ but no BOM has been found, user agents must default to little-endian
+ UTF-16.</p>
- <p class="note">The requirement to default UTF-16 to LE rather than
- BE is a <a href="introduction.html#willful-violation">willful violation</a> of RFC 2781, motivated by a
- desire for compatibility with legacy content. <a href="references.html#refsRFC2781">[RFC2781]</a></p>
+ <p class="note">The requirement to default UTF-16 to little-endian
+ rather than big-endian is a <a href="introduction.html#willful-violation">willful violation</a> of RFC
+ 2781, motivated by a desire for compatibility with legacy content.
+ <a href="references.html#refsRFC2781">[RFC2781]</a></p>
<hr/><p>User agents must not support the CESU-8, UTF-7, BOCU-1 and SCSU
encodings. <a href="references.html#refsCESU8">[CESU8]</a> <a href="references.html#refsUTF7">[UTF7]</a> <a href="references.html#refsBOCU1">[BOCU1]</a> <a href="references.html#refsSCSU">[SCSU]</a></p>
@@ -1142,7 +1146,7 @@
<p>The <dfn id="insertion-point">insertion point</dfn> is the position (just before a
character or just before the end of the input stream) where content
- inserted using <code title="dom-document-write"><a href="apis-in-html-documents.html#dom-document-write">document.write()</a></code> is actually
+ inserted using <code title="dom-document-write"><a href="content-models.html#dom-document-write">document.write()</a></code> is actually
inserted. The insertion point is relative to the position of the
character immediately after it, it is not an absolute offset into
the input stream. Initially, the insertion point is
@@ -1150,9 +1154,9 @@
<p>The "EOF" character in the tables below is a conceptual character
representing the end of the <a href="#the-input-stream">input stream</a>. If the parser
- is a <a href="apis-in-html-documents.html#script-created-parser">script-created parser</a>, then the end of the
+ is a <a href="content-models.html#script-created-parser">script-created parser</a>, then the end of the
<a href="#the-input-stream">input stream</a> is reached when an <dfn id="explicit-eof-character">explicit "EOF"
- character</dfn> (inserted by the <code title="dom-document-close"><a href="apis-in-html-documents.html#dom-document-close">document.close()</a></code> method) is
+ character</dfn> (inserted by the <code title="dom-document-close"><a href="content-models.html#dom-document-close">document.close()</a></code> method) is
consumed. Otherwise, the "EOF" character is not a real character in
the stream, but rather the lack of any further characters.</p>
@@ -1176,20 +1180,20 @@
earlier section failed to find the right encoding.</li>
<li>If the encoding that is already being used to interpret the
- input stream is a UTF-16 encoding, then set the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> to
+ input stream is <a href="infrastructure.html#a-utf-16-encoding">a UTF-16 encoding</a>, then set the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> to
<i>certain</i> and abort these steps. The new encoding is ignored;
if it was anything but the same encoding, then it would be clearly
incorrect.</li>
- <li>If the new encoding is a UTF-16 encoding, change it to
- UTF-8.</li>
+ <li>If the new encoding is <a href="infrastructure.html#a-utf-16-encoding">a UTF-16 encoding</a>, change
+ it to UTF-8.</li>
<li>If all the bytes up to the last byte converted by the current
decoder have the same Unicode interpretations in both the current
encoding and the new encoding, and if the user agent supports
changing the converter on the fly, then the user agent may change
to the new converter for the encoding on the fly. Set the
- <a href="dom.html#document-s-character-encoding">document's character encoding</a> and the encoding used to
+ <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a> and the encoding used to
convert the input stream to the new encoding, set the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> to
<i>certain</i>, and abort these steps.</li>
Index: fetching-resources.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/fetching-resources.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- fetching-resources.html 17 Jun 2011 08:49:06 -0000 1.13
+++ fetching-resources.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -711,7 +714,10 @@
</td></tr></tbody></table><p>The empty string is also a valid keyword, and maps to the <a href="#attr-crossorigin-anonymous" title="attr-crossorigin-anonymous">Anonymous</a> state. The
attribute's <i>invalid value default</i> is the <a href="#attr-crossorigin-anonymous" title="attr-crossorigin-anonymous">Anonymous</a> state. The
<i>missing value default</i>, used when the attribute is omitted, is
- the <dfn id="attr-crossorigin-none" title="attr-crossorigin-none">No CORS</dfn> state.</p><h4 id="cors-enabled-fetch"><span class="secno">2.7.6 </span>CORS-enabled fetch</h4><p>When the user agent is required to perform a <dfn id="potentially-cors-enabled-fetch">potentially
+ the <dfn id="attr-crossorigin-none" title="attr-crossorigin-none">No CORS</dfn> state.</p><div class="impl">
+ <h4 id="cors-enabled-fetch"><span class="secno">2.7.6 </span>CORS-enabled fetch</h4>
+
+ <p>When the user agent is required to perform a <dfn id="potentially-cors-enabled-fetch">potentially
CORS-enabled fetch</dfn> of an <a href="urls.html#absolute-url">absolute URL</a> <var title="">URL</var>, with a mode <var title="">mode</var> that is
either "<a href="#attr-crossorigin-none" title="attr-crossorigin-none">No CORS</a>", "<a href="#attr-crossorigin-anonymous" title="attr-crossorigin-anonymous">Anonymous</a>", or "<a href="#attr-crossorigin-use-credentials" title="attr-crossorigin-use-credentials">Use Credentials</a>",
an <a href="origin-0.html#origin">origin</a> <var title="">origin</var>, and a default
@@ -721,7 +727,9 @@
is only used if <var title="">mode</var> is "<a href="#attr-crossorigin-none" title="attr-crossorigin-none">No CORS</a>". This algorithm wraps
the <a href="#fetch">fetch</a> algorithm above, and labels the obtained
resource as either <dfn id="cors-same-origin">CORS-same-origin</dfn> or
- <dfn id="cors-cross-origin">CORS-cross-origin</dfn>, or blocks the resource entirely.</p><dl class="switch"><dt>If <var title="">mode</var> is "<a href="#attr-crossorigin-none" title="attr-crossorigin-none">No CORS</a>"</dt>
+ <dfn id="cors-cross-origin">CORS-cross-origin</dfn>, or blocks the resource entirely.</p>
+
+ <dl class="switch"><dt>If <var title="">mode</var> is "<a href="#attr-crossorigin-none" title="attr-crossorigin-none">No CORS</a>"</dt>
<dd>
@@ -785,7 +793,7 @@
<dd>
- <p>Tbe <a href="webappapis.html#concept-task" title="concept-task">tasks</a> from the
+ <p>The <a href="webappapis.html#concept-task" title="concept-task">tasks</a> from the
<a href="#fetch">fetch</a> algorithm are <a href="webappapis.html#queue-a-task" title="queue a task">queued</a> normally, but for the purposes of the
calling algorithm, the obtained resource is
<a href="#cors-cross-origin">CORS-cross-origin</a>. The user agent may report a
@@ -798,7 +806,7 @@
<dd>
- <p>Tbe <a href="webappapis.html#concept-task" title="concept-task">tasks</a> from the
+ <p>The <a href="webappapis.html#concept-task" title="concept-task">tasks</a> from the
<a href="#fetch">fetch</a> algorithm are <a href="webappapis.html#queue-a-task" title="queue a task">queued</a> normally, and for the purposes of the
calling algorithm, the obtained resource is
<a href="#cors-same-origin">CORS-same-origin</a>.</p>
@@ -849,7 +857,7 @@
<dd>
- <p>Tbe <a href="webappapis.html#concept-task" title="concept-task">tasks</a> from the
+ <p>The <a href="webappapis.html#concept-task" title="concept-task">tasks</a> from the
<a href="#fetch">fetch</a> algorithm are <a href="webappapis.html#queue-a-task" title="queue a task">queued</a> normally, and for the purposes of the
calling algorithm, the obtained resource is
<a href="#cors-same-origin">CORS-same-origin</a>.</p>
@@ -860,4 +868,4 @@
</ol></dd>
- </dl></body></html>
+ </dl></div></body></html>
Index: origin-0.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/origin-0.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- origin-0.html 17 Jun 2011 08:49:07 -0000 1.14
+++ origin-0.html 24 Aug 2011 07:56:04 -0000 1.15
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -764,7 +767,7 @@
<ol><li>
<p>If the <code><a href="infrastructure.html#document">Document</a></code> has no <a href="browsers.html#browsing-context">browsing
- context</a>, throw a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception and
+ context</a>, throw a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception and
abort these steps.</p>
</li>
@@ -779,7 +782,7 @@
<p>If ToASCII fails to convert one of the components of the
string, e.g. because it is too long or because it contains invalid
- characters, then throw a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception and abort
+ characters, then throw a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception and abort
these steps. <a href="references.html#refsRFC3490">[RFC3490]</a></p>
</li>
@@ -793,7 +796,7 @@
<ol><li>
<p>If the current value is an IP address, throw a
- <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception and abort these steps.</p>
+ <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception and abort these steps.</p>
</li>
@@ -801,7 +804,7 @@
<p>If <var title="">new value</var>, prefixed by a U+002E FULL
STOP (.), does not exactly match the end of the current value,
- throw a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception and abort these
+ throw a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception and abort these
steps.</p>
</li>
@@ -812,7 +815,7 @@
Public Suffix List, or, if <var title="">new value</var>,
prefixed by a U+002E FULL STOP (.), matches the end of a
suffix in the Public Suffix List, then throw a
- <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception and abort these steps. <a href="references.html#refsPSL">[PSL]</a></p>
+ <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception and abort these steps. <a href="references.html#refsPSL">[PSL]</a></p>
<p>Suffixes must be compared after applying the IDNA ToASCII
algorithm to them, with both the AllowUnassigned and
Index: common-input-element-attributes.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/common-input-element-attributes.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- common-input-element-attributes.html 17 Jun 2011 08:49:05 -0000 1.13
+++ common-input-element-attributes.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -525,7 +528,7 @@
important to the content, then simply using a <code><a href="the-button-element.html#the-datalist-element">datalist</a></code>
element with children <code><a href="the-button-element.html#the-option-element">option</a></code> elements is enough. To
prevent the values from being rendered in legacy user agents, they
- should be placed inside the <code title="attr-option-value"><a href="the-button-element.html#attr-option-value">value</a></code> attribute instead of
+ need to be placed inside the <code title="attr-option-value"><a href="the-button-element.html#attr-option-value">value</a></code> attribute instead of
inline.</p>
<pre><p>
@@ -565,8 +568,8 @@
<p>The fallback content will only be shown in UAs that don't
support <code><a href="the-button-element.html#the-datalist-element">datalist</a></code>. The options, on the other hand, will
- be detected by all UAs, even though they are not direct children of
- the <code><a href="the-button-element.html#the-datalist-element">datalist</a></code> element.</p>
+ be detected by all UAs, even though they are not children of the
+ <code><a href="the-button-element.html#the-datalist-element">datalist</a></code> element.</p>
<p>Note that if an <code><a href="the-button-element.html#the-option-element">option</a></code> element used in a
<code><a href="the-button-element.html#the-datalist-element">datalist</a></code> is <code title="attr-option-selected"><a href="the-button-element.html#attr-option-selected">selected</a></code>, it will be selected
@@ -722,7 +725,7 @@
thus forcing any conversation through this medium to be terse and
discouraging intelligent discourse.</p>
- <pre>What are you doing? <input name=status maxlength=140></pre>
+ <pre><label>What are you doing? <input name=status maxlength=140></label></pre>
</div><h6 id="the-pattern-attribute"><span class="secno">4.10.7.2.9 </span>The <code title="attr-input-pattern"><a href="#attr-input-pattern">pattern</a></code> attribute</h6><p>The <dfn id="attr-input-pattern" title="attr-input-pattern"><code>pattern</code></dfn>
attribute specifies a regular expression against which the control's
@@ -757,12 +760,16 @@
entirety of each of the element's <a href="association-of-controls-and-forms.html#concept-fe-values" title="concept-fe-values">value<em>s</em></a>, then the element
is <a href="association-of-controls-and-forms.html#suffering-from-a-pattern-mismatch">suffering from a pattern mismatch</a>.</p>
+ <p>The <a href="#compiled-pattern-regular-expression">compiled pattern regular expression</a>, when
+ matched against a string, must have its start anchored to the start
+ of the string and its end anchored to the end of the string.</p>
+
<p class="note">This implies that the regular expression language
used for this attribute is the same as that used in JavaScript,
except that the <code title="attr-input-pattern"><a href="#attr-input-pattern">pattern</a></code>
- attribute must match the entire value, not just any subset (somewhat
- as if it implied a <code title="">^(?:</code> at the start of the
- pattern and a <code title="">)$</code> at the end).</p>
+ attribute is matched against the entire value, not just any subset
+ (somewhat as if it implied a <code title="">^(?:</code> at the start
+ of the pattern and a <code title="">)$</code> at the end).</p>
</div><p>When an <code><a href="the-input-element.html#the-input-element">input</a></code> element has a <code title="attr-input-pattern"><a href="#attr-input-pattern">pattern</a></code> attribute specified,
authors should include a <code title="attr-title"><a href="elements.html#the-title-attribute">title</a></code>
@@ -961,7 +968,7 @@
<p>Can be set, to change the value.</p>
- <p>Throws an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if it is
+ <p>Throws an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if it is
set to any value other than the empty string when the control is a
file upload control.</p>
@@ -999,7 +1006,7 @@
<p>Can be set, to change the value.</p>
- <p>Throws an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the
+ <p>Throws an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the
control isn't date- or time-based.</p>
</dd>
@@ -1013,7 +1020,7 @@
<p>Can be set, to change the value.</p>
- <p>Throws an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the
+ <p>Throws an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the
control is neither date- or time-based nor numeric.</p>
</dd>
@@ -1028,7 +1035,7 @@
<var title="">n</var>. The default value for <var title="">n</var>
is 1.</p>
- <p>Throws <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the control
+ <p>Throws <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the control
is neither date- or time-based nor numeric, if the <code title="attr-input-step"><a href="#attr-input-step">step</a></code> attribute's value is "<code title="">any</code>", if the current <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a> could not be parsed, or if
stepping in the given direction by the given amount would take the
value out of range.</p>
@@ -1108,7 +1115,7 @@
first file in the list of <a href="number-state.html#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>, if
any, or the empty string if the list is empty. On setting, if the
new value is the empty string, it must empty the list of <a href="number-state.html#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>;
- otherwise, it must throw an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code>
+ otherwise, it must throw an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code>
exception.</p>
<p class="note">This "fakepath" requirement is a sad accident of
@@ -1146,7 +1153,7 @@
<p>On setting, if the <code title="dom-input-valueAsDate"><a href="#dom-input-valueasdate">valueAsDate</a></code> attribute does not
apply, as defined for the <code><a href="the-input-element.html#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="the-input-element.html#attr-input-type">type</a></code> attribute's current state, then
- throw an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception; otherwise, if
+ throw an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception; otherwise, if
the new value is null, then set the <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a> of the element to the empty
string; otherwise, run the <a href="the-input-element.html#concept-input-value-date-string" title="concept-input-value-date-string">algorithm to convert a
<code>Date</code> object to a string</a>, as defined for that
@@ -1173,7 +1180,7 @@
<p>On setting, if the <code title="dom-input-valueAsNumber"><a href="#dom-input-valueasnumber">valueAsNumber</a></code> attribute does
not apply, as defined for the <code><a href="the-input-element.html#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="the-input-element.html#attr-input-type">type</a></code> attribute's current state, then
- throw an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception. Otherwise, if
+ throw an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception. Otherwise, if
the <code title="dom-input-valueAsDate"><a href="#dom-input-valueasdate">valueAs<em>Date</em></a></code>
attribute applies, run the <a href="the-input-element.html#concept-input-value-date-string" title="concept-input-value-date-string">algorithm to convert a
<code>Date</code> object to a string</a> defined for that state,
@@ -1190,17 +1197,17 @@
<ol><li><p>If the <code title="dom-input-stepDown"><a href="#dom-input-stepdown">stepDown()</a></code> and
<code title="dom-input-stepUp"><a href="#dom-input-stepup">stepUp()</a></code> methods do not
apply, as defined for the <code><a href="the-input-element.html#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="the-input-element.html#attr-input-type">type</a></code> attribute's current state, then
- throw an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception, and abort these
+ throw an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception, and abort these
steps.</p></li>
<li><p>If the element has no <a href="#concept-input-step" title="concept-input-step">allowed value step</a>, then throw an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception, and abort these
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception, and abort these
steps.</p></li>
<li><p>If applying the <a href="the-input-element.html#concept-input-value-string-number" title="concept-input-value-string-number">algorithm to convert a
string to a number</a> to the string given by the element's
<a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a> results in an error,
- then throw an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception, and abort
+ then throw an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception, and abort
these steps; otherwise, let <var title="">value</var> be the result
of that algorithm.</p></li>
@@ -1214,10 +1221,10 @@
<li><p>Let <var title="">value</var> be the result of adding <var title="">delta</var> to <var title="">value</var>.</p></li>
<li><p>If the element has a <a href="#concept-input-min" title="concept-input-min">minimum</a>, and the <var title="">value</var> is less than that <a href="#concept-input-min" title="concept-input-min">minimum</a>, then throw a
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception.</p></li>
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception.</p></li>
<li><p>If the element has a <a href="#concept-input-max" title="concept-input-max">maximum</a>, and the <var title="">value</var> is greater than that <a href="#concept-input-max" title="concept-input-max">maximum</a>, then throw a
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception.</p></li>
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception.</p></li>
<li><p>Let <var title="">value as string</var> be the result of
running the <a href="the-input-element.html#concept-input-value-number-string" title="concept-input-value-number-string">algorithm to convert a
Index: dom.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/dom.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- dom.html 17 Jun 2011 08:49:05 -0000 1.13
+++ dom.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -325,7 +328,7 @@
<a href="elements.html" class="next">3.2 Elements</a>
<ol class="toc"><li><a href="dom.html#dom"><span class="secno">3 </span>Semantics, structure, and APIs of HTML documents</a>
<ol><li><a href="dom.html#documents"><span class="secno">3.1 </span>Documents</a>
- <ol><li><a href="dom.html#documents-in-the-dom"><span class="secno">3.1.1 </span>Documents in the DOM</a></li><li><a href="dom.html#security-document"><span class="secno">3.1.2 </span>Security</a></li><li><a href="dom.html#resource-metadata-management"><span class="secno">3.1.3 </span>Resource metadata management</a></li><li><a href="dom.html#dom-tree-accessors"><span class="secno">3.1.4 </span>DOM tree accessors</a></li><li><a href="dom.html#creating-documents"><span class="secno">3.1.5 </span>Creating documents</a></li><li><a href="dom.html#loading-xml-documents"><span class="secno">3.1.6 </span>Loading XML documents</a></li></ol></li></ol></li></ol></div><h2 id="dom"><span class="secno">3 </span>Semantics, structure, and APIs of HTML documents</h2><h3 id="documents"><span class="secno">3.1 </span>Documents</h3><p>Every XML and HTML document in an HTML UA is represented by a
+ <ol><li><a href="dom.html#documents-in-the-dom"><span class="secno">3.1.1 </span>Documents in the DOM</a></li><li><a href="dom.html#security-document"><span class="secno">3.1.2 </span>Security</a></li><li><a href="dom.html#resource-metadata-management"><span class="secno">3.1.3 </span>Resource metadata management</a></li><li><a href="dom.html#dom-tree-accessors"><span class="secno">3.1.4 </span>DOM tree accessors</a></li><li><a href="dom.html#loading-xml-documents"><span class="secno">3.1.5 </span>Loading XML documents</a></li></ol></li></ol></li></ol></div><h2 id="dom"><span class="secno">3 </span>Semantics, structure, and APIs of HTML documents</h2><h3 id="documents"><span class="secno">3.1 </span>Documents</h3><p>Every XML and HTML document in an HTML UA is represented by a
<code><a href="infrastructure.html#document">Document</a></code> object. <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><p><dfn id="the-document-s-address">The document's address</dfn> is an <a href="urls.html#absolute-url">absolute URL</a>
that is set when the <code><a href="infrastructure.html#document">Document</a></code> is created. <dfn id="the-document-s-current-address">The
document's current address</dfn> is an <a href="urls.html#absolute-url">absolute URL</a>
@@ -337,14 +340,12 @@
current address</a> must be set to <a href="#the-document-s-address">the document's
address</a> when the <code><a href="infrastructure.html#document">Document</a></code> is created.</span></p><p class="note">Interactive user agents typically expose <a href="#the-document-s-current-address">the
document's current address</a> in their user interface.</p><p>When a <code><a href="infrastructure.html#document">Document</a></code> is created by a <a href="webappapis.html#concept-script" title="concept-script">script</a> using the <code title="dom-DOMImplementation-createDocument"><a href="infrastructure.html#dom-domimplementation-createdocument">createDocument()</a></code>
- or <code title="dom-DOMHTMLImplementation-createHTMLDocument"><a href="#dom-domhtmlimplementation-createhtmldocument">createHTMLDocument()</a></code>
+ or <code title="dom-DOMHTMLImplementation-createHTMLDocument">createHTMLDocument()</code>
APIs, <a href="#the-document-s-address">the document's address</a> is the same as <a href="#the-document-s-address">the
- document's address</a> of the <a href="webappapis.html#script-s-document">script's document</a>.</p><p><code><a href="infrastructure.html#document">Document</a></code> objects are assumed to be <dfn id="xml-documents">XML
- documents</dfn> unless they are flagged as being <dfn id="html-documents">HTML
- documents</dfn> when they are created. Whether a document is an
- <a href="#html-documents" title="HTML documents">HTML document</a> or an <a href="#xml-documents" title="XML documents">XML document</a> affects the behavior of
- certain APIs and the case-sensitivity of some selectors.</p><p>Each <code><a href="infrastructure.html#document">Document</a></code> object has a <dfn id="reload-override-flag">reload override
- flag</dfn> that is originally unset. The flag is set by the <code title="dom-document-open"><a href="apis-in-html-documents.html#dom-document-open">document.open()</a></code> and <code title="dom-document-open"><a href="apis-in-html-documents.html#dom-document-open">document.write()</a></code> methods in certain
+ document's address</a> of the <a href="webappapis.html#script-s-document">script's document</a>, and
+ the <code><a href="infrastructure.html#document">Document</a></code> is both <a href="the-end.html#ready-for-post-load-tasks">ready for post-load
+ tasks</a> and <a href="the-end.html#completely-loaded">completely loaded</a> immediately.</p><p>Each <code><a href="infrastructure.html#document">Document</a></code> object has a <dfn id="reload-override-flag">reload override
+ flag</dfn> that is originally unset. The flag is set by the <code title="dom-document-open"><a href="content-models.html#dom-document-open">document.open()</a></code> and <code title="dom-document-open"><a href="content-models.html#dom-document-open">document.write()</a></code> methods in certain
situations. When the flag is set, the <code><a href="infrastructure.html#document">Document</a></code> also has
a <dfn id="reload-override-buffer">reload override buffer</dfn> which is a Unicode string that
is used as the source of the document when it is reloaded.</p><p>When the user agent is to perform <dfn id="an-overridden-reload">an overridden
@@ -363,7 +364,7 @@
this specification) <span class="impl">must</span> also implement
the <code><a href="#htmldocument">HTMLDocument</a></code> interface, available using
binding-specific methods. (This is the case whether or not the
- document in question is an <a href="#html-documents" title="HTML documents">HTML
+ document in question is an <a href="infrastructure.html#html-documents" title="HTML documents">HTML
document</a> or indeed whether it contains any <a href="infrastructure.html#html-elements">HTML
elements</a> at all.) <code><a href="infrastructure.html#document">Document</a></code> objects <span class="impl">must</span> also implement the document-level interface
of any other namespaces that the UA supports.</p><p class="example">For example, if an HTML implementation also
@@ -380,49 +381,44 @@
readonly attribute DOMString <a href="#dom-document-referrer" title="dom-document-referrer">referrer</a>;
attribute DOMString <a href="#dom-document-cookie" title="dom-document-cookie">cookie</a>;
readonly attribute DOMString <a href="#dom-document-lastmodified" title="dom-document-lastModified">lastModified</a>;
- readonly attribute DOMString <a href="#dom-document-compatmode" title="dom-document-compatMode">compatMode</a>;
- attribute DOMString <a href="#dom-document-charset" title="dom-document-charset">charset</a>;
- readonly attribute DOMString <a href="#dom-document-characterset" title="dom-document-characterSet">characterSet</a>;
- readonly attribute DOMString <a href="#dom-document-defaultcharset" title="dom-document-defaultCharset">defaultCharset</a>;
readonly attribute DOMString <a href="#dom-document-readystate" title="dom-document-readyState">readyState</a>;
// <a href="#dom-tree-accessors">DOM tree accessors</a>
- <a href="#dom-document-nameditem" title="dom-document-namedItem">getter</a> any (in DOMString name);
+ <a href="#dom-document-nameditem" title="dom-document-namedItem">getter</a> object (DOMString name);
attribute DOMString <a href="#document.title" title="dom-document-title">title</a>;
attribute DOMString <a href="elements.html#dom-document-dir" title="dom-document-dir">dir</a>;
attribute <a href="elements.html#htmlelement">HTMLElement</a>? <a href="#dom-document-body" title="dom-document-body">body</a>;
readonly attribute <a href="semantics.html#htmlheadelement">HTMLHeadElement</a>? <a href="#dom-document-head" title="dom-document-head">head</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-images" title="dom-document-images">images</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-embeds" title="dom-document-embeds">embeds</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-plugins" title="dom-document-plugins">plugins</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-links" title="dom-document-links">links</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-forms" title="dom-document-forms">forms</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-scripts" title="dom-document-scripts">scripts</a>;
- NodeList <a href="#dom-document-getelementsbyname" title="dom-document-getElementsByName">getElementsByName</a>(in DOMString elementName);
- NodeList <a href="#dom-document-getelementsbyclassname" title="dom-document-getElementsByClassName">getElementsByClassName</a>(in DOMString classNames);
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-images" title="dom-document-images">images</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-embeds" title="dom-document-embeds">embeds</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-plugins" title="dom-document-plugins">plugins</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-links" title="dom-document-links">links</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-forms" title="dom-document-forms">forms</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-scripts" title="dom-document-scripts">scripts</a>;
+ NodeList <a href="#dom-document-getelementsbyname" title="dom-document-getElementsByName">getElementsByName</a>(DOMString elementName);
- // <a href="apis-in-html-documents.html#dynamic-markup-insertion">dynamic markup insertion</a>
- attribute DOMString <a href="apis-in-html-documents.html#dom-innerhtml" title="dom-innerHTML">innerHTML</a>;
- <a href="#htmldocument">HTMLDocument</a> <a href="apis-in-html-documents.html#dom-document-open" title="dom-document-open">open</a>(in optional DOMString type, in optional DOMString replace);
- <a href="browsers.html#windowproxy">WindowProxy</a> <a href="apis-in-html-documents.html#dom-document-open" title="dom-document-open">open</a>(in DOMString url, in DOMString name, in DOMString features, in optional boolean replace);
- void <a href="apis-in-html-documents.html#dom-document-close" title="dom-document-close">close</a>();
- void <a href="apis-in-html-documents.html#dom-document-write" title="dom-document-write">write</a>(in DOMString... text);
- void <a href="apis-in-html-documents.html#dom-document-writeln" title="dom-document-writeln">writeln</a>(in DOMString... text);
+ // <a href="content-models.html#dynamic-markup-insertion">dynamic markup insertion</a>
+ attribute DOMString <a href="content-models.html#dom-innerhtml" title="dom-innerHTML">innerHTML</a>;
+ <a href="#htmldocument">HTMLDocument</a> <a href="content-models.html#dom-document-open" title="dom-document-open">open</a>(optional DOMString type, optional DOMString replace);
+ <a href="browsers.html#windowproxy">WindowProxy</a> <a href="content-models.html#dom-document-open" title="dom-document-open">open</a>(DOMString url, DOMString name, DOMString features, optional boolean replace);
+ void <a href="content-models.html#dom-document-close" title="dom-document-close">close</a>();
+ void <a href="content-models.html#dom-document-write" title="dom-document-write">write</a>(DOMString... text);
+ void <a href="content-models.html#dom-document-writeln" title="dom-document-writeln">writeln</a>(DOMString... text);
// <a href="editing.html#editing">user interaction</a>
readonly attribute <a href="browsers.html#windowproxy">WindowProxy</a>? <a href="browsers.html#dom-document-defaultview" title="dom-document-defaultView">defaultView</a>;
readonly attribute <a href="infrastructure.html#element">Element</a>? <a href="editing.html#dom-document-activeelement" title="dom-document-activeElement">activeElement</a>;
boolean <a href="editing.html#dom-document-hasfocus" title="dom-document-hasFocus">hasFocus</a>();
attribute DOMString <a href="editing.html#designMode" title="dom-document-designMode">designMode</a>;
- boolean <a href="dnd.html#execCommand" title="dom-document-execCommand">execCommand</a>(in DOMString commandId);
- boolean <a href="dnd.html#execCommand" title="dom-document-execCommand">execCommand</a>(in DOMString commandId, in boolean showUI);
- boolean <a href="dnd.html#execCommand" title="dom-document-execCommand">execCommand</a>(in DOMString commandId, in boolean showUI, in DOMString value);
- boolean <a href="dnd.html#dom-document-querycommandenabled" title="dom-document-queryCommandEnabled">queryCommandEnabled</a>(in DOMString commandId);
- boolean <a href="dnd.html#dom-document-querycommandindeterm" title="dom-document-queryCommandIndeterm">queryCommandIndeterm</a>(in DOMString commandId);
- boolean <a href="dnd.html#dom-document-querycommandstate" title="dom-document-queryCommandState">queryCommandState</a>(in DOMString commandId);
- boolean <a href="dnd.html#dom-document-querycommandsupported" title="dom-document-queryCommandSupported">queryCommandSupported</a>(in DOMString commandId);
- DOMString <a href="dnd.html#dom-document-querycommandvalue" title="dom-document-queryCommandValue">queryCommandValue</a>(in DOMString commandId);
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="commands.html#dom-document-commands" title="dom-document-commands">commands</a>;
+ boolean <a href="dnd.html#execCommand" title="dom-document-execCommand">execCommand</a>(DOMString commandId);
+ boolean <a href="dnd.html#execCommand" title="dom-document-execCommand">execCommand</a>(DOMString commandId, boolean showUI);
+ boolean <a href="dnd.html#execCommand" title="dom-document-execCommand">execCommand</a>(DOMString commandId, boolean showUI, DOMString value);
+ boolean <a href="dnd.html#dom-document-querycommandenabled" title="dom-document-queryCommandEnabled">queryCommandEnabled</a>(DOMString commandId);
+ boolean <a href="dnd.html#dom-document-querycommandindeterm" title="dom-document-queryCommandIndeterm">queryCommandIndeterm</a>(DOMString commandId);
+ boolean <a href="dnd.html#dom-document-querycommandstate" title="dom-document-queryCommandState">queryCommandState</a>(DOMString commandId);
+ boolean <a href="dnd.html#dom-document-querycommandsupported" title="dom-document-queryCommandSupported">queryCommandSupported</a>(DOMString commandId);
+ DOMString <a href="dnd.html#dom-document-querycommandvalue" title="dom-document-queryCommandValue">queryCommandValue</a>(DOMString commandId);
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="commands.html#dom-document-commands" title="dom-document-commands">commands</a>;
// <a href="webappapis.html#event-handler-idl-attributes">event handler IDL attributes</a>
attribute <a href="webappapis.html#function">Function</a>? <a href="webappapis.html#handler-onabort" title="handler-onabort">onabort</a>;
@@ -483,8 +479,8 @@
<a href="infrastructure.html#document">Document</a> implements <a href="#htmldocument">HTMLDocument</a>;</pre><p>Since the <code><a href="#htmldocument">HTMLDocument</a></code> interface holds methods and
attributes related to a number of disparate features, the members of
this interface are described in various different sections.</p><h4 id="security-document"><span class="secno">3.1.2 </span>Security</h4><p id="security">User agents <span class="impl">must</span> raise a
- <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception whenever any of the members of
- an <code><a href="#htmldocument">HTMLDocument</a></code> object are accessed by scripts whose
+ <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception whenever any properties of a
+ <code><a href="infrastructure.html#document">Document</a></code> object are accessed by scripts whose
<a href="origin-0.html#effective-script-origin">effective script origin</a> is not the <a href="origin-0.html#same-origin" title="same origin">same</a> as the <code><a href="infrastructure.html#document">Document</a></code>'s <a href="origin-0.html#effective-script-origin">effective
script origin</a>.</p><h4 id="resource-metadata-management"><span class="secno">3.1.3 </span><dfn>Resource metadata management</dfn></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-URL"><a href="#dom-document-url">URL</a></code></dt>
<dd>
@@ -531,7 +527,7 @@
<p>If the contents are <a href="the-iframe-element.html#sandboxed-origin-browsing-context-flag" title="sandboxed origin browsing context flag">sandboxed into a unique origin</a> (in an
<code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> with the <code title="attr-iframe-sandbox"><a href="the-iframe-element.html#attr-iframe-sandbox">sandbox</a></code> attribute) or the
resource was labeled as <code><a href="iana.html#text-html-sandboxed">text/html-sandboxed</a></code>, a
- <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception will be thrown on getting and
+ <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception will be thrown on getting and
setting.</p>
</dd>
@@ -556,7 +552,7 @@
agent must return the empty string. Otherwise, if the
<code><a href="infrastructure.html#document">Document</a></code>'s <a href="origin-0.html#origin">origin</a> is not a
scheme/host/port tuple, the user agent must raise a
- <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception. Otherwise, the user agent must
+ <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception. Otherwise, the user agent must
first <a href="webappapis.html#obtain-the-storage-mutex">obtain the storage mutex</a> and then return the
cookie-string for <a href="#the-document-s-address">the document's address</a> for a
"non-HTTP" API, <a href="infrastructure.html#decoded-as-utf-8-with-error-handling">decoded as UTF-8, with error handling</a>.
@@ -566,7 +562,7 @@
<code>Document</code> object</a>, then the user agent must do
nothing. Otherwise, if the <code><a href="infrastructure.html#document">Document</a></code>'s
<a href="origin-0.html#origin">origin</a> is not a scheme/host/port tuple, the user agent
- must raise a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception. Otherwise, the
+ must raise a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception. Otherwise, the
user agent must <a href="webappapis.html#obtain-the-storage-mutex">obtain the storage mutex</a> and then act
as it would when <a href="infrastructure.html#receives-a-set-cookie-string" title="receives a set-cookie-string">receiving a set-cookie-string</a> for
<a href="#the-document-s-address">the document's address</a> via a "non-HTTP" API, consisting
@@ -630,74 +626,6 @@
the last modification date and time are not known, the attribute
must return the current date and time in the above format.</p>
- <hr/></div><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-compatmode"><a href="#dom-document-compatmode">compatMode</a></code></dt>
- <dd>
- <p>In a conforming document, returns the string "<code title="">CSS1Compat</code>". (In <a href="#quirks-mode">quirks mode</a>
- documents, returns the string "<code title="">BackCompat</code>",
- but a conforming document can never trigger <a href="#quirks-mode">quirks
- mode</a>.)</p>
- </dd>
-
- </dl><div class="impl">
-
- <p>A <code><a href="infrastructure.html#document">Document</a></code> is always set to one of three modes:
- <dfn id="no-quirks-mode">no-quirks mode</dfn>, the default; <dfn id="quirks-mode">quirks mode</dfn>, used
- typically for legacy documents; and <dfn id="limited-quirks-mode">limited-quirks mode</dfn>,
- also known as "almost standards" mode. The mode is only ever changed
- from the default by the <a href="parsing.html#html-parser">HTML parser</a>, based on the
- presence, absence, or value of the DOCTYPE string.</p>
-
- <p>The <dfn id="dom-document-compatmode" title="dom-document-compatMode"><code>compatMode</code></dfn> IDL
- attribute must return the literal string "<code title="">CSS1Compat</code>" unless the document has been set to
- <a href="#quirks-mode">quirks mode</a> by the <a href="parsing.html#html-parser">HTML parser</a>, in which
- case it must instead return the literal string "<code title="">BackCompat</code>".</p>
-
- <hr/></div><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-charset"><a href="#dom-document-charset">charset</a></code> [ = <var title="">value</var> ]</dt>
- <dd>
- <p>Returns the <a href="#document-s-character-encoding">document's character encoding</a>.</p>
- <p>Can be set, to dynamically change the <a href="#document-s-character-encoding">document's
- character encoding</a>.</p>
- <p>New values that are not IANA-registered aliases supported by the user agent are ignored.</p>
- </dd>
-
- <dt><var title="">document</var> . <code title="dom-document-characterSet"><a href="#dom-document-characterset">characterSet</a></code></dt>
- <dd>
- <p>Returns the <a href="#document-s-character-encoding">document's character encoding</a>.</p>
- </dd>
-
- <dt><var title="">document</var> . <code title="dom-document-defaultCharset"><a href="#dom-document-defaultcharset">defaultCharset</a></code></dt>
- <dd>
- <p>Returns what might be the user agent's default character
- encoding. (The user agent might return another character encoding
- altogether, e.g. to protect the user's privacy, or if the user
- agent doesn't use a single default encoding.)</p>
- </dd>
-
- </dl><div class="impl">
-
- <p>Documents have an associated <dfn id="document-s-character-encoding" title="document's character encoding">character encoding</dfn>. When a <code><a href="infrastructure.html#document">Document</a></code>
- object is created, the <a href="#document-s-character-encoding">document's character encoding</a>
- must be initialized to UTF-16. Various algorithms during page
- loading affect this value, as does the <code title="dom-document-charset"><a href="#dom-document-charset">charset</a></code> setter. <a href="references.html#refsIANACHARSET">[IANACHARSET]</a></p>
-
- <p>The <dfn id="dom-document-charset" title="dom-document-charset"><code>charset</code></dfn>
- IDL attribute must, on getting, return the <a href="infrastructure.html#preferred-mime-name">preferred MIME
- name</a> of the <a href="#document-s-character-encoding">document's character encoding</a>. On
- setting, if the new value is an IANA-registered alias for a
- character encoding supported by the user agent, the <a href="#document-s-character-encoding">document's
- character encoding</a> must be set to that character
- encoding. (Otherwise, nothing happens.)</p>
-
- <p>The <dfn id="dom-document-characterset" title="dom-document-characterSet"><code>characterSet</code></dfn>
- IDL attribute must, on getting, return the <a href="infrastructure.html#preferred-mime-name">preferred MIME
- name</a> of the <a href="#document-s-character-encoding">document's character encoding</a>.</p>
-
- <p>The <dfn id="dom-document-defaultcharset" title="dom-document-defaultCharset"><code>defaultCharset</code></dfn>
- IDL attribute must, on getting, return the <a href="infrastructure.html#preferred-mime-name">preferred MIME
- name</a> of a character encoding, possibly the user's default
- encoding, or an encoding associated with the user's current
- geographical location, or any arbitrary encoding name.</p>
-
<hr/></div><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-readyState"><a href="#dom-document-readystate">readyState</a></code></dt>
<dd>
<p>Returns "loading" while the <code><a href="infrastructure.html#document">Document</a></code> is loading, "interactive" once it is finished parsing but still loading sub-resources, and "complete" once it has loaded.</p>
@@ -774,7 +702,7 @@
<li><p>Replace any sequence of one or more consecutive <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a> in <var title="">value</var> with a single U+0020 SPACE character.</p></li>
- <li><p>Remove any leading or trailing <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a> in <var title="">value</var>.</p></li>
+ <li><p><a href="common-microsyntaxes.html#strip-leading-and-trailing-whitespace">Strip leading and trailing whitespace</a> from <var title="">value</var>.</p></li>
<li><p>Return <var title="">value</var>.</p></li>
@@ -812,7 +740,7 @@
<dd>
<p>Returns <a href="#the-body-element-0">the body element</a>.</p>
<p>Can be set, to replace <a href="#the-body-element-0">the body element</a>.</p>
- <p>If the new value is not a <code><a href="sections.html#the-body-element">body</a></code> or <code><a href="obsolete.html#frameset">frameset</a></code> element, this will throw a <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
+ <p>If the new value is not a <code><a href="sections.html#the-body-element">body</a></code> or <code><a href="obsolete.html#frameset">frameset</a></code> element, this will throw a <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
</dd>
</dl><p><dfn id="the-body-element-0">The body element</dfn> of a document is the first child of
@@ -831,7 +759,7 @@
<ol><li>If the new value is not a <code><a href="sections.html#the-body-element">body</a></code> or
<code><a href="obsolete.html#frameset">frameset</a></code> element, then raise a
- <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception and abort these
steps.</li>
<li>Otherwise, if the new value is the same as <a href="#the-body-element-0">the body
@@ -849,40 +777,40 @@
</ol></div><hr/><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-images"><a href="#dom-document-images">images</a></code></dt>
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code>.</p>
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code>.</p>
</dd>
<dt><var title="">document</var> . <code title="dom-document-embeds"><a href="#dom-document-embeds">embeds</a></code></dt>
<dt><var title="">document</var> . <code title="dom-document-plugins"><a href="#dom-document-plugins">plugins</a></code></dt>
<dd>
- <p>Return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code>.</p>
+ <p>Return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code>.</p>
</dd>
<dt><var title="">document</var> . <code title="dom-document-links"><a href="#dom-document-links">links</a></code></dt>
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="text-level-semantics.html#the-a-element">a</a></code> and <code><a href="the-map-element.html#the-area-element">area</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code> that have <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code> attributes.</p>
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="text-level-semantics.html#the-a-element">a</a></code> and <code><a href="the-map-element.html#the-area-element">area</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code> that have <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code> attributes.</p>
</dd>
<dt><var title="">document</var> . <code title="dom-document-forms"><a href="#dom-document-forms">forms</a></code></dt>
<dd>
- <p>Return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="forms.html#the-form-element">form</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code>.</p>
+ <p>Return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="forms.html#the-form-element">form</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code>.</p>
</dd>
<dt><var title="">document</var> . <code title="dom-document-scripts"><a href="#dom-document-scripts">scripts</a></code></dt>
<dd>
- <p>Return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="scripting-1.html#the-script-element">script</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code>.</p>
+ <p>Return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="scripting-1.html#the-script-element">script</a></code> elements in the <code><a href="infrastructure.html#document">Document</a></code>.</p>
</dd>
</dl><div class="impl">
<p>The <dfn id="dom-document-images" title="dom-document-images"><code>images</code></dfn>
- attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only
<code><a href="embedded-content-1.html#the-img-element">img</a></code> elements.</p>
<p>The <dfn id="dom-document-embeds" title="dom-document-embeds"><code>embeds</code></dfn>
- attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only
<code><a href="the-iframe-element.html#the-embed-element">embed</a></code> elements.</p>
@@ -890,18 +818,18 @@
attribute must return the same object as that returned by the <code title="dom-document-embeds"><a href="#dom-document-embeds">embeds</a></code> attribute.</p>
<p>The <dfn id="dom-document-links" title="dom-document-links"><code>links</code></dfn>
- attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only <code><a href="text-level-semantics.html#the-a-element">a</a></code>
elements with <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code>
attributes and <code><a href="the-map-element.html#the-area-element">area</a></code> elements with <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code> attributes.</p>
<p>The <dfn id="dom-document-forms" title="dom-document-forms"><code>forms</code></dfn>
- attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only
<code><a href="forms.html#the-form-element">form</a></code> elements.</p>
<p>The <dfn id="dom-document-scripts" title="dom-document-scripts"><code>scripts</code></dfn>
- attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only
<code><a href="scripting-1.html#the-script-element">script</a></code> elements.</p>
@@ -912,16 +840,6 @@
attribute with the value <var title="">name</var>.</p>
</dd>
- <dt><var title="">collection</var> = <var title="">document</var> . <code title="dom-document-getElementsByClassName"><a href="#dom-document-getelementsbyclassname">getElementsByClassName(<var title="">classes</var>)</a></code></dt>
- <dt><var title="">collection</var> = <var title="">element</var> . <code title="dom-getElementsByClassName"><a href="#dom-getelementsbyclassname">getElementsByClassName(<var title="">classes</var>)</a></code></dt>
- <dd>
- <p>Returns a <code><a href="infrastructure.html#nodelist">NodeList</a></code> of the elements in the object
- on which the method was invoked (a <code><a href="infrastructure.html#document">Document</a></code> or an
- <code><a href="infrastructure.html#element">Element</a></code>) that have all the classes given by <var title="">classes</var>.</p>
- <p>The <var title="">classes</var> argument is interpreted as a
- space-separated list of classes.</p>
- </dd>
-
</dl><div class="impl">
<p>The <dfn id="dom-document-getelementsbyname" title="dom-document-getElementsByName"><code>getElementsByName(<var title="">name</var>)</code></dfn> method takes a string <var title="">name</var>, and must return a <a href="infrastructure.html#live">live</a>
@@ -934,60 +852,6 @@
object returned by the earlier call. In other cases, a new
<code><a href="infrastructure.html#nodelist">NodeList</a></code> object must be returned.</p>
- <p>The <dfn id="dom-document-getelementsbyclassname" title="dom-document-getElementsByClassName"><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method takes a string that
- contains a <a href="common-microsyntaxes.html#set-of-space-separated-tokens">set of space-separated tokens</a> representing
- classes. When called, the method must return a <a href="infrastructure.html#live">live</a>
- <code><a href="infrastructure.html#nodelist">NodeList</a></code> object containing all the elements in the
- document, in <a href="infrastructure.html#tree-order">tree order</a>, that have all the classes
- specified in that argument, having obtained the classes by <a href="common-microsyntaxes.html#split-a-string-on-spaces" title="split a string on spaces">splitting a string on
- spaces</a>. (Duplicates are ignored.) If there are no tokens
- specified in the argument, then the method must return an empty
- <code><a href="infrastructure.html#nodelist">NodeList</a></code>. If the document is in <a href="#quirks-mode">quirks
- mode</a>, then the comparisons for the classes must be done in an
- <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> manner, otherwise, the
- comparisons must be done in a <a href="infrastructure.html#case-sensitive">case-sensitive</a> manner.
- When the method is invoked on a <code><a href="infrastructure.html#document">Document</a></code> object again
- with the same argument, the user agent may return the same object as
- the object returned by the earlier call. In other cases, a new
- <code><a href="infrastructure.html#nodelist">NodeList</a></code> object must be returned.</p>
-
- <p>The <dfn id="dom-getelementsbyclassname" title="dom-getElementsByClassName"><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method on the
- <code><a href="elements.html#htmlelement">HTMLElement</a></code> interface must return a <a href="infrastructure.html#live">live</a>
- <code><a href="infrastructure.html#nodelist">NodeList</a></code> with the nodes that the
- <code><a href="#htmldocument">HTMLDocument</a></code> <code title="dom-document-getElementsByClassName"><a href="#dom-document-getelementsbyclassname">getElementsByClassName()</a></code>
- method would return when passed the same argument(s), excluding any
- elements that are not descendants of the <code><a href="elements.html#htmlelement">HTMLElement</a></code>
- object on which the method was invoked.
- When the method is invoked on an <code><a href="elements.html#htmlelement">HTMLElement</a></code> object
- again with the same argument, the user agent may return the same
- object as the object returned by the earlier call. In other cases, a
- new <code><a href="infrastructure.html#nodelist">NodeList</a></code> object must be returned.</p>
-
- </div><p>HTML, SVG, and MathML elements define which classes they are in
- by having an attribute with no namespace with the name <code title="">class</code> containing a space-separated list of classes
- to which the element belongs. Other specifications may also allow
- elements in their namespaces to be labeled as being in specific
- classes.</p><div class="example">
-
- <p>Given the following XHTML fragment:</p>
-
- <pre><div id="example">
- <p id="p1" class="aaa bbb"/>
- <p id="p2" class="aaa ccc"/>
- <p id="p3" class="bbb ccc"/>
-</div></pre>
-
- <p>A call to <code title="">document.getElementById('example').getElementsByClassName('aaa')</code>
- would return a <code><a href="infrastructure.html#nodelist">NodeList</a></code> with the two paragraphs <code title="">p1</code> and <code title="">p2</code> in it.</p>
-
- <p>A call to <code title="">getElementsByClassName('ccc bbb')</code> would only
- return one node, however, namely <code title="">p3</code>. A call
- to <code title="">document.getElementById('example').getElementsByClassName('bbb  ccc ')</code>
- would return the same thing.</p>
-
- <p>A call to <code title="">getElementsByClassName('aaa,bbb')</code> would return no
- nodes; none of the elements above are in the "aaa,bbb" class.</p>
-
</div><div class="impl">
<hr/><p>The <code><a href="#htmldocument">HTMLDocument</a></code> interface <span title="support named properties">supports named properties</span>. The
@@ -1009,10 +873,10 @@
<code><a href="embedded-content-1.html#the-img-element">img</a></code>
elements in the <code><a href="infrastructure.html#document">Document</a></code> that have both <code title="attr-name">name</code> content attributes and <code title="attr-id"><a href="elements.html#the-id-attribute">id</a></code> content attributes.</p>
- <p>When <dfn id="dom-document-nameditem" title="dom-document-namedItem">the
+ <p>To <a href="infrastructure.html#determine-the-value-of-a-named-property">determine the value of a named property</a> <var title="">name</var> when <dfn id="dom-document-nameditem" title="dom-document-namedItem">the
<code>HTMLDocument</code> object is indexed for property
- retrieval</dfn> using a name <var title="">name</var>, then the user
- agent must return the value obtained using the following steps:</p>
+ retrieval</dfn>, the user agent must return the value obtained using
+ the following steps:</p>
<ol><li>
@@ -1043,7 +907,7 @@
<li>
- <p>Otherwise return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ <p>Otherwise return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only <a href="#dom-document-nameditem-filter" title="dom-document-namedItem-filter">named elements</a> with
the name <var title="">name</var>.</p>
</li>
@@ -1072,64 +936,17 @@
</div><hr/><p class="note">The <code title="dom-document-dir"><a href="elements.html#dom-document-dir">dir</a></code>
attribute on the <code><a href="#htmldocument">HTMLDocument</a></code> interface is defined
along with the <code title="attr-dir"><a href="elements.html#the-dir-attribute">dir</a></code> content
- attribute.</p><h4 id="creating-documents"><span class="secno">3.1.5 </span>Creating documents</h4><p><a href="#xml-documents">XML documents</a> can be created from script using the
- <code title="dom-DOMImplementation-createDocument"><a href="infrastructure.html#dom-domimplementation-createdocument">createDocument()</a></code>
- method on the <code><a href="infrastructure.html#domimplementation">DOMImplementation</a></code> interface.</p><p><a href="#html-documents">HTML documents</a> can be created using the <code title="dom-DOMHTMLImplementation-createHTMLDocument"><a href="#dom-domhtmlimplementation-createhtmldocument">createHTMLDocument()</a></code>
- method:</p><pre class="idl">[Supplemental, NoInterfaceObject]
-interface <dfn id="domhtmlimplementation">DOMHTMLImplementation</dfn> {
- <a href="infrastructure.html#document">Document</a> <a href="#dom-domhtmlimplementation-createhtmldocument" title="dom-DOMHTMLImplementation-createHTMLDocument">createHTMLDocument</a>(in DOMString title);
-};
-<a href="infrastructure.html#domimplementation">DOMImplementation</a> implements <a href="#domhtmlimplementation">DOMHTMLImplementation</a>;</pre><dl class="domintro"><dt><var title="">document</var> = <var title="">document</var> . <code title="dom-document-implementation">implementation</code> . <code title="dom-DOMHTMLImplementation-createHTMLDocument"><a href="#dom-domhtmlimplementation-createhtmldocument">createHTMLDocument</a></code>( <var title="">title</var> )</dt>
- <dd>
-
- <p>Returns a new <code><a href="infrastructure.html#document">Document</a></code>, with a basic DOM already
- constructed with an appropriate <code><a href="semantics.html#the-title-element">title</a></code> element.</p>
-
- </dd>
-
- </dl><div class="impl">
-
- <p>The <dfn id="dom-domhtmlimplementation-createhtmldocument" title="dom-DOMHTMLImplementation-createHTMLDocument"><code>createHTMLDocument(<var title="">title</var>)</code></dfn> method, when invoked, must run the
- following steps:</p>
-
- <ol><li><p>Let <var title="">doc</var> be a newly created
- <code><a href="infrastructure.html#document">Document</a></code> object.</p></li>
-
- <li><p>Mark <var title="">doc</var> as being an <a href="#html-documents" title="HTML documents">HTML document</a>.</p></li>
-
- <li><p>Create a <code><a href="infrastructure.html#documenttype">DocumentType</a></code> node with the <code title="">name</code> attribute set to the string "<code title="">html</code>", and the other attributes specific to
- <code><a href="infrastructure.html#documenttype">DocumentType</a></code> objects set to the empty string, null,
- and empty lists, as appropriate. Append the newly created node to
- <var title="">doc</var>.</p></li>
-
- <li><p>Create an <code><a href="semantics.html#the-html-element">html</a></code> element, and append it to <var title="">doc</var>.</p></li>
-
- <li><p>Create a <code><a href="semantics.html#the-head-element">head</a></code> element, and append it to the
- <code><a href="semantics.html#the-html-element">html</a></code> element created in the previous step.</p>
-
- </li><li><p>Create a <code><a href="semantics.html#the-title-element">title</a></code> element, and append it to the
- <code><a href="semantics.html#the-head-element">head</a></code> element created in the previous step.</p>
-
- </li><li><p>Create a <code><a href="infrastructure.html#text">Text</a></code> node, and set its <code title="">data</code> attribute to the string given by the method's
- argument (which could be the empty string). Append it to the
- <code><a href="semantics.html#the-title-element">title</a></code> element created in the previous step.</p>
-
- </li><li><p>Create a <code><a href="sections.html#the-body-element">body</a></code> element, and append it to the
- <code><a href="semantics.html#the-html-element">html</a></code> element created in the earlier step.</p>
-
- </li><li><p>Return <var title="">doc</var>.</p></li>
-
- </ol></div><div class="impl">
+ attribute.</p><div class="impl">
- <h4 id="loading-xml-documents"><span class="secno">3.1.6 </span>Loading XML documents</h4>
+ <h4 id="loading-xml-documents"><span class="secno">3.1.5 </span>Loading XML documents</h4>
- <p>A <code><a href="infrastructure.html#document">Document</a></code> object that is an <a href="#xml-documents" title="XML documents">XML document</a> that was created by the <code title="dom-DOMImplementation-createDocument"><a href="infrastructure.html#dom-domimplementation-createdocument">DOMImplementation.createDocument()</a></code>
+ <p>A <code><a href="infrastructure.html#document">Document</a></code> object that is an <a href="infrastructure.html#xml-documents" title="XML documents">XML document</a> that was created by the <code title="dom-DOMImplementation-createDocument"><a href="infrastructure.html#dom-domimplementation-createdocument">DOMImplementation.createDocument()</a></code>
factory method must also implement the
<code><a href="#xmldocumentloader">XMLDocumentLoader</a></code> interface:</p>
- <pre class="idl">[Supplemental, NoInterfaceObject]
+ <pre class="idl">[NoInterfaceObject]
interface <dfn id="xmldocumentloader">XMLDocumentLoader</dfn> {
- boolean <a href="#dom-xmldocumentloader-load" title="dom-XMLDocumentLoader-load">load</a>(in DOMString url);
+ boolean <a href="#dom-xmldocumentloader-load" title="dom-XMLDocumentLoader-load">load</a>(DOMString url);
};</pre>
@@ -1144,12 +961,12 @@
<li><p><a href="urls.html#resolve-a-url" title="resolve a url">Resolve</a> the method's
first argument, relative to the <a href="browsers.html#entry-script">entry script</a>'s <a href="webappapis.html#script-s-base-url" title="script's base URL">base URL</a>. If this is not
- successful, throw a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception and abort
+ successful, throw a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception and abort
these steps. Otherwise, let <var title="">url</var> be the
resulting <a href="urls.html#absolute-url">absolute URL</a>.</p></li>
<li><p>If the <a href="origin-0.html#origin">origin</a> of <var title="">url</var> is not
- the same as the <a href="origin-0.html#origin">origin</a> of <var title="">document</var>, throw a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code>
+ the same as the <a href="origin-0.html#origin">origin</a> of <var title="">document</var>, throw a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code>
exception and abort these steps.</p></li>
<li><p>Remove all child nodes of <var title="">document</var>,
without firing any mutation events.</p></li>
@@ -1158,7 +975,7 @@
<li><p> Run the remainder of these steps asynchronously,
and return true from the method.</p></li>
- <li><p>Let <var title="">result</var> be an <code><a href="infrastructure.html#document">Document</a></code>
+ <li><p>Let <var title="">result</var> be a <code><a href="infrastructure.html#document">Document</a></code>
object.</p></li>
<li><p>Let <var title="">success</var> be false.</p></li>
Index: embedded-content-1.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/embedded-content-1.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- embedded-content-1.html 17 Jun 2011 08:49:06 -0000 1.12
+++ embedded-content-1.html 24 Aug 2011 07:56:03 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -326,7 +329,7 @@
<ol class="toc"><li><ol><li><a href="embedded-content-1.html#embedded-content-1"><span class="secno">4.8 </span>Embedded content</a>
<ol><li><a href="embedded-content-1.html#the-img-element"><span class="secno">4.8.1 </span>The <code>img</code> element</a>
<ol><li><a href="embedded-content-1.html#alt"><span class="secno">4.8.1.1 </span>Requirements for providing text to act as an alternative for images</a>
- <ol><li><a href="embedded-content-1.html#general-guidelines"><span class="secno">4.8.1.1.1 </span>General guidelines</a></li><li><a href="embedded-content-1.html#a-link-or-button-containing-nothing-but-the-image"><span class="secno">4.8.1.1.2 </span>A link or button containing nothing but the image</a></li><li><a href="embedded-content-1.html#a-phrase-or-paragraph-with-an-alternative-graphical-representation:-charts-diagrams-graphs-maps-illustrations"><span class="secno">4.8.1.1.3 </span>A phrase or paragraph with an alternative graphical representation: charts, diagrams, graphs, maps, illustrations</a></li><li><a href="embedded-content-1.html#a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos"><span class="secno">4.8.1.1.4 </span>A short phrase or label with an alternative graphical representation: icons, logos</a></li><li><a href="embedded-content-1.html#text-that-has-been-rendered-to-a-graphic-for-typographical-effect"><span class="secno">4.8.1.1.5 </span>Text thathas been rendered to a graphic for typographical effect</a></li><li><a href="embedded-content-1.html#a-graphical-representation-of-some-of-the-surrounding-text"><span class="secno">4.8.1.1.6 </span>A graphical representation of some of the surrounding text</a></li><li><a href="embedded-content-1.html#a-purely-decorative-image-that-doesn-t-add-any-information"><span class="secno">4.8.1.1.7 </span>A purely decorative image that doesn't add any information</a></li><li><a href="embedded-content-1.html#a-group-of-images-that-form-a-single-larger-picture-with-no-links"><span class="secno">4.8.1.1.8 </span>A group of images that form a single larger picture with no links</a></li><li><a href="embedded-content-1.html#a-group-of-images-that-form-a-single-larger-picture-with-links"><span class="secno">4.8.1.1.9 </span>A group of images that form a single larger picture with links</a></li><li><a href="embedded-content-1.html#a-key-part-of-the-content"><span class="secno">4.8.1.1.10 </span>A key part of the content</a><li><li><a href="embedded-content-1.html#an-image-not-intended-for-the-user"><span class="secno">4.8.1.1.11 </span>An image not intended for the user</a></li><li><a href="embedded-content-1.html#guidance-for-markup-generators"><span class="secno">4.8.1.1.12 </span>Guidance for markup generators</a></li><li><a href="embedded-content-1.html#guidance-for-conformance-checkers"><span class="secno">4.8.1.1.13 </span>Guidance for conformance checkers</a></li></ol></li></ol></li></ol></li></ol></li></ol></div><h3 id="embedded-content-1"><span class="secno">4.8 </span>Embedded content</h3><h4 id="the-img-element"><span class="secno">4.8.1 </span>The <dfn><code>img</code></dfn> element</h4><p class="XXX annotation"><span><a href="http://www.w3.org/html/wg/tracker/issues/30">ISSUE-30</a> (longdesc) blocks progress to Last Call</span></p><dl class="element"><dt>Categories</dt>
+ <ol><li><a href="embedded-content-1.html#general-guidelines"><span class="secno">4.8.1.1.1 </span>General guidelines</a></li><li><a href="embedded-content-1.html#a-link-or-button-containing-nothing-but-the-image"><span class="secno">4.8.1.1.2 </span>A link or button containing nothing but the image</a></li><li><a href="embedded-content-1.html#a-phrase-or-paragraph-with-an-alternative-graphical-representation:-charts-diagrams-graphs-maps-illustrations"><span class="secno">4.8.1.1.3 </span>A phrase or paragraph with an alternative graphical representation: charts, diagrams, graphs, maps, illustrations</a></li><li><a href="embedded-content-1.html#a-short-phrase-or-label-with-an-alternative-graphical-representation:-icons-logos"><span class="secno">4.8.1.1.4 </span>A short phrase or label with an alternative graphical representation: icons, logos</a></li><li><a href="embedded-content-1.html#text-that-has-been-rendered-to-a-graphic-for-typographical-effect"><span class="secno">4.8.1.1.5 </span>Text thathas been rendered to a graphic for typographical effect</a></li><li><a href="embedded-content-1.html#a-graphical-representation-of-some-of-the-surrounding-text"><span class="secno">4.8.1.1.6 </span>A graphical representation of some of the surrounding text</a></li><li><a href="embedded-content-1.html#a-purely-decorative-image-that-doesn-t-add-any-information"><span class="secno">4.8.1.1.7 </span>A purely decorative image that doesn't add any information</a></li><li><a href="embedded-content-1.html#a-group-of-images-that-form-a-single-larger-picture-with-no-links"><span class="secno">4.8.1.1.8 </span>A group of images that form a single larger picture with no links</a></li><li><a href="embedded-content-1.html#a-group-of-images-that-form-a-single-larger-picture-with-links"><span class="secno">4.8.1.1.9 </span>A group of images that form a single larger picture with links</a></li><li><a href="embedded-content-1.html#a-key-part-of-the-content"><span class="secno">4.8.1.1.10 </span>A key part of the content</a><li><li><a href="embedded-content-1.html#an-image-not-intended-for-the-user"><span class="secno">4.8.1.1.11 </span>An image not intended for the user</a></li><li><a href="embedded-content-1.html#guidance-for-markup-generators"><span class="secno">4.8.1.1.12 </span>Guidance for markup generators</a></li><li><a href="embedded-content-1.html#guidance-for-conformance-checkers"><span class="secno">4.8.1.1.13 </span>Guidance for conformance checkers</a></li></ol></li></ol></li></ol></li></ol></li></ol></div><h3 id="embedded-content-1"><span class="secno">4.8 </span>Embedded content</h3><h4 id="the-img-element"><span class="secno">4.8.1 </span>The <dfn><code>img</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="content-models.html#flow-content">Flow content</a>.</dd>
<dd><a href="content-models.html#phrasing-content">Phrasing content</a>.</dd>
<dd><a href="content-models.html#embedded-content">Embedded content</a>.</dd>
@@ -347,8 +350,8 @@
<dt>DOM interface:</dt>
<dd>
<pre class="idl">[NamedConstructor=<a href="#dom-image" title="dom-image">Image</a>(),
- NamedConstructor=<a href="#dom-image-w" title="dom-image-w">Image</a>(in unsigned long width),
- NamedConstructor=<a href="#dom-image-wh" title="dom-image-wh">Image</a>(in unsigned long width, in unsigned long height)]
+ NamedConstructor=<a href="#dom-image-w" title="dom-image-w">Image</a>(unsigned long width),
+ NamedConstructor=<a href="#dom-image-wh" title="dom-image-wh">Image</a>(unsigned long width, unsigned long height)]
interface <dfn id="htmlimageelement">HTMLImageElement</dfn> : <a href="elements.html#htmlelement">HTMLElement</a> {
attribute DOMString <a href="#dom-img-alt" title="dom-img-alt">alt</a>;
attribute DOMString <a href="#dom-img-src" title="dom-img-src">src</a>;
@@ -381,7 +384,9 @@
In particular, <code><a href="#the-img-element">img</a></code> elements should not be used to
display transparent images, as they rarely convey meaning and rarely
add anything useful to the document.</p><p>The <dfn id="attr-img-crossorigin" title="attr-img-crossorigin"><code>crossorigin</code></dfn>
- attribute is a <a href="fetching-resources.html#cors-settings-attribute">CORS settings attribute</a>.</p><div class="impl">
+ attribute is a <a href="fetching-resources.html#cors-settings-attribute">CORS settings attribute</a>. Its purpose is
+ to allow images from third-party sites that allow cross-origin
+ access to be used with <code><a href="the-canvas-element.html#the-canvas-element">canvas</a></code>.</p><div class="impl">
<hr/><p>An <code><a href="#the-img-element">img</a></code> is always in one of the following states:</p>
@@ -404,6 +409,11 @@
<p>An <code><a href="#the-img-element">img</a></code> element is initially <a href="#img-none" title="img-none">unavailable</a>.</p>
+ <p>When an <code><a href="#the-img-element">img</a></code> element is <a href="#img-yes" title="img-yes">available</a>, it <a href="infrastructure.html#provides-a-paint-source">provides a paint
+ source</a> whose width is the image's intrinsic width, whose
+ height is the image's intrinsic height, and whose appearance is the
+ intrinsic appearance of the image.</p>
+
<p>User agents may obtain images immediately or on demand.</p>
<p>A user agent that obtains images immediately must synchronously
@@ -957,11 +967,12 @@
<pre><p>In the common case, the data handled by the tokenization stage
comes from the network, but it can also come from script.</p>
-<p><strong><img src="http://dev.w3.org/html5/spec/images/parsing-model-overview.png" alt="The network
-passes data to the Tokenizer stage, which passes data to the Tree
-Construction stage. From there, data goes to both the DOM and to
-Script Execution. Script Execution is linked to the DOM, and, using
-document.write(), passes data to the Tokenizer."></strong></p></pre>
+<p><strong><img src="http://dev.w3.org/html5/spec/images/parsing-model-overview.png" alt="The Network
+passes data to the Input Stream Preprocessor, which passes it to the
+Tokenizer, which passes it to the Tree Construction stage. From there,
+data goes to both the DOM and to Script Execution. Script Execution is
+linked to the DOM, and, using document.write(), passes data to the
+Tokenizer."></strong></p></pre>
</div><div class="example">
@@ -1129,11 +1140,11 @@
<p>A flowchart that repeats the previous paragraph in graphical form:</p>
- <pre><p>The network passes data to the Tokenizer stage, which
-passes data to the Tree Construction stage. From there, data goes
-to both the DOM and to Script Execution. Script Execution is
-linked to the DOM, and, using document.write(), passes data to
-the Tokenizer.</p>
+ <pre><p>The Network passes data to the Input Stream Preprocessor, which
+passes it to the Tokenizer, which passes it to the Tree Construction
+stage. From there, data goes to both the DOM and to Script Execution.
+Script Execution is linked to the DOM, and, using document.write(),
+passes data to the Tokenizer.</p>
<strong><p><img src="http://dev.w3.org/html5/spec/images/parsing-model-overview.png" alt=""></p></strong></pre>
<p>In these cases, it would be wrong to include alternative text
@@ -1145,36 +1156,37 @@
representation, and would thus require alternative text.</p>
<pre><!-- Using the title="" attribute -->
-<p>The network passes data to the Tokenizer stage, which
-passes data to the Tree Construction stage. From there, data goes
-to both the DOM and to Script Execution. Script Execution is
-linked to the DOM, and, using document.write(), passes data to
-the Tokenizer.</p>
+<p>The Network passes data to the Input Stream Preprocessor, which
+passes it to the Tokenizer, which passes it to the Tree Construction
+stage. From there, data goes to both the DOM and to Script Execution.
+Script Execution is linked to the DOM, and, using document.write(),
+passes data to the Tokenizer.</p>
<p><strong><img src="http://dev.w3.org/html5/spec/images/parsing-model-overview.png" alt=""
title="Flowchart representation of the parsing model."></strong></p></pre>
<pre><!-- Using <figure> and <figcaption> -->
-<p>The network passes data to the Tokenizer stage, which
-passes data to the Tree Construction stage. From there, data goes
-to both the DOM and to Script Execution. Script Execution is
-linked to the DOM, and, using document.write(), passes data to
-the Tokenizer.</p>
+<p>The Network passes data to the Input Stream Preprocessor, which
+passes it to the Tokenizer, which passes it to the Tree Construction
+stage. From there, data goes to both the DOM and to Script Execution.
+Script Execution is linked to the DOM, and, using document.write(),
+passes data to the Tokenizer.</p>
<figure>
- <strong><img src="http://dev.w3.org/html5/spec/images/parsing-model-overview.png" alt="The Network leads
- to the Tokenizer, which leads to the Tree Construction. The Tree
- Construction leads to two items. The first is Script Execution, which
- leads via document.write() back to the Tokenizer. The second item
- from which Tree Construction leads is the DOM. The DOM is related to
- the Script Execution."></strong>
+ <strong><img src="http://dev.w3.org/html5/spec/images/parsing-model-overview.png" alt="The Network leads to
+ the Input Stream Preprocessor, which leads to the Tokenizer, which
+ leads to the Tree Construction stage. The Tree Construction stage
+ leads to two items. The first is Script Execution, which leads via
+ document.write() back to the Tokenizer. The second item from which
+ Tree Construction leads is the DOM. The DOM is related to the Script
+ Execution."></strong>
<figcaption>Flowchart representation of the parsing model.</figcaption>
</figure></pre>
<pre class="bad"><!-- This is WRONG. Do not do this. Instead, do what the above examples do. -->
-<p>The network passes data to the Tokenizer stage, which
-passes data to the Tree Construction stage. From there, data goes
-to both the DOM and to Script Execution. Script Execution is
-linked to the DOM, and, using document.write(), passes data to
-the Tokenizer.</p>
+<p>The Network passes data to the Input Stream Preprocessor, which
+passes it to the Tokenizer, which passes it to the Tree Construction
+stage. From there, data goes to both the DOM and to Script Execution.
+Script Execution is linked to the DOM, and, using document.write(),
+passes data to the Tokenizer.</p>
<p><img src="http://dev.w3.org/html5/spec/images/parsing-model-overview.png"
alt="Flowchart representation of the parsing model."></p>
<!-- Never put the image's caption in the alt="" attribute! --></pre>
Index: the-input-element.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/the-input-element.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- the-input-element.html 17 Jun 2011 08:49:08 -0000 1.12
+++ the-input-element.html 24 Aug 2011 07:56:05 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -406,14 +409,14 @@
readonly attribute <a href="the-button-element.html#htmloptionelement">HTMLOptionElement</a>? <a href="common-input-element-attributes.html#dom-input-selectedoption" title="dom-input-selectedOption">selectedOption</a>;
attribute DOMString <a href="the-map-element.html#dom-dim-width" title="dom-dim-width">width</a>;
- void <a href="common-input-element-attributes.html#dom-input-stepup" title="dom-input-stepUp">stepUp</a>(in optional long n);
- void <a href="common-input-element-attributes.html#dom-input-stepdown" title="dom-input-stepDown">stepDown</a>(in optional long n);
+ void <a href="common-input-element-attributes.html#dom-input-stepup" title="dom-input-stepUp">stepUp</a>(optional long n);
+ void <a href="common-input-element-attributes.html#dom-input-stepdown" title="dom-input-stepDown">stepDown</a>(optional long n);
readonly attribute boolean <a href="association-of-controls-and-forms.html#dom-cva-willvalidate" title="dom-cva-willValidate">willValidate</a>;
readonly attribute <a href="association-of-controls-and-forms.html#validitystate">ValidityState</a> <a href="association-of-controls-and-forms.html#dom-cva-validity" title="dom-cva-validity">validity</a>;
readonly attribute DOMString <a href="association-of-controls-and-forms.html#dom-cva-validationmessage" title="dom-cva-validationMessage">validationMessage</a>;
boolean <a href="association-of-controls-and-forms.html#dom-cva-checkvalidatity" title="dom-cva-checkValidatity">checkValidity</a>();
- void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(in DOMString error);
+ void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(DOMString error);
readonly attribute <a href="infrastructure.html#nodelist">NodeList</a> <a href="forms.html#dom-lfe-labels" title="dom-lfe-labels">labels</a>;
@@ -421,7 +424,7 @@
attribute unsigned long <a href="association-of-controls-and-forms.html#dom-textarea-input-selectionstart" title="dom-textarea/input-selectionStart">selectionStart</a>;
attribute unsigned long <a href="association-of-controls-and-forms.html#dom-textarea-input-selectionend" title="dom-textarea/input-selectionEnd">selectionEnd</a>;
attribute DOMString <a href="association-of-controls-and-forms.html#dom-textarea-input-selectiondirection" title="dom-textarea/input-selectionDirection">selectionDirection</a>;
- void <a href="association-of-controls-and-forms.html#dom-textarea-input-setselectionrange" title="dom-textarea/input-setSelectionRange">setSelectionRange</a>(in unsigned long start, in unsigned long end, in optional DOMString direction);
+ void <a href="association-of-controls-and-forms.html#dom-textarea-input-setselectionrange" title="dom-textarea/input-setSelectionRange">setSelectionRange</a>(unsigned long start, unsigned long end, optional DOMString direction);
};</pre>
</dd>
</dl><p>The <code><a href="#the-input-element">input</a></code> element <a href="rendering.html#represents">represents</a> a typed data field,
@@ -1273,7 +1276,9 @@
<a href="#concept-input-value-dirty-flag" title="concept-input-value-dirty-flag">dirty value flag</a>
must be initially set to false when the element is created, and must
be set to true whenever the user interacts with the control in a way
- that changes the <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a>.</p>
+ that changes the <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a>. (It is
+ also set to true when the value is programmatically changed, as
+ described in the definition of the <code title="dom-input-value"><a href="common-input-element-attributes.html#dom-input-value">value</a></code> IDL attribute.)</p>
</div><p>The <dfn id="attr-input-value" title="attr-input-value"><code>value</code></dfn>
content attribute gives the default <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a> of the <code><a href="#the-input-element">input</a></code>
@@ -1334,9 +1339,10 @@
some cases (e.g. for the <a href="states-of-the-type-attribute.html#date-state" title="attr-input-type-date">Date</a> state, but not the <a href="number-state.html#checkbox-state" title="attr-input-type-checkbox">Checkbox</a> state) make an
<code><a href="#the-input-element">input</a></code> element <i title="concept-input-immutable"><a href="#concept-input-immutable">immutable</a></i>.</p>
- <p>When an <code><a href="#the-input-element">input</a></code> element is <a href="infrastructure.html#concept-clone" title="concept-clone">cloned</a>, the element's <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a>, <a href="#concept-input-value-dirty-flag" title="concept-input-value-dirty-flag">dirty value flag</a>,
+ <p>The <a href="infrastructure.html#concept-node-clone-ext" title="concept-node-clone-ext">cloning steps</a> for
+ <code><a href="#the-input-element">input</a></code> elements must propagate the <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a>, <a href="#concept-input-value-dirty-flag" title="concept-input-value-dirty-flag">dirty value flag</a>,
<a href="association-of-controls-and-forms.html#concept-fe-checked" title="concept-fe-checked">checkedness</a>, and <a href="#concept-input-checked-dirty-flag" title="concept-input-checked-dirty-flag">dirty checkedness
- flag</a> must be propagated to the clone when it is created.</p>
+ flag</a> from the node being cloned to the copy.</p>
<hr/><p>When an <code><a href="#the-input-element">input</a></code> element is first created, the
element's rendering and behavior must be set to the rendering and
Index: rendering.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/rendering.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- rendering.html 17 Jun 2011 08:49:07 -0000 1.15
+++ rendering.html 24 Aug 2011 07:56:04 -0000 1.16
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
[...1480 lines suppressed...]
+ <h4 id="text-rendered-in-native-user-interfaces"><span class="secno">10.7.4 </span>Text rendered in native user interfaces</h4>
<p>User agents are expected to honor the Unicode semantics of text
that is exposed in user interfaces, for example supporting the
@@ -3474,13 +3556,13 @@
- <h3 id="print-media"><span class="secno">10.7 </span>Print media</h3>
+ <h3 id="print-media"><span class="secno">10.8 </span>Print media</h3>
<p>User agents are expected to allow the user to request the
opportunity to <dfn id="obtain-a-physical-form">obtain a physical form</dfn> (or a
representation of a physical form) of a <code><a href="infrastructure.html#document">Document</a></code>. For
example, selecting the option to print a page or convert it to PDF
- format.</p>
+ format. <a href="references.html#refsPDF">[PDF]</a></p>
<p>When the user actually <a href="#obtain-a-physical-form" title="obtain a physical form">obtains a physical form</a> (or a representation of a
physical form) of a <code><a href="infrastructure.html#document">Document</a></code>, the user agent is
Index: grouping-content.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/grouping-content.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- grouping-content.html 17 Jun 2011 08:49:06 -0000 1.12
+++ grouping-content.html 24 Aug 2011 07:56:03 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -464,7 +467,7 @@
time for another rejuvenation. Despite his body having the physical
age of a standard fifty-year-old, the prospect of a long degrading
campaign within academia was one he regarded with dread. For a
-supposedly advanced civilization, the Intersolar Commonwearth could be
+supposedly advanced civilization, the Intersolar Commonwealth could be
appallingly backward at times, not to mention cruel.</p>
<p><i>Maybe it won't be that bad</i>, he told himself. The lie was
comforting enough to get him through the rest of the night's
@@ -772,7 +775,7 @@
decimal system regardless of the <code title="attr-ol-type"><a href="#attr-ol-type">type</a></code> attribute.</p>
<p class="note">For CSS user agents, a mapping for this attribute to
- the 'list-style-type' CSS property is given <a href="rendering.html#decohints">in
+ the 'list-style-type' CSS property is given <a href="#decohints">in
the rendering section</a> (the mapping is straightforward: the
states above have the same names as their corresponding CSS
values).</p>
@@ -975,26 +978,28 @@
<p>If a <code><a href="#the-dl-element">dl</a></code> element is empty, it contains no groups.</p>
- <p>If a <code><a href="#the-dl-element">dl</a></code> element contains non-<a href="content-models.html#inter-element-whitespace" title="inter-element whitespace">whitespace</a> <a href="infrastructure.html#text-node" title="text node">text nodes</a>, or elements other than <code><a href="#the-dt-element">dt</a></code> and
- <code><a href="#the-dd-element">dd</a></code>, then those elements or <a href="infrastructure.html#text-node" title="text node">text
- nodes</a> do not form part of any groups in that
+ <p>If a <code><a href="#the-dl-element">dl</a></code> element has one or more non-<a href="content-models.html#inter-element-whitespace" title="inter-element whitespace">whitespace</a> <a href="infrastructure.html#text-node">text
+ node</a> children, or has child elements that are neither
+ <code><a href="#the-dt-element">dt</a></code> nor <code><a href="#the-dd-element">dd</a></code> elements, all such <a href="infrastructure.html#text-node" title="text node">text nodes</a> and elements, as well as their
+ descendants (including any <code><a href="#the-dt-element">dt</a></code> or <code><a href="#the-dd-element">dd</a></code>
+ elements), do not form part of any groups in that
<code><a href="#the-dl-element">dl</a></code>.</p>
- <p>If a <code><a href="#the-dl-element">dl</a></code> element contains only <code><a href="#the-dt-element">dt</a></code>
- elements, then it consists of one group with names but no
- values.</p>
+ <p>If a <code><a href="#the-dl-element">dl</a></code> element has one or more <code><a href="#the-dt-element">dt</a></code>
+ element chlidren but no <code><a href="#the-dd-element">dd</a></code> element children, then it
+ consists of one group with names but no values.</p>
- <p>If a <code><a href="#the-dl-element">dl</a></code> element contains only <code><a href="#the-dd-element">dd</a></code>
- elements, then it consists of one group with values but no
- names.</p>
+ <p>If a <code><a href="#the-dl-element">dl</a></code> element has one or more <code><a href="#the-dd-element">dd</a></code>
+ element children but no <code><a href="#the-dt-element">dt</a></code> element children, then it
+ consists of one group with values but no names.</p>
- <p>If a <code><a href="#the-dl-element">dl</a></code> element starts with one or more
- <code><a href="#the-dd-element">dd</a></code> elements, then the first group has no associated
- name.</p>
+ <p>If a <code><a href="#the-dl-element">dl</a></code> element's first <code><a href="#the-dt-element">dt</a></code> or
+ <code><a href="#the-dd-element">dd</a></code> element child is a <code><a href="#the-dd-element">dd</a></code> element, then the
+ first group has no associated name.</p>
- <p>If a <code><a href="#the-dl-element">dl</a></code> element ends with one or more
- <code><a href="#the-dt-element">dt</a></code> elements, then the last group has no associated
- value.</p>
+ <p>If a <code><a href="#the-dl-element">dl</a></code> element's last <code><a href="#the-dt-element">dt</a></code> or
+ <code><a href="#the-dd-element">dd</a></code> element child is a <code><a href="#the-dt-element">dt</a></code> element, then the
+ last group has no associated value.</p>
<p class="note">When a <code><a href="#the-dl-element">dl</a></code> element doesn't match its
content model, it is often due to accidentally using <code><a href="#the-dd-element">dd</a></code>
@@ -1276,9 +1281,9 @@
<a href="rendering.html#represents">represents</a> its children. It can be used with the <code title="attr-class"><a href="elements.html#classes">class</a></code>, <code title="attr-lang"><a href="elements.html#attr-lang">lang</a></code>, and <code title="attr-title"><a href="elements.html#the-title-attribute">title</a></code> attributes to mark up semantics
common to a group of consecutive elements.</p><p class="note">Authors are strongly encouraged to view the
<code><a href="#the-div-element">div</a></code> element as an element of last resort, for when no
- other element is suitable. Use of the <code><a href="#the-div-element">div</a></code> element
- instead of more appropriate elements leads to poor accessibility for
- readers and poor maintainability for authors.</p><div class="example">
+ other element is suitable. Use of more appropriate elements instead
+ of the <code><a href="#the-div-element">div</a></code> element leads to better accessibility for
+ readers and easier maintainability for authors.</p><div class="example">
<p>For example, a blog post would be marked up using
<code><a href="sections.html#the-article-element">article</a></code>, a chapter using <code><a href="sections.html#the-section-element">section</a></code>, a
Index: timers.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/timers.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- timers.html 17 Jun 2011 08:49:08 -0000 1.12
+++ timers.html 24 Aug 2011 07:56:05 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -328,12 +331,14 @@
<ol><li><a href="timers.html#the-navigator-object"><span class="secno">6.5.1 </span>The <code>Navigator</code> object</a>
<ol><li><a href="timers.html#client-identification"><span class="secno">6.5.1.1 </span>Client identification</a></li><li><a href="timers.html#custom-handlers"><span class="secno">6.5.1.2 </span>Custom scheme and content handlers</a></li><li><a href="timers.html#security-and-privacy"><span class="secno">6.5.1.3 </span>Security and privacy</a></li><li><a href="timers.html#sample-handler-impl"><span class="secno">6.5.1.4 </span>Sample user interface</a></li><li><a href="timers.html#manually-releasing-the-storage-mutex"><span class="secno">6.5.1.5 </span>Manually releasing the storage mutex</a></li></ol></li><li><a href="timers.html#the-external-interface"><span class="secno">6.5.2 </span>The <code>External</code> interface</a></li></ol></li></ol></li></ol></div><h3 id="timers"><span class="secno">6.3 </span>Timers</h3><p>The <code title="dom-windowtimers-setTimeout"><a href="#dom-windowtimers-settimeout">setTimeout()</a></code>
and <code title="dom-windowtimers-setInterval"><a href="#dom-windowtimers-setinterval">setInterval()</a></code>
- methods allow authors to schedule timer-based callbacks.</p><pre class="idl">[Supplemental, NoInterfaceObject]
+ methods allow authors to schedule timer-based callbacks.</p><pre class="idl">[NoInterfaceObject]
interface <dfn id="windowtimers">WindowTimers</dfn> {
- long <a href="#dom-windowtimers-settimeout" title="dom-windowtimers-setTimeout">setTimeout</a>(in any handler, in optional any timeout, in any... args);
- void <a href="#dom-windowtimers-cleartimeout" title="dom-windowtimers-clearTimeout">clearTimeout</a>(in long handle);
- long <a href="#dom-windowtimers-setinterval" title="dom-windowtimers-setInterval">setInterval</a>(in any handler, in optional any timeout, in any... args);
- void <a href="#dom-windowtimers-clearinterval" title="dom-windowtimers-clearInterval">clearInterval</a>(in long handle);
+ long <a href="#dom-windowtimers-settimeout" title="dom-windowtimers-setTimeout">setTimeout</a>(Function handler, optional float timeout, any... args);
+ long <a href="#dom-windowtimers-settimeout" title="dom-windowtimers-setTimeout">setTimeout</a>([AllowAny] DOMString handler, optional float timeout, any... args);
+ void <a href="#dom-windowtimers-cleartimeout" title="dom-windowtimers-clearTimeout">clearTimeout</a>(long handle);
+ long <a href="#dom-windowtimers-setinterval" title="dom-windowtimers-setInterval">setInterval</a>(Function handler, optional float timeout, any... args);
+ long <a href="#dom-windowtimers-setinterval" title="dom-windowtimers-setInterval">setInterval</a>([AllowAny] DOMString handler, optional float timeout, any... args);
+ void <a href="#dom-windowtimers-clearinterval" title="dom-windowtimers-clearInterval">clearInterval</a>(long handle);
};
<a href="browsers.html#window">Window</a> implements <a href="#windowtimers">WindowTimers</a>;</pre><dl class="domintro"><dt><var title="">handle</var> = <var title="">window</var> . <code title="dom-windowtimers-setTimeout"><a href="#dom-windowtimers-settimeout">setTimeout</a></code>( <var title="">handler</var> [, <var title="">timeout</var> [, <var title="">arguments</var>... ] ] )</dt>
@@ -393,7 +398,11 @@
<p class="note">The <code><a href="#windowtimers">WindowTimers</a></code> interface adds to the
<code><a href="browsers.html#window">Window</a></code> interface and the <code>WorkerUtils</code>
- interface (part of Web Workers).</p>
+ interface (part of Web Workers).
+
+ <a href="references.html#refsWEBWORKERS">[WEBWORKERS]</a>
+
+ </p>
<p>Each object that implements the <code><a href="#windowtimers">WindowTimers</a></code>
interface has a <dfn id="list-of-active-timeouts">list of active timeouts</dfn> and a <dfn id="list-of-active-intervals">list
@@ -443,9 +452,33 @@
</li>
- <li><p>Wait until any invocations of this algorithm started before
- this one whose <var title="">timeout</var> is equal to or less than
- this one's have completed.</p></li>
+ <li>
+
+ <p>Wait until any invocations of this algorithm started before
+ this one whose <var title="">timeout</var> is equal to or less
+ than this one's have completed.</p>
+
+ <p class="note">Argument conversion as defined by WebIDL (for
+ example, invoking <code title="">toString()</code> methods on
+ objects passed as the first argument) happens in the algorithms
+ defined in WebIDL, before this algorithm is invoked.</p>
+
+ <div class="example">
+
+ <p>So for example, the following rather silly code will result in
+ the log containing "<code title="">ONE TWO </code>":</p>
+
+ <pre>var log = '';
+function logger(s) { log += s + ' '; }
+
+setTimeout({ toString: function () {
+ setTimeout("logger('ONE')", 100);
+ return "logger('TWO')";
+} }, 100);</pre>
+
+ </div>
+
+ </li>
<li>
@@ -489,8 +522,8 @@
<li><p><a href="#get-the-timeout">Get the timeout</a>, and let <var title="">timeout</var> be the result.</p></li>
- <li><p>If <var title="">timeout</var> is less than 10, then
- increase <var title="">timeout</var> to 10.</p></li>
+ <li><p>If <var title="">timeout</var> is less than 4, then
+ increase <var title="">timeout</var> to 4.</p></li>
<li><p>Return <var title="">handle</var>, and then continue running
this algorithm asynchronously.</p></li>
@@ -553,11 +586,12 @@
<ol><li>
- <p>If the first argument to the invoked method is an object that
- has an internal [[Call]] method, then return a <a href="webappapis.html#concept-task" title="concept-task">task</a> that checks if the entry for <var title="">handle</var> in <var title="">list</var> has been
- cleared, and if it has not, calls the aforementioned [[Call]]
- method with as its arguments the third and subsequent arguments to
- the invoked method (if any), and with an undefined <var title="">thisArg</var>, and abort these steps. <a href="references.html#refsECMA262">[ECMA262]</a></p>
+ <p>If the first argument to the invoked method is a
+ <code><a href="webappapis.html#function">Function</a></code>, then return a <a href="webappapis.html#concept-task" title="concept-task">task</a> that checks if the entry for <var title="">handle</var> in <var title="">list</var> has been
+ cleared, and if it has not, calls the <code><a href="webappapis.html#function">Function</a></code> with
+ as its arguments the third and subsequent arguments to the invoked
+ method (if any) and with an undefined <var title="">thisArg</var>,
+ and abort these steps. <a href="references.html#refsECMA262">[ECMA262]</a></p>
<p class="note">Setting <var title="">thisArg</var> to undefined
means that the function code will be executed with the <code title="">this</code> keyword bound to the <code><a href="browsers.html#windowproxy">WindowProxy</a></code>
@@ -568,9 +602,8 @@
</li>
- <li><p>Apply the ToString() abstract operation to the first
- argument to the method, and let <var title="">script source</var>
- be the result. <a href="references.html#refsECMA262">[ECMA262]</a></p></li>
+ <li><p>Let <var title="">script source</var> be the first argument
+ to the method.</p></li>
<li><p>Let <var title="">script language</var> be
JavaScript.</p></li>
@@ -582,7 +615,7 @@
context</a>, let <var title="">browsing context</var> be the
<a href="browsers.html#browsing-context">browsing context</a> with which <var title="">global
object</var> is associated, let <var title="">character
- encoding</var> be the <a href="dom.html#document-s-character-encoding" title="document's character encoding">character encoding</a> of the <code><a href="infrastructure.html#document">Document</a></code>
+ encoding</var> be the <a href="infrastructure.html#document-s-character-encoding" title="document's character encoding">character encoding</a> of the <code><a href="infrastructure.html#document">Document</a></code>
associated with <var title="">global object</var> (<a href="webappapis.html#sce-not-copy">this is a reference, not a copy</a>), and let
<var title="">base URL</var> be the <a href="urls.html#document-base-url" title="document base URL">base URL</a> of the <code><a href="infrastructure.html#document">Document</a></code> associated with
<var title="">global object</var> (<a href="webappapis.html#sbu-not-copy">this is
@@ -615,12 +648,6 @@
<ol><li><p>Let <var title="">timeout</var> be the second argument to
the method, or zero if the argument was omitted.</p></li>
- <li><p>Apply the ToString() abstract operation to <var title="">timeout</var>, and let <var title="">timeout</var>
- be the result. <a href="references.html#refsECMA262">[ECMA262]</a></p></li>
-
- <li><p>Apply the ToNumber() abstract operation to <var title="">timeout</var>, and let <var title="">timeout</var> be the
- result. <a href="references.html#refsECMA262">[ECMA262]</a></p></li>
-
<li><p>If <var title="">timeout</var> is an Infinity value, a
Not-a-Number (NaN) value, or negative, let <var title="">timeout</var> be zero.</p></li>
@@ -708,8 +735,12 @@
</dl><div class="impl">
- <p>The <dfn id="dom-print" title="dom-print"><code>print()</code></dfn> method,
- when invoked, must run the <a href="#printing-steps">printing steps</a>.</p>
+ <p>When the <dfn id="dom-print" title="dom-print"><code>print()</code></dfn> method
+ is invoked, if the <code><a href="infrastructure.html#document">Document</a></code> is <a href="the-end.html#ready-for-post-load-tasks">ready for
+ post-load tasks</a>, then the user agent must synchronously run
+ the <a href="#printing-steps">printing steps</a>. Otherwise, the user agent must only
+ set the <dfn id="print-when-loaded">print when loaded</dfn> flag on the
+ <code><a href="infrastructure.html#document">Document</a></code>.</p>
<p>User agents should also run the <a href="#printing-steps">printing steps</a>
whenever the user asks for the opportunity to <a href="rendering.html#obtain-a-physical-form">obtain a
@@ -738,7 +769,7 @@
<p>The user agent must <a href="webappapis.html#fire-a-simple-event">fire a simple event</a> named
<code title="event-beforeprint">beforeprint</code> at the
<code><a href="browsers.html#window">Window</a></code> object of the <code><a href="infrastructure.html#document">Document</a></code> that is
- being printed, as well as any <a href="browsers.html#nested-browsing-context" title="nested browsing context">nested browsing contexts</a> in it.</p>
+ being printed, as well as any <a href="browsers.html#nested-browsing-context" title="nested browsing context">nested browsing contexts</a> in it.</p>
<p class="example">The <code title="event-beforeprint">beforeprint</code> event can be used
to annotate the printed copy, for instance adding the time at
@@ -804,7 +835,7 @@
<p><a href="urls.html#resolve-a-url" title="resolve a url">Resolve</a> <var title="">url</var> relative to the <a href="browsers.html#entry-script">entry script</a>'s
<a href="webappapis.html#script-s-base-url" title="script's base URL">base URL</a>.</p>
- <p>If this fails, then throw a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception
+ <p>If this fails, then throw a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception
and abort these steps.</p>
</li>
@@ -1019,7 +1050,7 @@
interface.</p>
- </div><h5 id="client-identification"><span class="secno">6.5.1.1 </span>Client identification</h5><pre class="idl">[Supplemental, NoInterfaceObject]
+ </div><h5 id="client-identification"><span class="secno">6.5.1.1 </span>Client identification</h5><pre class="idl">[NoInterfaceObject]
interface <dfn id="navigatorid">NavigatorID</dfn> { readonly attribute DOMString <a href="#dom-navigator-appname" title="dom-navigator-appName">appName</a>;
readonly attribute DOMString <a href="#dom-navigator-appversion" title="dom-navigator-appVersion">appVersion</a>;
readonly attribute DOMString <a href="#dom-navigator-platform" title="dom-navigator-platform">platform</a>;
@@ -1086,11 +1117,11 @@
identified. For this reason, user agent implementors are strongly
urged to include as little information in this API as possible.</p>
- </div><h5 id="custom-handlers"><span class="secno">6.5.1.2 </span>Custom scheme and content handlers</h5><pre class="idl">[Supplemental, NoInterfaceObject]
+ </div><h5 id="custom-handlers"><span class="secno">6.5.1.2 </span>Custom scheme and content handlers</h5><pre class="idl">[NoInterfaceObject]
interface <dfn id="navigatorcontentutils">NavigatorContentUtils</dfn> {
// content handler registration
- void <a href="#dom-navigator-registerprotocolhandler" title="dom-navigator-registerProtocolHandler">registerProtocolHandler</a>(in DOMString scheme, in DOMString url, in DOMString title);
- void <a href="#dom-navigator-registercontenthandler" title="dom-navigator-registerContentHandler">registerContentHandler</a>(in DOMString mimeType, in DOMString url, in DOMString title);
+ void <a href="#dom-navigator-registerprotocolhandler" title="dom-navigator-registerProtocolHandler">registerProtocolHandler</a>(DOMString scheme, DOMString url, DOMString title);
+ void <a href="#dom-navigator-registercontenthandler" title="dom-navigator-registerContentHandler">registerContentHandler</a>(DOMString mimeType, DOMString url, DOMString title);
};</pre><p>The <dfn id="dom-navigator-registerprotocolhandler" title="dom-navigator-registerProtocolHandler"><code>registerProtocolHandler()</code></dfn>
method allows Web sites to register themselves as possible handlers
for particular schemes. For example, an online telephone messaging
@@ -1116,11 +1147,11 @@
placeholder for where to put the URL of the content to be
handled.</p>
- <p>Throws a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception if the user agent
+ <p>Throws a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception if the user agent
blocks the registration (this might happen if trying to register
as a handler for "http", for instance).</p>
- <p>Throws a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> if the "<code title="">%s</code>" string is missing in the URL.</p>
+ <p>Throws a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> if the "<code title="">%s</code>" string is missing in the URL.</p>
</dd>
@@ -1246,13 +1277,13 @@
</dd>
- </dl><p>User agents should raise <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exceptions if
+ </dl><p>User agents should raise <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exceptions if
the methods are called with <var title="">scheme</var> or <var title="">mimeType</var> values that the UA deems to be
"privileged". For example, a site attempting to register a handler
for <code>http</code> URLs or <code><a href="iana.html#text-html">text/html</a></code> content in a
Web browser would likely cause an exception to be raised.</p>
- <p>User agents must raise a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception if the
+ <p>User agents must raise a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception if the
<var title="">url</var> argument passed to one of these methods does
not contain the exact literal string "<code>%s</code>", or if <a href="urls.html#resolve-a-url" title="resolve a url">resolving</a> the <var title="">url</var>
argument with the first occurrence of the string "<code title="">%s</code>" removed, relative to the <a href="browsers.html#entry-script">entry
@@ -1400,7 +1431,7 @@
method would work equivalently, but for schemes instead of unknown
content types.</p>
- </div><h5 id="manually-releasing-the-storage-mutex"><span class="secno">6.5.1.5 </span>Manually releasing the storage mutex</h5><pre class="idl">[Supplemental, NoInterfaceObject]
+ </div><h5 id="manually-releasing-the-storage-mutex"><span class="secno">6.5.1.5 </span>Manually releasing the storage mutex</h5><pre class="idl">[NoInterfaceObject]
interface <dfn id="navigatorstorageutils">NavigatorStorageUtils</dfn> {
void <a href="#dom-navigator-yieldforstorageupdates" title="dom-navigator-yieldForStorageUpdates">yieldForStorageUpdates</a>();
};</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-navigator"><a href="#dom-navigator">navigator</a></code> . <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">yieldForStorageUpdates</a></code>()</dt>
@@ -1446,8 +1477,8 @@
must be returned each time.</p>
</div><pre class="idl">interface <dfn id="external">External</dfn> {
- void <a href="#dom-external-addsearchprovider" title="dom-external-AddSearchProvider">AddSearchProvider</a>(in DOMString engineURL);
- unsigned long <a href="#dom-external-issearchproviderinstalled" title="dom-external-IsSearchProviderInstalled">IsSearchProviderInstalled</a>(in DOMString engineURL);
+ void <a href="#dom-external-addsearchprovider" title="dom-external-AddSearchProvider">AddSearchProvider</a>(DOMString engineURL);
+ unsigned long <a href="#dom-external-issearchproviderinstalled" title="dom-external-IsSearchProviderInstalled">IsSearchProviderInstalled</a>(DOMString engineURL);
};</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-external"><a href="#dom-external">external</a></code> . <code title="dom-external-AddSearchProvider"><a href="#dom-external-addsearchprovider">AddSearchProvider</a></code>( <var title="">url</var> )</dt>
<dd>
Index: elements.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/elements.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- elements.html 17 Jun 2011 08:49:06 -0000 1.13
+++ elements.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -331,11 +334,49 @@
(by this specification) to have certain meanings (semantics). For
example, the <code><a href="grouping-content.html#the-ol-element">ol</a></code> element represents an ordered list, and
the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute represents the
- language of the content.</p><p>Authors must not use elements, attributes, or attribute values
- for purposes other than their appropriate intended semantic
- purpose. Authors must not use elements, attributes, or attribute
- values that are not permitted by this specification or <a href="infrastructure.html#other-applicable-specifications">other
- applicable specifications</a>.</p><div class="example">
+ language of the content.</p><p>These definitions allow HTML processors, such as Web browsers or
+ search engines, to present and use documents and applications in a
+ wide variety of contexts that the author might not have
+ considered.</p><div class="example">
+
+ <p>As a simple example, consider a Web page written by an author
+ who only considered desktop computer Web browsers. Because HTML
+ conveys <em>meaning</em>, rather than presentation, the same page
+ can also be used by a small browser on a mobile phone, without any
+ change to the page. Instead of headings being in large letters as
+ on the desktop, for example, the browser on the mobile phone might
+ use the same size text for the whole the page, but with the
+ headings in bold.</p>
+
+ <p>But it goes further than just differences in screen size: the
+ same page could equally be used by a blind user using a browser
+ based around speech synthesis, which instead of displaying the page
+ on a screen, reads the page to the user, e.g. using headphones.
+ Instead of large text for the headings, the speech browser might
+ use a different volume or a slower voice.</p>
+
+ <p>That's not all, either. Since the browsers know which parts of
+ the page are the headings, they can create a document outline that
+ the user can use to quickly navigate around the document, using
+ keys for "jump to next heading" or "jump to previous heading". Such
+ features are especially common with speech browsers, where users
+ would otherwise find quickly navigating a page quite difficult.</p>
+
+ <p>Even beyond browsers, software can make use of this information.
+ Search engines can use the headings to more effectively index a
+ page, or to provide quick links to subsections of the page from
+ their results. Tools can use the headings to create a table of
+ contents (that is in fact how this very specification's table of
+ contents is generated).</p>
+
+ <p>This example has focused on headings, but the same principle
+ applies to all of the semantics in HTML.</p>
+
+ </div><p>Authors must not use elements, attributes, or attribute values
+ for purposes other than their appropriate intended semantic purpose,
+ as doing so prevents software from correctly processing the
+ page.</p><div class="example">
+
<p>For example, the following document is non-conforming, despite
being syntactically correct:</p>
@@ -356,8 +397,15 @@
</html></pre>
<p>...because the data placed in the cells is clearly not tabular
- data (and the <code><a href="text-level-semantics.html#the-cite-element">cite</a></code> element mis-used). A corrected
- version of this document might be:</p>
+ data (and the <code><a href="text-level-semantics.html#the-cite-element">cite</a></code> element mis-used). This would make
+ software that relies on these semantics fail: for example, a speech
+ browser that allowed a blind user to navigate tables in the
+ document would report the quote above as a table, confusing the
+ user; similarly, a tool that extracted titles of works from pages
+ would extract "Ernest" as the title of a work, even though it's
+ actually a person's name, not a title.</p>
+
+ <p>A corrected version of this document might be:</p>
<pre><!DOCTYPE HTML>
<html lang="en-GB">
@@ -373,6 +421,8 @@
</body>
</html></pre>
+ </div><div class="example">
+
<p>This next document fragment, intended to represent the heading
of a corporate site, is similarly non-conforming because the second
line is not intended to be a heading of a subsection, but merely a
@@ -394,6 +444,11 @@
</hgroup>
...</pre>
+ </div><p>Authors must not use elements, attributes, or attribute values
+ that are not permitted by this specification or <a href="infrastructure.html#other-applicable-specifications">other
+ applicable specifications</a>, as doing so makes it significantly
+ harder for the language to be extended in the future.</p><div class="example">
+
<p>In the next example, there is a non-conforming attribute value
("carpet") and a non-conforming attribute ("texture"), which
is not permitted by this specification:</p>
@@ -417,7 +472,7 @@
progress changing.</p><h4 id="elements-in-the-dom"><span class="secno">3.2.2 </span>Elements in the DOM</h4><p>The nodes representing <a href="infrastructure.html#html-elements">HTML elements</a> in the DOM
<span class="impl">must</span> implement, and expose to scripts, the
interfaces listed for them in the relevant sections of this
- specification. This includes <a href="infrastructure.html#html-elements">HTML elements</a> in <a href="dom.html#xml-documents">XML
+ specification. This includes <a href="infrastructure.html#html-elements">HTML elements</a> in <a href="infrastructure.html#xml-documents">XML
documents</a>, even when those documents are in another context
(e.g. inside an XSLT transform).</p><p>Elements in the DOM <a href="rendering.html#represents" title="represents">represent</a>
things; that is, they have intrinsic <em>meaning</em>, also known as
@@ -426,13 +481,10 @@
elements</a>' interfaces inherit, <span class="impl">and which
must be used by elements that have no additional
requirements,</span> is the <code><a href="#htmlelement">HTMLElement</a></code> interface.</p><pre class="idl">interface <dfn id="htmlelement">HTMLElement</dfn> : <a href="infrastructure.html#element">Element</a> {
- // <a href="dom.html#dom-tree-accessors">DOM tree accessors</a>
- NodeList <a href="dom.html#dom-getelementsbyclassname" title="dom-getElementsByClassName">getElementsByClassName</a>(in DOMString classNames);
-
- // <a href="apis-in-html-documents.html#dynamic-markup-insertion">dynamic markup insertion</a>
- attribute DOMString <a href="apis-in-html-documents.html#dom-innerhtml" title="dom-innerHTML">innerHTML</a>;
- attribute DOMString <a href="apis-in-html-documents.html#dom-outerhtml" title="dom-outerHTML">outerHTML</a>;
- void <a href="apis-in-html-documents.html#dom-insertadjacenthtml" title="dom-insertAdjacentHTML">insertAdjacentHTML</a>(in DOMString position, in DOMString text);
+ // <a href="content-models.html#dynamic-markup-insertion">dynamic markup insertion</a>
+ attribute DOMString <a href="content-models.html#dom-innerhtml" title="dom-innerHTML">innerHTML</a>;
+ attribute DOMString <a href="content-models.html#dom-outerhtml" title="dom-outerHTML">outerHTML</a>;
+ void <a href="content-models.html#dom-insertadjacenthtml" title="dom-insertAdjacentHTML">insertAdjacentHTML</a>(DOMString position, DOMString text);
// <span>metadata attributes</span>
attribute DOMString <a href="#dom-id" title="dom-id">id</a>;
@@ -440,7 +492,7 @@
attribute DOMString <a href="#dom-lang" title="dom-lang">lang</a>;
attribute DOMString <a href="#dom-dir" title="dom-dir">dir</a>;
attribute <span>DOMString</span> <a href="#dom-classname" title="dom-className">className</a>;
- readonly attribute <a href="common-dom-interfaces.html#domtokenlist">DOMTokenList</a> <a href="#dom-classlist" title="dom-classList">classList</a>;
+ readonly attribute <a href="infrastructure.html#domtokenlist">DOMTokenList</a> <a href="#dom-classlist" title="dom-classList">classList</a>;
readonly attribute <a href="common-dom-interfaces.html#domstringmap">DOMStringMap</a> <a href="#dom-dataset" title="dom-dataset">dataset</a>;
// <a href="editing.html#editing">user interaction</a>
@@ -452,7 +504,7 @@
attribute DOMString <a href="editing.html#dom-accesskey" title="dom-accessKey">accessKey</a>;
readonly attribute DOMString <a href="editing.html#dom-accesskeylabel" title="dom-accessKeyLabel">accessKeyLabel</a>;
attribute boolean <a href="dnd.html#dom-draggable" title="dom-draggable">draggable</a>;
- [PutForwards=<a href="common-dom-interfaces.html#dom-domsettabletokenlist-value" title="dom-DOMSettableTokenList-value">value</a>] readonly attribute <a href="common-dom-interfaces.html#domsettabletokenlist">DOMSettableTokenList</a> <a href="dnd.html#dom-dropzone" title="dom-dropzone">dropzone</a>;
+ [PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <a href="infrastructure.html#domsettabletokenlist">DOMSettableTokenList</a> <a href="dnd.html#dom-dropzone" title="dom-dropzone">dropzone</a>;
attribute DOMString <a href="editing.html#dom-contenteditable" title="dom-contentEditable">contentEditable</a>;
readonly attribute boolean <a href="editing.html#dom-iscontenteditable" title="dom-isContentEditable">isContentEditable</a>;
attribute <a href="interactive-elements.html#htmlmenuelement">HTMLMenuElement</a>? <a href="interactive-elements.html#dom-contextmenu" title="dom-contextMenu">contextMenu</a>;
@@ -460,10 +512,11 @@
// <a href="commands.html#command-api">command API</a>
readonly attribute DOMString? <a href="commands.html#dom-command-ro-commandtype" title="dom-command-ro-commandType">commandType</a>;
- readonly attribute DOMString? <a href="commands.html#dom-command-ro-label" title="dom-command-ro-label">label</a>;
- readonly attribute DOMString? <a href="commands.html#dom-command-ro-icon" title="dom-command-ro-icon">icon</a>;
- readonly attribute boolean <a href="commands.html#dom-command-ro-disabled" title="dom-command-ro-disabled">disabled</a>;
- readonly attribute boolean <a href="commands.html#dom-command-ro-checked" title="dom-command-ro-checked">checked</a>;
+ readonly attribute DOMString? <a href="commands.html#dom-command-ro-commandlabel" title="dom-command-ro-commandLabel">commandLabel</a>;
+ readonly attribute DOMString? <a href="commands.html#dom-command-ro-commandicon" title="dom-command-ro-commandIcon">commandIcon</a>;
+ readonly attribute boolean? <a href="commands.html#dom-command-ro-commandhidden" title="dom-command-ro-commandHidden">commandHidden</a>;
+ readonly attribute boolean? <a href="commands.html#dom-command-ro-commanddisabled" title="dom-command-ro-commandDisabled">commandDisabled</a>;
+ readonly attribute boolean? <a href="commands.html#dom-command-ro-commandchecked" title="dom-command-ro-commandChecked">commandChecked</a>;
// <span>styling</span>
readonly attribute <span>CSSStyleDeclaration</span> <a href="#dom-style" title="dom-style">style</a>;
@@ -612,11 +665,11 @@
are not useful on all elements. For example, only <a href="the-iframe-element.html#media-element" title="media element">media elements</a> will ever receive a <code title="event-media-volumechange"><a href="the-iframe-element.html#event-media-volumechange">volumechange</a></code> event fired by
the user agent.</p><hr/><p><a href="#custom-data-attribute" title="custom data attribute">Custom data attributes</a>
(e.g. <code title="">data-foldername</code> or <code title="">data-msgid</code>) can be specified on any <a href="infrastructure.html#html-elements" title="HTML elements">HTML element</a>, to store custom data
- specific to the page.</p><hr/><p>In <a href="dom.html#html-documents">HTML documents</a>, elements in the <a href="namespaces.html#html-namespace-0">HTML
+ specific to the page.</p><hr/><p>In <a href="infrastructure.html#html-documents">HTML documents</a>, elements in the <a href="namespaces.html#html-namespace-0">HTML
namespace</a> may have an <code title="">xmlns</code> attribute
specified, if, and only if, it has the exact value
"<code>http://www.w3.org/1999/xhtml</code>". This does not apply to
- <a href="dom.html#xml-documents">XML documents</a>.</p><p class="note">In HTML, the <code title="">xmlns</code> attribute
+ <a href="infrastructure.html#xml-documents">XML documents</a>.</p><p class="note">In HTML, the <code title="">xmlns</code> attribute
has absolutely no effect. It is basically a talisman. It is allowed
merely to make migration to and from XHTML mildly easier. When
parsed by an <a href="parsing.html#html-parser">HTML parser</a>, the attribute ends up in no
@@ -625,7 +678,7 @@
part of the namespace declaration mechanism, and an element cannot
actually have an <code title="">xmlns</code> attribute in no
namespace specified.</p><hr/><p>The XML specification also allows the use of the <code title="attr-xml-space">xml:space</code> attribute in the <a href="namespaces.html#xml-namespace">XML
- namespace</a> on any element in an <a href="dom.html#xml-documents" title="XML documents">XML document</a>. This attribute has no effect on
+ namespace</a> on any element in an <a href="infrastructure.html#xml-documents" title="XML documents">XML document</a>. This attribute has no effect on
<a href="infrastructure.html#html-elements">HTML elements</a>, as the default behavior in HTML is to
preserve whitespace. <a href="references.html#refsXML">[XML]</a></p><p class="note">There is no way to serialize the <code title="attr-xml-space">xml:space</code> attribute on <a href="infrastructure.html#html-elements">HTML
elements</a> in the <code><a href="iana.html#text-html">text/html</a></code> syntax.</p><hr/><p>To enable assistive technology products to expose a more
@@ -709,7 +762,7 @@
may be used on any <a href="infrastructure.html#html-elements" title="HTML elements">HTML
element</a>.</p><p>The <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code>
attribute in the <span>XML namespace</span></a> may be used on
- <a href="infrastructure.html#html-elements">HTML elements</a> in <a href="dom.html#xml-documents">XML documents</a>, as well as
+ <a href="infrastructure.html#html-elements">HTML elements</a> in <a href="infrastructure.html#xml-documents">XML documents</a>, as well as
elements in other namespaces if the relevant specifications allow it
(in particular, MathML and SVG allow <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attributes in the
<span>XML namespace</span></a> to be specified on their
@@ -718,11 +771,11 @@
namespace</span></a> are specified on the same element, they must
have exactly the same value when compared in an <a href="infrastructure.html#ascii-case-insensitive">ASCII
case-insensitive</a> manner.</p><p>Authors must not use the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML
- namespace</span></a> on <a href="infrastructure.html#html-elements">HTML elements</a> in <a href="dom.html#html-documents">HTML
+ namespace</span></a> on <a href="infrastructure.html#html-elements">HTML elements</a> in <a href="infrastructure.html#html-documents">HTML
documents</a>. To ease migration to and from XHTML, authors may
specify an attribute in no namespace with no prefix and with the
literal localname "<code title="">xml:lang</code>" on <a href="infrastructure.html#html-elements">HTML
- elements</a> in <a href="dom.html#html-documents">HTML documents</a>, but such attributes
+ elements</a> in <a href="infrastructure.html#html-documents">HTML documents</a>, but such attributes
must only be specified if a <code title="attr-lang"><a href="#attr-lang">lang</a></code>
attribute in no namespace is also specified, and both attributes
must have the same value when compared in an <a href="infrastructure.html#ascii-case-insensitive">ASCII
@@ -786,9 +839,9 @@
</div><h5 id="the-xml:base-attribute-xml-only"><span class="secno">3.2.3.4 </span>The <dfn title="attr-xml-base"><code>xml:base</code></dfn>
attribute (XML only)</h5><p>The <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attribute is
defined in XML Base. <a href="references.html#refsXMLBASE">[XMLBASE]</a></p><p>The <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attribute may be
- used on elements of <a href="dom.html#xml-documents">XML documents</a>. Authors must not
+ used on elements of <a href="infrastructure.html#xml-documents">XML documents</a>. Authors must not
use the <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attribute in
- <a href="dom.html#html-documents">HTML documents</a>.</p><h5 id="the-dir-attribute"><span class="secno">3.2.3.5 </span>The <dfn title="attr-dir"><code>dir</code></dfn> attribute</h5><p>The <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute specifies the
+ <a href="infrastructure.html#html-documents">HTML documents</a>.</p><h5 id="the-dir-attribute"><span class="secno">3.2.3.5 </span>The <dfn title="attr-dir"><code>dir</code></dfn> attribute</h5><p>The <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute specifies the
element's text directionality. The attribute is an <a href="common-microsyntaxes.html#enumerated-attribute">enumerated
attribute</a> with the following keywords and states:</p><dl><dt>The <dfn id="attr-dir-ltr" title="attr-dir-ltr"><code>ltr</code></dfn> keyword, which maps to the <dfn id="attr-dir-ltr-state" title="attr-dir-ltr-state">ltr</dfn> state</dt>
@@ -843,6 +896,23 @@
<dd><p><a href="#the-directionality">The directionality</a> of the element is '<a href="#concept-rtl" title="concept-rtl">rtl</a>'.</p></dd>
+ <dt>If the element is an <code><a href="the-input-element.html#the-input-element">input</a></code> element whose <code title="attr-input-type"><a href="the-input-element.html#attr-input-type">type</a></code> attribute is in the <a href="states-of-the-type-attribute.html#text-state-and-search-state" title="attr-input-type-text">Text</a>, <a href="states-of-the-type-attribute.html#text-state-and-search-state" title="attr-input-type-search">Search</a>, <a href="states-of-the-type-attribute.html#telephone-state" title="attr-input-type-tel">Telephone</a>, <a href="states-of-the-type-attribute.html#url-state" title="attr-input-type-url">URL</a>, or <a href="states-of-the-type-attribute.html#e-mail-state" title="attr-input-type-email">E-mail</a> state, and the <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute is in the <a href="#attr-dir-auto-state" title="attr-dir-auto-state">auto</a> state</dt>
+
+ <dt>If the element is a <code><a href="the-button-element.html#the-textarea-element">textarea</a></code> element and the <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute is in the <a href="#attr-dir-auto-state" title="attr-dir-auto-state">auto</a> state</dt>
+
+ <dd>
+
+ <p>If the element's <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a>
+ contains a character of bidirectional character type AL or R, and
+ there is no character of bidirectional character type L anywhere
+ before it in the element's <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a>, then <a href="#the-directionality">the
+ directionality</a> of the element is '<a href="#concept-rtl" title="concept-rtl">rtl</a>'. Otherwise, <a href="#the-directionality">the
+ directionality</a> of the element is '<a href="#concept-ltr" title="concept-ltr">ltr</a>'.</p>
+
+ </dd>
+
+
+
<dt>If the element's <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute is
in the <a href="#attr-dir-auto-state" title="attr-dir-auto-state">auto</a> state</dt>
@@ -870,6 +940,7 @@
<ul class="brief"><li>A <code><a href="text-level-semantics.html#the-bdi-element">bdi</a></code> element.
</li><li>A <code><a href="scripting-1.html#the-script-element">script</a></code> element.
</li><li>A <code><a href="semantics.html#the-style-element">style</a></code> element.
+ </li><li>A <code><a href="the-button-element.html#the-textarea-element">textarea</a></code> element.
</li><li>An element with a <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute in a defined state.
</li></ul></li>
@@ -961,7 +1032,7 @@
spaces</a>. (Duplicates are ignored.)</p>
</div><p class="note">Assigning classes to an element affects class
- matching in selectors in CSS, the <code title="dom-document-getElementsByClassName"><a href="dom.html#dom-document-getelementsbyclassname">getElementsByClassName()</a></code>
+ matching in selectors in CSS, the <code title="dom-document-getElementsByClassName">getElementsByClassName()</code>
method in the DOM, and other such features.</p><p>There are no additional restrictions on the tokens authors can
use in the <code title="attr-class"><a href="#classes">class</a></code> attribute, but
authors are encouraged to use values that describe the nature of the
@@ -1016,7 +1087,7 @@
character after the hyphen, is <a href="infrastructure.html#xml-compatible">XML-compatible</a>, and
contains no characters in the range U+0041 to U+005A (LATIN CAPITAL
LETTER A to LATIN CAPITAL LETTER Z).</p><p class="note">All attributes on <a href="infrastructure.html#html-elements">HTML elements</a> in
- <a href="dom.html#html-documents">HTML documents</a> get ASCII-lowercased automatically, so
+ <a href="infrastructure.html#html-documents">HTML documents</a> get ASCII-lowercased automatically, so
the restriction on ASCII uppercase letters doesn't affect such
documents.</p><p><a href="#custom-data-attribute" title="custom data attribute">Custom data attributes</a>
are intended to store custom data private to the page or
@@ -1100,7 +1171,7 @@
<li>If <var title="">name</var> contains a U+002D HYPHEN-MINUS
character (-) followed by a character in the range U+0061 to
U+007A (U+0061 LATIN SMALL LETTER A to U+007A LATIN SMALL LETTER
- Z), throw a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception and abort these
+ Z), throw a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception and abort these
steps.</li>
<li>For each character in the range U+0041 to U+005A (U+0041
Index: urls.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/urls.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- urls.html 17 Jun 2011 08:49:08 -0000 1.13
+++ urls.html 24 Aug 2011 07:56:05 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -342,8 +345,9 @@
<li><p>The <a href="#url">URL</a> is a valid IRI reference and its query
component contains no unescaped non-ASCII characters. <a href="references.html#refsRFC3987">[RFC3987]</a></p></li>
- <li><p>The <a href="#url">URL</a> is a valid IRI reference and the <a href="dom.html#document-s-character-encoding" title="document's character encoding">character encoding</a> of
- the URL's <code><a href="infrastructure.html#document">Document</a></code> is UTF-8 or UTF-16. <a href="references.html#refsRFC3987">[RFC3987]</a></p></li>
+ <li><p>The <a href="#url">URL</a> is a valid IRI reference and the <a href="infrastructure.html#document-s-character-encoding" title="document's character encoding">character encoding</a> of
+ the URL's <code><a href="infrastructure.html#document">Document</a></code> is UTF-8 or <a href="infrastructure.html#a-utf-16-encoding">a UTF-16
+ encoding</a>. <a href="references.html#refsRFC3987">[RFC3987]</a></p></li>
</ul><p>A string is a <dfn id="valid-non-empty-url">valid non-empty URL</dfn> if it is a
<a href="#valid-url">valid URL</a> but it is not the empty string.</p><p>A string is a <dfn id="valid-url-potentially-surrounded-by-spaces">valid URL potentially surrounded by
@@ -352,7 +356,7 @@
spaces</dfn> if, after <a href="common-microsyntaxes.html#strip-leading-and-trailing-whitespace" title="strip leading and trailing whitespace">stripping leading and trailing whitespace</a> from
it, it is a <a href="#valid-non-empty-url">valid non-empty URL</a>.</p><p>This specification defines the URL
<dfn id="about:legacy-compat"><code>about:legacy-compat</code></dfn> as a reserved, though
- unresolvable, <code title="">about:</code> URI, for use in <a href="syntax.html#syntax-doctype" title="syntax-doctype">DOCTYPE</a>s in <a href="dom.html#html-documents">HTML
+ unresolvable, <code title="">about:</code> URI, for use in <a href="syntax.html#syntax-doctype" title="syntax-doctype">DOCTYPE</a>s in <a href="infrastructure.html#html-documents">HTML
documents</a> when needed for compatibility with XML tools. <a href="references.html#refsABOUT">[ABOUT]</a></p><p>This specification defines the URL
<dfn id="about:srcdoc"><code>about:srcdoc</code></dfn> as a reserved, though
unresolvable, <code title="">about:</code> URI, that is used as
@@ -363,7 +367,7 @@
<p>To <dfn id="parse-a-url">parse a URL</dfn> <var title="">url</var> into its
component parts, the user agent must use the following steps:</p>
- <ol><li><p>Strip leading and trailing <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a> from <var title="">url</var>.</p></li>
+ <ol><li><p><a href="common-microsyntaxes.html#strip-leading-and-trailing-whitespace">Strip leading and trailing whitespace</a> from <var title="">url</var>.</p></li>
<li>
@@ -507,12 +511,12 @@
<dt>If the URL came from a DOM node (e.g. from an element)</dt>
<dd>The node has a <code><a href="infrastructure.html#document">Document</a></code>, and the URL character
- encoding is the <a href="dom.html#document-s-character-encoding">document's character encoding</a>.</dd>
+ encoding is the <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a>.</dd>
</dl></li>
- <li><p>If <var title="">encoding</var> is a UTF-16 encoding, then
- change the value of <var title="">encoding</var> to UTF-8.</p></li>
+ <li><p>If <var title="">encoding</var> is <a href="infrastructure.html#a-utf-16-encoding">a UTF-16
+ encoding</a>, then change the value of <var title="">encoding</var> to UTF-8.</p></li>
<li>
@@ -534,7 +538,7 @@
even in HTML fragments, as such attributes can be added
dynamically using script. (Such scripts would not be conforming,
however, as <code title="attr-xml-base"><a href="elements.html#the-xml:base-attribute-xml-only">xml:base</a></code> attributes
- are not allowed in <a href="dom.html#html-documents">HTML documents</a>.)</p>
+ are not allowed in <a href="infrastructure.html#html-documents">HTML documents</a>.)</p>
<p>The <dfn id="document-base-url">document base URL</dfn> of a <code><a href="infrastructure.html#document">Document</a></code>
object is the <a href="#absolute-url">absolute URL</a> obtained by running these
@@ -754,19 +758,15 @@
<p>When an <code title="attr-xml-base"><a href="elements.html#the-xml:base-attribute-xml-only">xml:base</a></code> attribute
changes, the attribute's element, and all descendant elements, are
- <a href="#affected-by-a-base-url-change">affected by a base URL change</a>.</p>
+ <span>affected by a base URL change</span>.</p>
<p>When a document's <a href="#document-base-url">document base URL</a> changes, all
- elements in that document are <a href="#affected-by-a-base-url-change">affected by a base URL
- change</a>.</p>
-
- <p>When an element is moved from one document to another, if the two
- documents have different <a href="#document-base-url" title="document base URL">base
- URLs</a>, then that element and all its descendants are
- <a href="#affected-by-a-base-url-change">affected by a base URL change</a>.</p>
+ elements in that document are <span>affected by a base URL
+ change</span>.</p>
- <p>When an element is <dfn id="affected-by-a-base-url-change">affected by a base URL change</dfn>, it
- must act as described in the following list:</p>
+ <p>The following are <span>base URL change steps</span>, which run
+ when an element is <span>affected by a base URL change</span> (as
+ defined by the DOM Core specification):</p>
<dl class="switch"><dt>If the element creates a <a href="links.html#hyperlink">hyperlink</a></dt>
Index: tokenization.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/tokenization.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- tokenization.html 17 Jun 2011 08:49:08 -0000 1.13
+++ tokenization.html 24 Aug 2011 07:56:05 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -364,7 +367,7 @@
can affect the state of the tokenization stage, and can insert
additional characters into the stream. (For example, the
<code><a href="scripting-1.html#the-script-element">script</a></code> element can result in scripts executing and
- using the <a href="apis-in-html-documents.html#dynamic-markup-insertion">dynamic markup insertion</a> APIs to insert
+ using the <a href="content-models.html#dynamic-markup-insertion">dynamic markup insertion</a> APIs to insert
characters into the stream being tokenized.)</p>
<p>When a start tag token is emitted with its <i>self-closing
Index: association-of-controls-and-forms.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/association-of-controls-and-forms.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- association-of-controls-and-forms.html 17 Jun 2011 08:49:05 -0000 1.15
+++ association-of-controls-and-forms.html 24 Aug 2011 07:56:03 -0000 1.16
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -432,7 +435,7 @@
outer form "a".</p>
<p>This happens as follows: First, the "e" node gets associated
- with "c" in the <a href="parsing.html#html-parser">HTML parser</a>. Then, the <code title="dom-innerHTML"><a href="apis-in-html-documents.html#dom-innerhtml">innerHTML</a></code> algorithm moves the nodes
+ with "c" in the <a href="parsing.html#html-parser">HTML parser</a>. Then, the <code title="dom-innerHTML"><a href="content-models.html#dom-innerhtml">innerHTML</a></code> algorithm moves the nodes
from the temporary document to the "b" element. At this point, the
nodes see their ancestor chain change, and thus all the "magic"
associations done by the parser are reset to normal ancestor
@@ -735,7 +738,7 @@
attribute unsigned long <a href="#dom-textarea-input-selectionstart" title="dom-textarea/input-selectionStart">selectionStart</a>;
attribute unsigned long <a href="#dom-textarea-input-selectionend" title="dom-textarea/input-selectionEnd">selectionEnd</a>;
attribute DOMString <a href="#dom-textarea-input-selectiondirection" title="dom-textarea/input-selectionDirection">selectionDirection</a>;
- void <a href="#dom-textarea-input-setselectionrange" title="dom-textarea/input-setSelectionRange">setSelectionRange</a>(in unsigned long start, in unsigned long end, in optional DOMString direction);</pre><p>These methods and attributes expose and control the selection of
+ void <a href="#dom-textarea-input-setselectionrange" title="dom-textarea/input-setSelectionRange">setSelectionRange</a>(unsigned long start, unsigned long end, optional DOMString direction);</pre><p>These methods and attributes expose and control the selection of
<code><a href="the-input-element.html#the-input-element">input</a></code> and <code><a href="the-button-element.html#the-textarea-element">textarea</a></code> text fields.</p><dl class="domintro"><dt><var title="">element</var> . <code title="dom-textarea/input-select"><a href="#dom-textarea-input-select">select</a></code>()</dt>
<dd>
@@ -788,7 +791,7 @@
<p>When these methods and attributes are used with
<code><a href="the-input-element.html#the-input-element">input</a></code> elements while they don't apply, they must raise
- an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception. Otherwise, they must
+ an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception. Otherwise, they must
act as described below.</p>
<p>For <code><a href="the-input-element.html#the-input-element">input</a></code> elements, these methods and attributes
@@ -873,7 +876,7 @@
<p>On setting, it must act as if the <code title="dom-textarea/input-setSelectionRange"><a href="#dom-textarea-input-setselectionrange">setSelectionRange()</a></code>
method had been called, with the current value of the <code title="dom-textarea/input-selectionStart"><a href="#dom-textarea-input-selectionstart">selectionStart</a></code>
attribute as the first argument, the current value of the <code title="dom-textarea/input-selectionEnd"><a href="#dom-textarea-input-selectionend">selectionEnd</a></code>
- attribute as the first argument, and the new value as the third
+ attribute as the second argument, and the new value as the third
argument.</p>
@@ -1376,8 +1379,8 @@
<h5 id="form-submission-algorithm"><span class="secno">4.10.22.3 </span>Form submission algorithm</h5>
<p>When a <code><a href="forms.html#the-form-element">form</a></code> element <var title="">form</var> is <dfn id="concept-form-submit" title="concept-form-submit">submitted</dfn> from an element <var title="">submitter</var> (typically a button), optionally with a
- <var title="">scripted-submit</var> flag set, the user agent must
- run the following steps:</p>
+ <var title="">submitted from <code title="dom-form-submit"><a href="forms.html#dom-form-submit">submit()</a></code> method</var> flag set, the
+ user agent must run the following steps:</p>
<ol><li><p>Let <var title="">form document</var> be the <var title="">form</var>'s <code><a href="infrastructure.html#document">Document</a></code>.</p></li>
@@ -1399,15 +1402,15 @@
- <li><p>If the <var title="">scripted-submit</var> flag is not set,
- and the <var title="">submitter</var> element's <a href="#concept-fs-novalidate" title="concept-fs-novalidate">no-validate state</a> is false,
+ <li><p>If the <var title="">submitted from <code title="dom-form-submit"><a href="forms.html#dom-form-submit">submit()</a></code> method</var> flag is not
+ set, and the <var title="">submitter</var> element's <a href="#concept-fs-novalidate" title="concept-fs-novalidate">no-validate state</a> is false,
then <a href="#interactively-validate-the-constraints">interactively validate the constraints</a> of <var title="">form</var> and examine the result: if the result is
negative (the constraint validation concluded that there were
invalid fields and probably informed the user of this) then abort
these steps.</p></li>
- <li><p>If the <var title="">scripted-submit</var> flag is not set,
- then <a href="webappapis.html#fire-a-simple-event">fire a simple event</a> that is cancelable named
+ <li><p>If the <var title="">submitted from <code title="dom-form-submit"><a href="forms.html#dom-form-submit">submit()</a></code> method</var> flag is not
+ set, then <a href="webappapis.html#fire-a-simple-event">fire a simple event</a> that is cancelable named
<code title="event-submit">submit</code>, at <var title="">form</var>. If the event's default action is prevented
(i.e. if the event is canceled) then abort these steps. Otherwise,
continue (effectively the default action is to perform the
@@ -1417,7 +1420,7 @@
<li><p>Let <var title="">form data set</var> be the result of
- <a href="#constructing-the-form-data-set">constructing the form data set</a> for <var title="">form</var>.</p></li>
+ <a href="#constructing-the-form-data-set">constructing the form data set</a> for <var title="">form</var> in the context of <var title="">submitter</var>.</p></li>
<li><p>Let <var title="">action</var> be the <var title="">submitter</var> element's <a href="#concept-fs-action" title="concept-fs-action">action</a>.</p></li>
@@ -1675,7 +1678,8 @@
</ol><h5 id="constructing-form-data-set"><span class="secno">4.10.22.4 </span>Constructing the form data set</h5>
- <p>The algorithm to <dfn id="constructing-the-form-data-set" title="constructing the form data set">construct the form data set</dfn> for a form <var title="">form</var> is as follows:</p>
+ <p>The algorithm to <dfn id="constructing-the-form-data-set" title="constructing the form data set">construct the form data set</dfn> for a form <var title="">form</var> optionally in the context of a submitter <var title="">submitter</var> is as follows. If not specified otherwise,
+ <var title="">submitter</var> is null.</p>
<ol><li><p>Let <var title="">controls</var> be a list of all the <a href="forms.html#category-submit" title="category-submit">submittable elements</a> whose
<a href="#form-owner">form owner</a> is <var title="">form</var>, in <a href="infrastructure.html#tree-order">tree
@@ -1848,7 +1852,7 @@
<li><p><i>End</i>: Return the <var title="">form data
step</var>.</p></li>
- </ol><h5 id="url-encoded-form-data"><span class="secno">4.10.22.5 </span>URL-encoded form data</h5>
+ </ol></div><h5 id="url-encoded-form-data"><span class="secno">4.10.22.5 </span>URL-encoded form data</h5><div class="impl">
<p>The <dfn id="application-x-www-form-urlencoded-encoding-algorithm"><code title="">application/x-www-form-urlencoded</code> encoding
algorithm</dfn> is as follows:</p>
@@ -1865,7 +1869,7 @@
none of the encodings are supported, or if none are listed, then
let the selected character encoding be UTF-8.</p>
- <p>Otherwise, if the <a href="dom.html#document-s-character-encoding">document's character encoding</a> is
+ <p>Otherwise, if the <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a> is
an <a href="infrastructure.html#ascii-compatible-character-encoding">ASCII-compatible character encoding</a>, then that is
the selected character encoding.</p>
@@ -1910,9 +1914,14 @@
- <dt>If the character isn't in the range U+0020, U+002A,
- U+002D, U+002E, U+0030 to U+0039, U+0041 to U+005A, U+005F,
- U+0061 to U+007A</dt>
+ <dt>If the character is in the range U+002A, U+002D, U+002E,
+ U+0030 to U+0039, U+0041 to U+005A, U+005F, U+0061 to
+ U+007A</dt>
+
+ <dd><p>Leave the character as is.</p></dd>
+
+
+ <dt>Otherwise</dt>
<dd>
@@ -1945,10 +1954,6 @@
</ol></dd>
- <dt>Otherwise</dt>
-
- <dd><p>Leave the character as is.</p></dd>
-
</dl></li>
<li><p>If the entry's name is "<code title="attr-fe-name-isindex"><a href="#attr-fe-name-isindex">isindex</a></code>",
@@ -1972,7 +1977,100 @@
<li><p>Encode <var title="">result</var> as US-ASCII and return the
resulting byte stream.</p></li>
- </ol></div><div class="impl">
+ </ol></div><p>To decode <code><a href="iana.html#application-x-www-form-urlencoded">application/x-www-form-urlencoded</a></code>
+ payloads, the following algorithm should be used. This algorithm
+ uses as inputs the payload itself, <var title="">payload</var>,
+ consisting of a Unicode string using only characters in the range
+ U+0000 to U+007F; a default character encoding <var title="">default
+ encoding</var>; and optionally an <var title="">isindex</var> flag
+ indicating that the payload is to be processed as if it had been
+ generated for a form containing an <code title="attr-fe-name-isindex"><a href="#attr-fe-name-isindex">isindex</a></code> control. The output of
+ this algorithm is a sorted list of name-value pairs. If the <var title="">isindex</var> flag is set and the first control really ways
+ an <code title="attr-fe-name-isindex"><a href="#attr-fe-name-isindex">isindex</a></code> control, then
+ the first name-value pair will have as its name the empty
+ string.</p><ol><li><p>Let <var title="">strings</var> be the result of <a href="common-microsyntaxes.html#strictly-split-a-string" title="strictly split a string">strictly splitting the
+ string</a> <var title="">payload</var> on U+0026 AMPERSAND
+ characters (&).</p></li>
+
+ <li><p>If the <var title="">isindex</var> flag is set and the first
+ string in <var title="">strings</var> does not contain a U+003D
+ EQUALS SIGN character (=), insert a U+003D EQUALS SIGN character
+ (=) at the start of the first string in <var title="">strings</var>.</p></li>
+
+ <li><p>Let <var title="">pairs</var> be an empty list of name-value
+ pairs.</p></li>
+
+ <li>
+
+ <p>For each string <var title="">string</var> in <var title="">strings</var>, run these substeps:</p>
+
+ <ol><li>
+
+ <p>If <var title="">string</var> contains a U+003D EQUALS SIGN
+ character (=), then let <var title="">name</var> be the
+ substring of <var title="">string</var> from the start of <var title="">string</var> up to but excluding its first U+003D
+ EQUALS SIGN character (=), and let <var title="">value</var> be
+ the substring from the first character, if any, after the first
+ U+003D EQUALS SIGN character (=) up to the end of <var title="">string</var>. If the first U+003D EQUALS SIGN character
+ (=) is the first character, then <var title="">name</var> will
+ be the empty string. If it is the last character, then <var title="">value</var> will be the empty string.</p>
+
+ <p>Otherwise, <var title="">string</var> contains no U+003D
+ EQUALS SIGN characters (=). Let <var title="">name</var> have
+ the value of <var title="">string</var> and let <var title="">value</var> be the empty string.</p>
+
+ </li>
+
+ <li>
+
+ <p>Replace any U+002B PLUS SIGN characters (+) in <var title="">name</var> and <var title="">value</var> with U+0020
+ SPACE characters.</p>
+
+ </li>
+
+ <li>
+
+ <p>Replace any escape in <var title="">name</var> and <var title="">value</var> with the character represented by the
+ escape. This replacement most not be recursive.</p>
+
+ <p>An escape is a U+0025 PERCENT SIGN character (%) followed by
+ two characters in the ranges U+0030 DIGIT ZERO (0) to U+0039
+ DIGIT NINE (9), U+0041 LATIN CAPITAL LETTER A to U+0046 LATIN
+ CAPITAL LETTER F, and U+0061 LATIN SMALL LETTER A to U+0066
+ LATIN SMALL LETTER F.</p>
+
+ <p>The character represented by an escape is the Unicode
+ character whose code point is equal to the value of the two
+ characters after the U+0025 PERCENT SIGN character (%),
+ interpreted as a hexadecimal number (in the range 0..255).</p>
+
+ <p class="example">So for instance the string "<code title="">A%2BC</code>" would become "<code title="">A+C</code>".
+ Similarly, the string "<code title="">100%25AA%21</code>"
+ becomes the string "<code title="">100%AA!</code>".</p>
+
+ </li>
+
+ <li><p>Convert the <var title="">name</var> and <var title="">value</var> strings to their byte representation in
+ US-ASCII (i.e. convert the Unicode string to a byte
+ string).</p></li>
+
+ <li><p>Add a pair consisting of <var title="">name</var> and <var title="">value</var> to <var title="">pairs</var>.</p></li>
+
+ </ol></li>
+
+ <li><p>If any of the name-value pairs in <var title="">pairs</var>
+ have a name component consisting of the string "<code title="">_charset_</code>" encoded in US-ASCII, and the value
+ component of the first such pair is the name of a supported
+ character encoding, then let <var title="">encoding</var> be that
+ character encoding.</p></li>
+
+ <li><p>Convert the name and value components of each name-value
+ pair in <var title="">pairs</var> to Unicode by interpreting the
+ bytes according to the encoding <var title="">encoding</var>.</p></li>
+
+ <li><p>Return <var title="">pairs</var>.</p></li>
+
+ </ol><div class="impl">
<h5 id="multipart-form-data"><span class="secno">4.10.22.6 </span>Multipart form data</h5>
@@ -2001,7 +2099,7 @@
none of the encodings are supported, or if none are listed, then
let the selected character encoding be UTF-8.</p>
- <p>Otherwise, if the <a href="dom.html#document-s-character-encoding">document's character encoding</a> is
+ <p>Otherwise, if the <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a> is
an <a href="infrastructure.html#ascii-compatible-character-encoding">ASCII-compatible character encoding</a>, then that is
the selected character encoding.</p>
@@ -2075,9 +2173,8 @@
</li>
- </ol></div><div class="impl">
-
- <h5 id="plain-text-form-data"><span class="secno">4.10.22.7 </span>Plain text form data</h5>
+ </ol></div><p>For details on how to interpret <code>multipart/form-data</code>
+ payloads, see RFC 2388. <a href="references.html#refsRFC2388">[RFC2388]</a></p><h5 id="plain-text-form-data"><span class="secno">4.10.22.7 </span>Plain text form data</h5><div class="impl">
<p>The <dfn id="text-plain-encoding-algorithm"><code title="">text/plain</code> encoding
algorithm</dfn> is as follows:</p>
@@ -2095,7 +2192,7 @@
then let the selected character encoding be UTF-8.</p>
<p>Otherwise, the selected character encoding is the
- <a href="dom.html#document-s-character-encoding">document's character encoding</a>.</p>
+ <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a>.</p>
</li>
@@ -2127,7 +2224,11 @@
<li><p>Encode <var title="">result</var> using the selected
character encoding and return the resulting byte stream.</p></li>
- </ol></div><div class="impl">
+ </ol></div><p>Payloads using the <code>text/plain</code> format are intended to
+ be human readable. They are not reliably interpretable by computer,
+ as the format is ambiguous (for example, there is no way to
+ distinguish a literal newline in a value from the newline at the end
+ of the value).</p><div class="impl">
<h4 id="resetting-a-form"><span class="secno">4.10.23 </span>Resetting a form</h4>
Index: forms.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/forms.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- forms.html 17 Jun 2011 08:49:06 -0000 1.12
+++ forms.html 24 Aug 2011 07:56:03 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -534,7 +537,7 @@
</fieldset>
<p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900"<strong> name="delivery"</strong>></label></p>
<p><label>Delivery instructions: <textarea<strong> name="comments"</strong>></textarea></label></p>
- <p><button>Submit order</button><p>
+ <p><button>Submit order</button></p>
</form></pre><p>For example, if the customer entered "Denise Lawrence" as their
name, "555-321-8642" as their telephone number, did not specify an
e-mail address, asked for a medium-sized pizza, selected the Extra
@@ -571,7 +574,7 @@
</fieldset>
<p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900" name="delivery"<strong> required</strong>></label></p>
<p><label>Delivery instructions: <textarea name="comments"></textarea></label></p>
- <p><button>Submit order</button><p>
+ <p><button>Submit order</button></p>
</form></pre><p>It is also possible to limit the length of the input, using the
<code title="attr-fe-maxlength"><a href="association-of-controls-and-forms.html#attr-fe-maxlength">maxlength</a></code> attribute. By
adding this to the <code><a href="the-button-element.html#the-textarea-element">textarea</a></code> element, we can limit users
@@ -598,7 +601,7 @@
</fieldset>
<p><label>Preferred delivery time: <input type=time min="11:00" max="21:00" step="900" name="delivery" required></label></p>
<p><label>Delivery instructions: <textarea name="comments"<strong> maxlength=1000</strong>></textarea></label></p>
- <p><button>Submit order</button><p>
+ <p><button>Submit order</button></p>
</form></pre><h4 id="categories"><span class="secno">4.10.2 </span>Categories</h4><p>Mostly for historical reasons, elements in this section fall into
several overlapping (but subtly different) categories in addition to
the usual ones like <a href="content-models.html#flow-content">flow content</a>, <a href="content-models.html#phrasing-content">phrasing
@@ -711,8 +714,8 @@
readonly attribute <a href="common-dom-interfaces.html#htmlformcontrolscollection">HTMLFormControlsCollection</a> <a href="#dom-form-elements" title="dom-form-elements">elements</a>;
readonly attribute long <a href="#dom-form-length" title="dom-form-length">length</a>;
- caller <a href="#dom-form-item" title="dom-form-item">getter</a> any (in unsigned long index);
- caller <a href="#dom-form-nameditem" title="dom-form-namedItem">getter</a> any (in DOMString name);
+ caller <a href="#dom-form-item" title="dom-form-item">getter</a> <a href="infrastructure.html#element">Element</a> (unsigned long index);
+ caller <a href="#dom-form-nameditem" title="dom-form-namedItem">getter</a> object (DOMString name);
void <a href="#dom-form-submit" title="dom-form-submit">submit</a>();
void <a href="#dom-form-reset" title="dom-form-reset">reset</a>();
@@ -749,7 +752,7 @@
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the form controls in
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the form controls in
the form (excluding image buttons for historical reasons).</p>
</dd>
@@ -840,7 +843,7 @@
collection.</p>
<p>The <dfn id="dom-form-length" title="dom-form-length"><code>length</code></dfn> IDL
- attribute must return the number of nodes <a href="common-dom-interfaces.html#represented-by-the-collection" title="represented by the collection">represented</a> by the <code title="dom-form-elements"><a href="#dom-form-elements">elements</a></code> collection.</p>
+ attribute must return the number of nodes <a href="infrastructure.html#represented-by-the-collection" title="represented by the collection">represented</a> by the <code title="dom-form-elements"><a href="#dom-form-elements">elements</a></code> collection.</p>
<p>The <a href="infrastructure.html#supported-property-indices">supported property indices</a> at any instant are
the indices supported by the object returned by the <code title="dom-form-elements"><a href="#dom-form-elements">elements</a></code> attribute at that
@@ -894,7 +897,7 @@
<hr/><p>The <dfn id="dom-form-submit" title="dom-form-submit"><code>submit()</code></dfn>
method, when invoked, must <a href="association-of-controls-and-forms.html#concept-form-submit" title="concept-form-submit">submit</a> the <code><a href="#the-form-element">form</a></code>
- element from the <code><a href="#the-form-element">form</a></code> element itself, with the <var title="">scripted-submit</var> flag set.</p>
+ element from the <code><a href="#the-form-element">form</a></code> element itself, with the <var title="">submitted from <code title="dom-form-submit"><a href="#dom-form-submit">submit()</a></code> method</var> flag set.</p>
<p>The <dfn id="dom-form-reset" title="dom-form-reset"><code>reset()</code></dfn>
method, when invoked, must run the following steps:</p>
@@ -956,7 +959,7 @@
readonly attribute <a href="association-of-controls-and-forms.html#validitystate">ValidityState</a> <a href="association-of-controls-and-forms.html#dom-cva-validity" title="dom-cva-validity">validity</a>;
readonly attribute DOMString <a href="association-of-controls-and-forms.html#dom-cva-validationmessage" title="dom-cva-validationMessage">validationMessage</a>;
boolean <a href="association-of-controls-and-forms.html#dom-cva-checkvalidatity" title="dom-cva-checkValidatity">checkValidity</a>();
- void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(in DOMString error);
+ void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(DOMString error);
};</pre>
</dd>
</dl><p>The <code><a href="#the-fieldset-element">fieldset</a></code> element <a href="rendering.html#represents">represents</a> a set
@@ -1012,6 +1015,23 @@
</div><div class="example">
+ <p>This example shows a <code><a href="#the-fieldset-element">fieldset</a></code> element being used to
+ group a set of related controls:</p>
+
+ <pre><fieldset>
+ <legend>Display</legend>
+ <p><label><input type=radio name=c value=0 checked> Black on White</label>
+ <p><label><input type=radio name=c value=1> White on Black</label>
+ <p><label><input type=checkbox name=g> Use grayscale</label>
+ <p><label>Enhance contrast <input type=range name=e list=contrast min=0 max=100 value=0 step=1></label>
+ <datalist id=contrast>
+ <option label=Normal value=0>
+ <option label=Maximum value=100>
+ </datalist>
+</fieldset></pre>
+
+ </div><div class="example">
+
<p>The following snippet shows a fieldset with a checkbox in the
legend that controls whether or not the fieldset is enabled. The
contents of the fieldset consist of two required text fields and an
Index: interactive-elements.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/interactive-elements.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- interactive-elements.html 17 Jun 2011 08:49:06 -0000 1.12
+++ interactive-elements.html 24 Aug 2011 07:56:04 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -358,10 +361,10 @@
summary is to be shown.</p><div class="impl">
<p>When the element is created, if the attribute is absent, the
- additional information should be hidden; if the attribute is absent,
- that information should be shown. Subsequently, if the attribute is
- removed, then the information should be hidden; if the attribute is
- added, the information should be shown.</p>
+ additional information should be hidden; if the attribute is
+ present, that information should be shown. Subsequently, if the
+ attribute is removed, then the information should be hidden; if the
+ attribute is added, the information should be shown.</p>
<p>The user agent should allow the user to request that the
additional information be shown or hidden. To honor a request for
@@ -414,6 +417,25 @@
controls can change, and not the actual values, which is less than
ideal.</p>
+ </div><div class="example">
+
+ <p>Because the <code title="attr-details-open"><a href="#attr-details-open">open</a></code>
+ attribute is added and removed automatically as the user interacts
+ with the control, it can be used in CSS to style the element
+ differently based on its state. Here, a stylesheet is used to
+ animate the color of the summary when the element is opened or
+ closed:</p>
+
+ <pre><style>
+ details > summary { transition: color 1s; color: black; }
+ details[open] > summary { color: red; }
+</style>
+<details>
+ <summary>Automated Status: Operational</summary>
+ <p>Velocity: 12m/s</p>
+ <p>Direction: North</p>
+</details></pre>
+
</div><h4 id="the-summary-element"><span class="secno">4.11.2 </span>The <dfn><code>summary</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd>None.</dd>
<dt>Contexts in which this element can be used:</dt>
@@ -671,9 +693,8 @@
</form></pre><p>The behavior in supporting user agents is similar to the example
above, but here the legacy behavior consists of a single
<code><a href="the-button-element.html#the-select-element">select</a></code> element with a submit button. The submit button
- doesn't appear in the toolbar, because it is not a direct child of
- the <code><a href="#the-menu-element">menu</a></code> element or of its <code><a href="grouping-content.html#the-li-element">li</a></code>
- children.</p><div class="impl">
+ doesn't appear in the toolbar, because it is not a child of the
+ <code><a href="#the-menu-element">menu</a></code> element or of its <code><a href="grouping-content.html#the-li-element">li</a></code> children.</p><div class="impl">
<h5 id="building-menus-and-toolbars"><span class="secno">4.11.4.2 </span><dfn>Building menus and toolbars</dfn></h5>
@@ -746,9 +767,9 @@
</ol></div><h5 id="context-menus"><span class="secno">4.11.4.3 </span><dfn>Context menus</dfn></h5><p>The <dfn id="attr-contextmenu" title="attr-contextmenu"><code>contextmenu</code></dfn>
attribute gives the element's <a href="#context-menus" title="context menus">context
- menu</a>. The value must be the <a href="elements.html#concept-id" title="concept-id">ID</a> of a <code><a href="#the-menu-element">menu</a></code> element
- in the DOM. <span class="impl">If the node that would be obtained by
- the invoking the <code title="dom-Document-getElementById"><a href="infrastructure.html#dom-document-getelementbyid">getElementById()</a></code> method
+ menu</a>. The value must be the <a href="elements.html#concept-id" title="concept-id">ID</a> of a <code><a href="#the-menu-element">menu</a></code> element in the
+ DOM. <span class="impl">If the node that would be obtained by
+ invoking the <code title="dom-Document-getElementById"><a href="infrastructure.html#dom-document-getelementbyid">getElementById()</a></code> method
using the attribute's value as the only argument is null or not a
<code><a href="#the-menu-element">menu</a></code> element, then the element has no assigned context
menu. Otherwise, the element's assigned context menu is the element
Index: editing.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/editing.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- editing.html 17 Jun 2011 08:49:05 -0000 1.13
+++ editing.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -747,7 +750,10 @@
<p>Do not use this method to hide the focus ring if you find the
focus ring unsightly. Instead, use a CSS rule to override the
- 'outline' property.</p>
+ 'outline' property. (Be aware, however, that this makes the page
+ significantly less usable for some people, especially those with
+ reduced vision who use focus outlines to help them navigate the
+ page.)</p>
<div class="example">
@@ -896,11 +902,11 @@
keyboard, then skip the remainder of these steps for this
value.</p></li>
- <li><p>If the user agent can find a combination of modifier keys
- that, with the key that corresponds to the value given in the
- attribute, can be used as a shortcut key, then the user agent may
- assign that combination of keys as the element's <a href="#assigned-access-key">assigned
- access key</a> and abort these steps.</p></li>
+ <li><p>If the user agent can find a mix of zero or more modifier
+ keys that, combined with the key that corresponds to the value
+ given in the attribute, can be used as the access key, then the
+ user agent may assign that combination of keys as the element's
+ <a href="#assigned-access-key">assigned access key</a> and abort these steps.</p></li>
</ol></li>
@@ -918,16 +924,17 @@
<p>When the user presses the key combination corresponding to the
<a href="#assigned-access-key">assigned access key</a> for an element, if the element
- <a href="commands.html#concept-command" title="concept-command">defines a command</a>, and the
+ <a href="commands.html#concept-command" title="concept-command">defines a command</a>, the
command's <a href="commands.html#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden
- State</a> facet is false (visible), and the command's <a href="commands.html#command-facet-disabledstate" title="command-facet-DisabledState">Disabled State</a> facet is
- also false (enabled), then the user agent must trigger the <a href="commands.html#command-facet-action" title="command-facet-Action">Action</a> of the command.</p>
+ State</a> facet is false (visible), the command's <a href="commands.html#command-facet-disabledstate" title="command-facet-DisabledState">Disabled State</a> facet is
+ also false (enabled), and the element is <a href="infrastructure.html#in-a-document">in a
+ <code>Document</code></a>, then the user agent must trigger the
+ <a href="commands.html#command-facet-action" title="command-facet-Action">Action</a> of the command.</p>
- <p>User agents may expose elements that have an <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> attribute in other ways as
+ <p class="note">User agents might expose elements that have an <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> attribute in other ways as
well, e.g. in a menu displayed in response to a specific key
- combination.</p>
-
- <p>The <dfn id="dom-accesskey" title="dom-accessKey"><code>accessKey</code></dfn> IDL
+ combination.</p>
+ <hr/><p>The <dfn id="dom-accesskey" title="dom-accessKey"><code>accessKey</code></dfn> IDL
attribute must <a href="common-dom-interfaces.html#reflect">reflect</a> the <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> content attribute.</p>
<p>The <dfn id="dom-accesskeylabel" title="dom-accessKeyLabel"><code>accessKeyLabel</code></dfn> IDL
@@ -973,7 +980,7 @@
<p>Can be set, to change that state.</p>
- <p>Throws a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception if the new value
+ <p>Throws a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception if the new value
isn't one of those strings.</p>
</dd>
@@ -1000,7 +1007,7 @@
value is an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for the string
"<code title="">false</code>" then the content attribute must be set
to the string "<code title="">false</code>", and otherwise the
- attribute setter must raise a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception.</p>
+ attribute setter must raise a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception.</p>
<p>The <dfn id="dom-iscontenteditable" title="dom-isContentEditable"><code>isContentEditable</code></dfn>
IDL attribute, on getting, must return true if the element is
@@ -1249,7 +1256,7 @@
<p>User agents can support the checking of spelling and grammar of
editable text, either in form controls (such as the value of
<code><a href="the-button-element.html#the-textarea-element">textarea</a></code> elements), or in elements in an <a href="#editing-host">editing
- host</a> (using <code title="attr-contenteditable"><a href="#attr-contenteditable">contenteditable</a></code>).</p>
+ host</a> (e.g. using <code title="attr-contenteditable"><a href="#attr-contenteditable">contenteditable</a></code>).</p>
<p>For each element, user agents must establish a <dfn id="concept-spellcheck-default" title="concept-spellcheck-default">default behavior</dfn>, either
through defaults or through preferences expressed by the user. There
Index: browsers.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/browsers.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- browsers.html 17 Jun 2011 08:49:05 -0000 1.13
+++ browsers.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -357,7 +360,7 @@
<code><a href="fetching-resources.html#about:blank">about:blank</a></code> <code><a href="infrastructure.html#document">Document</a></code> to another, with
<a href="history.html#replacement-enabled">replacement enabled</a>. Second, a <code><a href="infrastructure.html#document">Document</a></code>
can end up being reused for several <code><a href="#window">Window</a></code> objects when
- the <code title="dom-document-open"><a href="apis-in-html-documents.html#dom-document-open">document.open()</a></code> method is
+ the <code title="dom-document-open"><a href="content-models.html#dom-document-open">document.open()</a></code> method is
used, such that the mapping is then 1-to-many.</p><p class="note">A <code><a href="infrastructure.html#document">Document</a></code> does not necessarily have a
<a href="#browsing-context">browsing context</a> associated with it. In particular,
data mining tools are likely to never instantiate browsing
@@ -378,7 +381,7 @@
<p>When a <a href="#browsing-context">browsing context</a> is first created, it must be
created with a single <code><a href="infrastructure.html#document">Document</a></code> in its session history,
whose <a href="dom.html#the-document-s-address" title="the document's address">address</a> is
- <code><a href="fetching-resources.html#about:blank">about:blank</a></code>, which is marked as being an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, and whose <a href="dom.html#document-s-character-encoding" title="document's character encoding">character encoding</a> is
+ <code><a href="fetching-resources.html#about:blank">about:blank</a></code>, which is marked as being an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, and whose <a href="infrastructure.html#document-s-character-encoding" title="document's character encoding">character encoding</a> is
UTF-8. The <code><a href="infrastructure.html#document">Document</a></code> must have a single child
<code><a href="semantics.html#the-html-element">html</a></code> node, which itself has a single child
<code><a href="sections.html#the-body-element">body</a></code> node.</p>
@@ -493,7 +496,7 @@
<p>Returns null if there isn't one.</p>
- <p>Throws a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception in cross-origin situations.</p>
+ <p>Throws a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception in cross-origin situations.</p>
</dd>
@@ -530,7 +533,7 @@
<li><p>If the <a href="#browsing-context-container">browsing context container</a>'s
<code><a href="infrastructure.html#document">Document</a></code> does not have the <a href="origin-0.html#same-origin" title="same origin">same</a> <a href="origin-0.html#effective-script-origin">effective script origin</a> as the
- <a href="#entry-script">entry script</a>, then throw a <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code>
+ <a href="#entry-script">entry script</a>, then throw a <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code>
exception.</p></li>
<li><p>Otherwise, return the <a href="#browsing-context-container">browsing context
@@ -906,7 +909,7 @@
</li>
</ol></div><h3 id="the-window-object"><span class="secno">5.2 </span>The <code><a href="#window">Window</a></code> object</h3><pre class="idl">[ReplaceableNamedProperties]
-interface <dfn id="window">Window</dfn> {
+interface <dfn id="window">Window</dfn> : <a href="infrastructure.html#eventtarget">EventTarget</a> {
// the current browsing context
readonly attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-window" title="dom-window">window</a>;
readonly attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-self" title="dom-self">self</a>;
@@ -932,9 +935,9 @@
attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-opener" title="dom-opener">opener</a>;
readonly attribute <a href="#windowproxy">WindowProxy</a> <a href="#dom-parent" title="dom-parent">parent</a>;
readonly attribute <a href="infrastructure.html#element">Element</a>? <a href="#dom-frameelement" title="dom-frameElement">frameElement</a>;
- <a href="#windowproxy">WindowProxy</a> <a href="#dom-open" title="dom-open">open</a>(in optional DOMString url, in optional DOMString target, in optional DOMString features, in optional DOMString replace);
- <a href="#dom-window-item" title="dom-window-item">getter</a> <a href="#windowproxy">WindowProxy</a> (in unsigned long index);
- <a href="#dom-window-nameditem" title="dom-window-namedItem">getter</a> any (in DOMString name);
+ <a href="#windowproxy">WindowProxy</a> <a href="#dom-open" title="dom-open">open</a>(optional DOMString url, optional DOMString target, optional DOMString features, optional DOMString replace);
+ <a href="#dom-window-item" title="dom-window-item">getter</a> <a href="#windowproxy">WindowProxy</a> (unsigned long index);
+ <a href="#dom-window-nameditem" title="dom-window-namedItem">getter</a> object (DOMString name);
// the user agent
readonly attribute <a href="timers.html#navigator">Navigator</a> <a href="timers.html#dom-navigator" title="dom-navigator">navigator</a>;
@@ -942,11 +945,11 @@
readonly attribute <a href="offline.html#applicationcache">ApplicationCache</a> <a href="offline.html#dom-applicationcache" title="dom-applicationCache">applicationCache</a>;
// user prompts
- void <a href="timers.html#dom-alert" title="dom-alert">alert</a>(in DOMString message);
- boolean <a href="timers.html#dom-confirm" title="dom-confirm">confirm</a>(in DOMString message);
- DOMString? <a href="timers.html#dom-prompt" title="dom-prompt">prompt</a>(in DOMString message, in optional DOMString default);
+ void <a href="timers.html#dom-alert" title="dom-alert">alert</a>(DOMString message);
+ boolean <a href="timers.html#dom-confirm" title="dom-confirm">confirm</a>(DOMString message);
+ DOMString? <a href="timers.html#dom-prompt" title="dom-prompt">prompt</a>(DOMString message, optional DOMString default);
void <a href="timers.html#dom-print" title="dom-print">print</a>();
- any <a href="timers.html#dom-showmodaldialog" title="dom-showModalDialog">showModalDialog</a>(in DOMString url, in optional any argument);
+ any <a href="timers.html#dom-showmodaldialog" title="dom-showModalDialog">showModalDialog</a>(DOMString url, optional any argument);
// <a href="webappapis.html#event-handler-idl-attributes">event handler IDL attributes</a>
attribute <a href="webappapis.html#function">Function</a>? <a href="webappapis.html#handler-onabort" title="handler-onabort">onabort</a>;
@@ -1018,8 +1021,7 @@
attribute <a href="webappapis.html#function">Function</a>? <a href="webappapis.html#handler-window-onunload" title="handler-window-onunload">onunload</a>;
attribute <a href="webappapis.html#function">Function</a>? <a href="webappapis.html#handler-onvolumechange" title="handler-onvolumechange">onvolumechange</a>;
attribute <a href="webappapis.html#function">Function</a>? <a href="webappapis.html#handler-onwaiting" title="handler-onwaiting">onwaiting</a>;
-};
-<a href="#window">Window</a> implements <a href="infrastructure.html#eventtarget">EventTarget</a>;</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-window"><a href="#dom-window">window</a></code></dt>
+};</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-window"><a href="#dom-window">window</a></code></dt>
<dt><var title="">window</var> . <code title="dom-frames"><a href="#dom-frames">frames</a></code></dt>
<dt><var title="">window</var> . <code title="dom-self"><a href="#dom-self">self</a></code></dt>
@@ -1069,13 +1071,13 @@
<h4 id="security-window"><span class="secno">5.2.1 </span>Security</h4>
<p id="security-2">User agents must raise a
- <code><a href="common-dom-interfaces.html#security_err">SECURITY_ERR</a></code> exception whenever any of the members of a
+ <code><a href="infrastructure.html#security_err">SECURITY_ERR</a></code> exception whenever any properties of a
<code><a href="#window">Window</a></code> object are accessed by scripts whose
<a href="origin-0.html#effective-script-origin">effective script origin</a> is not the same as the
<code><a href="#window">Window</a></code> object's <code><a href="infrastructure.html#document">Document</a></code>'s <a href="origin-0.html#effective-script-origin">effective
script origin</a>, with the following exceptions:</p>
- <ul><li>The <code title="dom-location"><a href="history.html#dom-location">location</a></code> object
+ <ul><li>The <code title="dom-location"><a href="history.html#dom-location">location</a></code> attribute
</li><li>The <code title="dom-window-postMessage">postMessage()</code> method
@@ -1326,13 +1328,14 @@
the <a href="#active-document">active document</a> with an <code title="attr-id"><a href="elements.html#the-id-attribute">id</a></code> content attribute.</li>
</ul><p class="critical">It is possible that this will change. Browser
- vendors are considering limiting this behaviour to <a href="dom.html#quirks-mode">quirks
+ vendors are considering limiting this behaviour to <a href="infrastructure.html#quirks-mode">quirks
mode</a>. <a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=11960">Read
more...</a></p>
- <p>When <dfn id="dom-window-nameditem" title="dom-window-namedItem">the <code>Window</code>
- object is indexed for property retrieval</dfn> using a name <var title="">name</var>, then the user agent must return the value
- obtained using the following steps:</p>
+ <p>To <a href="infrastructure.html#determine-the-value-of-a-named-property">determine the value of a named property</a> <var title="">name</var> when <dfn id="dom-window-nameditem" title="dom-window-namedItem">the
+ <code>Window</code> object is indexed for property retrieval</dfn>,
+ the user agent must return the value obtained using the following
+ steps:</p>
<ol><li>
@@ -1363,7 +1366,7 @@
<li>
- <p>Otherwise return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ <p>Otherwise return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only <a href="#dom-window-nameditem-filter" title="dom-window-namedItem-filter">named elements</a> with
the name <var title="">name</var>.</p>
</li>
Index: edits.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/edits.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- edits.html 17 Jun 2011 08:49:06 -0000 1.11
+++ edits.html 24 Aug 2011 07:56:03 -0000 1.12
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
Index: the-xhtml-syntax.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/the-xhtml-syntax.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- the-xhtml-syntax.html 17 Jun 2011 08:49:08 -0000 1.12
+++ the-xhtml-syntax.html 24 Aug 2011 07:56:05 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -433,8 +436,8 @@
<li><p>There is no longer a <a href="scripting-1.html#pending-parsing-blocking-script">pending parsing-blocking
script</a>.</p></li>
- </ol><p class="note">Since the <code title="dom-document-write"><a href="apis-in-html-documents.html#dom-document-write">document.write()</a></code> API is not
- available for <a href="dom.html#xml-documents">XML documents</a>, much of the complexity in
+ </ol><p class="note">Since the <code title="dom-document-write"><a href="content-models.html#dom-document-write">document.write()</a></code> API is not
+ available for <a href="infrastructure.html#xml-documents">XML documents</a>, much of the complexity in
the <a href="parsing.html#html-parser">HTML parser</a> is not needed in the <a href="#xml-parser">XML
parser</a>.</p>
@@ -451,7 +454,7 @@
<p>For the purposes of conformance checkers, if a resource is
determined to be in <a href="#the-xhtml-syntax">the XHTML syntax</a>, then it is an
- <a href="dom.html#xml-documents" title="XML documents">XML document</a>.</p>
+ <a href="infrastructure.html#xml-documents" title="XML documents">XML document</a>.</p>
@@ -495,7 +498,7 @@
<p>If any of the following error cases are found in the DOM subtree
being serialized, then the algorithm must raise an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception instead of returning a
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception instead of returning a
string:</p>
<ul><li>A <code><a href="infrastructure.html#document">Document</a></code> node with no child element nodes.</li>
@@ -541,14 +544,14 @@
</ul><p class="note">These are the only ways to make a DOM
unserializable. The DOM enforces all the other XML constraints; for
example, trying to append two elements to a <code><a href="infrastructure.html#document">Document</a></code>
- node will raise a <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
+ node will raise a <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p>
<h3 id="parsing-xhtml-fragments"><span class="secno">9.4 </span>Parsing XHTML fragments</h3>
<p>The <dfn id="xml-fragment-parsing-algorithm">XML fragment parsing algorithm</dfn> either returns a
- <code><a href="infrastructure.html#document">Document</a></code> or raises a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception.
+ <code><a href="infrastructure.html#document">Document</a></code> or raises a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception.
Given a string <var title="">input</var> and an optional context
element <var title="concept-frag-parse-context"><a href="the-end.html#concept-frag-parse-context">context</a></var>, the
algorithm is as follows:</p>
@@ -598,7 +601,7 @@
<li>
<p>If there is an XML well-formedness or XML namespace
- well-formedness error, then raise a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code>
+ well-formedness error, then raise a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code>
exception and abort these steps.</p>
</li>
Index: iana.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/iana.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- iana.html 17 Jun 2011 08:49:06 -0000 1.12
+++ iana.html 24 Aug 2011 07:56:04 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -324,7 +327,7 @@
<a href="spec.html#contents">Table of contents</a> –
<a href="index.html" class="next">Index</a>
<ol class="toc"><li><a href="iana.html#iana"><span class="secno">12 </span>IANA considerations</a>
- <ol><li><a href="iana.html#text-html"><span class="secno">12.1 </span><code>text/html</code></a></li><li><a href="iana.html#text-html-sandboxed"><span class="secno">12.2 </span><code>text/html-sandboxed</code></a></li><li><a href="iana.html#application-xhtml-xml"><span class="secno">12.3 </span><code>application/xhtml+xml</code></a></li><li><a href="iana.html#text-cache-manifest"><span class="secno">12.4 </span><code>text/cache-manifest</code></a></li></ol></li></ol></div><h2 id="iana"><span class="secno">12 </span>IANA considerations</h2><h3 id="text-html"><span class="secno">12.1 </span><dfn><code>text/html</code></dfn></h3><p>This registration is for community review and will be submitted
+ <ol><li><a href="iana.html#text-html"><span class="secno">12.1 </span><code>text/html</code></a></li><li><a href="iana.html#text-html-sandboxed"><span class="secno">12.2 </span><code>text/html-sandboxed</code></a></li><li><a href="iana.html#application-xhtml-xml"><span class="secno">12.3 </span><code>application/xhtml+xml</code></a></li><li><a href="iana.html#application-x-www-form-urlencoded"><span class="secno">12.4 </span><code>application/x-www-form-urlencoded</code></a></li><li><a href="iana.html#text-cache-manifest"><span class="secno">12.5 </span><code>text/cache-manifest</code></a></li></ol></li></ol></div><h2 id="iana"><span class="secno">12 </span>IANA considerations</h2><h3 id="text-html"><span class="secno">12.1 </span><dfn><code>text/html</code></dfn></h3><p>This registration is for community review and will be submitted
to the IESG for review, approval, and registration with IANA.</p><dl><dt>Type name:</dt>
<dd>text</dd>
<dt>Subtype name:</dt>
@@ -336,7 +339,7 @@
<dl><dt><code title="">charset</code></dt>
<dd>
<p>The <code title="">charset</code> parameter may be provided
- to definitively specify the <a href="dom.html#document-s-character-encoding">document's character
+ to definitively specify the <a href="infrastructure.html#document-s-character-encoding">document's character
encoding</a>, overriding any <a href="semantics.html#character-encoding-declaration" title="character encoding declaration">character encoding declarations</a> in the
document. The parameter's value must be the name of the
character encoding used to serialize the file, must be a valid
@@ -398,7 +401,7 @@
<dd id="authors-using-html">
This document is the relevant specification. Labeling a resource
with the <code><a href="#text-html">text/html</a></code> type asserts that the resource is
- an <a href="dom.html#html-documents" title="HTML documents">HTML document</a> using
+ an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a> using
<a href="syntax.html#syntax">the HTML syntax</a>.
</dd>
<dt>Applications that use this media type:</dt>
@@ -430,7 +433,8 @@
<dt>Change controller:</dt>
<dd>W3C</dd>
</dl><p>Fragment identifiers used with <code><a href="#text-html">text/html</a></code> resources
- refer to <a href="history.html#the-indicated-part-of-the-document">the indicated part of the document</a>.</p><h3 id="text-html-sandboxed"><span class="secno">12.2 </span><dfn><code>text/html-sandboxed</code></dfn></h3><p>This registration is for community review and will be submitted
+ either refer to <a href="history.html#the-indicated-part-of-the-document">the indicated part of the document</a> or
+ provide state information for in-page scripts.</p><h3 id="text-html-sandboxed"><span class="secno">12.2 </span><dfn><code>text/html-sandboxed</code></dfn></h3><p>This registration is for community review and will be submitted
to the IESG for review, approval, and registration with IANA.</p><dl><dt>Type name:</dt>
<dd>text</dd>
<dt>Subtype name:</dt>
@@ -472,7 +476,7 @@
<dd>
This document is the relevant specification. Labeling a resource
with the <code><a href="#text-html-sandboxed">text/html-sandboxed</a></code> type asserts that the
- resource is an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>
+ resource is an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>
using <a href="syntax.html#syntax">the HTML syntax</a>.
</dd>
<dt>Applications that use this media type:</dt>
@@ -499,8 +503,9 @@
<dt>Change controller:</dt>
<dd>W3C</dd>
</dl><p>Fragment identifiers used with <code><a href="#text-html-sandboxed">text/html-sandboxed</a></code>
- resources refer to <a href="history.html#the-indicated-part-of-the-document">the indicated part of the
- document</a>.</p><h3 id="application-xhtml-xml"><span class="secno">12.3 </span><dfn><code>application/xhtml+xml</code></dfn></h3><p>This registration is for community review and will be submitted
+ resources either refer to <a href="history.html#the-indicated-part-of-the-document">the indicated part of the
+ document</a> or provide state information for in-page
+ scripts.</p><h3 id="application-xhtml-xml"><span class="secno">12.3 </span><dfn><code>application/xhtml+xml</code></dfn></h3><p>This registration is for community review and will be submitted
to the IESG for review, approval, and registration with IANA.</p><dl><dt>Type name:</dt>
<dd>application</dd>
<dt>Subtype name:</dt>
@@ -548,7 +553,62 @@
<dd>W3C</dd>
</dl><p>Fragment identifiers used with <code><a href="#application-xhtml-xml">application/xhtml+xml</a></code>
resources have the same semantics as with any <a href="infrastructure.html#xml-mime-type">XML MIME
- type</a>. <a href="references.html#refsRFC3023">[RFC3023]</a></p><h3 id="text-cache-manifest"><span class="secno">12.4 </span><dfn><code>text/cache-manifest</code></dfn></h3><p>This registration is for community review and will be submitted
+ type</a>. <a href="references.html#refsRFC3023">[RFC3023]</a></p><h3 id="application-x-www-form-urlencoded"><span class="secno">12.4 </span><dfn><code>application/x-www-form-urlencoded</code></dfn></h3><p>This registration is for community review and will be submitted
+ to the IESG for review, approval, and registration with IANA.</p><dl><dt>Type name:</dt>
+ <dd>application</dd>
+ <dt>Subtype name:</dt>
+ <dd>x-www-form-urlencoded</dd>
+ <dt>Required parameters:</dt>
+ <dd>No parameters</dd>
+ <dt>Optional parameters:</dt>
+ <dd>No parameters</dd>
+ <dt>Encoding considerations:</dt>
+ <dd>7bit US-ASCII encoding of octets that themselves can be encoding text using any <a href="infrastructure.html#ascii-compatible-character-encoding">ASCII-compatible character encoding</a></dd>
+ <dt>Security considerations:</dt>
+ <dd>
+ <p>In isolation, an <code><a href="#application-x-www-form-urlencoded">application/x-www-form-urlencoded</a></code>
+ payload poses no security risks. However, as this type is usually
+ used as part of a form submission, all the risks that apply to
+ HTML forms need to be considered in the context of this type.</p>
+ </dd>
+ <dt>Interoperability considerations:</dt>
+ <dd>
+ Rules for generating and processing
+ <code><a href="#application-x-www-form-urlencoded">application/x-www-form-urlencoded</a></code> payloads are
+ defined in this specification.
+ </dd>
+ <dt>Published specification:</dt>
+ <dd>
+ This document is the relevant specification.
+ </dd>
+ <dt>Applications that use this media type:</dt>
+ <dd>
+ Web browsers and servers.
+ </dd>
+ <dt>Additional information:</dt>
+ <dd>
+ <dl><dt>Magic number(s):</dt>
+ <dd>There is no reliable mechanism for recognising <code><a href="#application-x-www-form-urlencoded">application/x-www-form-urlencoded</a></code> payloads.</dd>
+ <dt>File extension(s):</dt>
+ <dd>Not applicable.</dd>
+ <dt>Macintosh file type code(s):</dt>
+ <dd>Not applicable.</dd>
+ </dl></dd>
+ <dt>Person & email address to contact for further information:</dt>
+ <dd>Ian Hickson <ian@hixie.ch></dd>
+ <dt>Intended usage:</dt>
+ <dd>Common</dd>
+ <dt>Restrictions on usage:</dt>
+ <dd>This type is only intended to be used to describe HTML form
+ submission payloads.</dd>
+ <dt>Author:</dt>
+ <dd>Ian Hickson <ian@hixie.ch></dd>
+ <dt>Change controller:</dt>
+ <dd>W3C</dd>
+ </dl><p>Fragment identifiers have no meaning with the
+ <code><a href="#application-x-www-form-urlencoded">application/x-www-form-urlencoded</a></code> type as this type is
+ only used for uploaded payloads that do not have <a href="urls.html#url">URL</a>
+ identifiers.</p><h3 id="text-cache-manifest"><span class="secno">12.5 </span><dfn><code>text/cache-manifest</code></dfn></h3><p>This registration is for community review and will be submitted
to the IESG for review, approval, and registration with IANA.</p><dl><dt>Type name:</dt>
<dd>text</dd>
<dt>Subtype name:</dt>
Index: offline.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/offline.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- offline.html 17 Jun 2011 08:49:07 -0000 1.13
+++ offline.html 24 Aug 2011 07:56:04 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -352,7 +355,8 @@
document.getElementById('clock').value = new Date();
}, 1000);</pre><p>If the user tries to open the "<code title="">clock.html</code>"
page while offline, though, the user agent (unless it happens to
- have it still in the local cache) will fail with an error.</p><p>The author can instead provide a manifest of the three files:</p><pre>CACHE MANIFEST
+ have it still in the local cache) will fail with an error.</p><p>The author can instead provide a manifest of the three files, say
+ "<code title="">clock.appcache</code>":</p><pre>CACHE MANIFEST
clock.html
clock.css
clock.js</pre><p>With a small change to the HTML file, the manifest (served as
@@ -1431,7 +1435,10 @@
<p>For each URL in <var title="">file list</var>, run the
following steps. These steps may be run in parallel for two or
- more of the URLs at a time.</p>
+ more of the URLs at a time. If, while running these steps, the
+ <code><a href="#applicationcache">ApplicationCache</a></code> object's <code title="dom-appcache-abort"><a href="#dom-appcache-abort">abort()</a></code> method <a href="#send-a-signal" title="send a signal">sends a signal</a> to this instance of the
+ <a href="#application-cache-download-process">application cache download process</a> algorithm, then
+ run the <a href="#cache-failure-steps">cache failure steps</a> instead.</p>
<ol><li>
@@ -1457,12 +1464,12 @@
attribute must be set to true, the <code title="dom-ProgressEvents-total">total</code> attribute must be
set to the number of files in <var title="">file list</var>, and
the <code title="dom-ProgressEvents-loaded">loaded</code>
- attribute must be set to the number of number of files in <var title="">file list</var> that have been either downloaded or
+ attribute must be set to the number of files in <var title="">file list</var> that have been either downloaded or
skipped so far. The default action of these events must be, if
the user agent <a href="#shows-caching-progress">shows caching progress</a>, the display
of some sort of user interface indicating to the user that a file
- is being downloaded in preparation for updating the
- application. <a href="references.html#refsPROGRESS">[PROGRESS]</a></p></li>
+ is being downloaded in preparation for updating the application.
+ <a href="references.html#refsPROGRESS">[PROGRESS]</a></p></li>
<li>
@@ -1508,7 +1515,10 @@
<dd>
- <p>Run the <a href="#cache-failure-steps">cache failure steps</a>.</p>
+ <p>If these steps are being run in parallel for any other URLs
+ in <var title="">file list</var>, then abort these steps for
+ those other URLs. Run the <a href="#cache-failure-steps">cache failure
+ steps</a>.</p>
<p class="note">Redirects are fatal because they are either
indicative of a network problem (e.g. a captive portal); or
@@ -1603,11 +1613,11 @@
<code><a href="#applicationcache">ApplicationCache</a></code> singleton of the <a href="#cache-host">cache
host</a>. The <code title="dom-ProgressEvents-lengthComputable">lengthComputable</code>
attribute must be set to true, the <code title="dom-ProgressEvents-total">total</code> and the <code title="dom-ProgressEvents-loaded">loaded</code> attributes must be
- set to the number of number of files in <var title="">file
- list</var>. The default action of these events must be, if the user
- agent <a href="#shows-caching-progress">shows caching progress</a>, the display of some sort
- of user interface indicating to the user that all the files have
- been downloaded. <a href="references.html#refsPROGRESS">[PROGRESS]</a></p></li>
+ set to the number of files in <var title="">file list</var>. The
+ default action of these events must be, if the user agent
+ <a href="#shows-caching-progress">shows caching progress</a>, the display of some sort of
+ user interface indicating to the user that all the files have been
+ downloaded. <a href="references.html#refsPROGRESS">[PROGRESS]</a></p></li>
<li><p>Store the list of <a href="#concept-appcache-fallback-ns" title="concept-appcache-fallback-ns">fallback namespaces</a>,
and the URLs of the <a href="#concept-appcache-fallback" title="concept-appcache-fallback">fallback entries</a> that they
@@ -2023,7 +2033,7 @@
having an explicit whitelist in the user agent's configuration
interface.</p>
- </div><h4 id="application-cache-api"><span class="secno">5.6.9 </span>Application cache API</h4><pre class="idl">interface <dfn id="applicationcache">ApplicationCache</dfn> {
+ </div><h4 id="application-cache-api"><span class="secno">5.6.9 </span>Application cache API</h4><pre class="idl">interface <dfn id="applicationcache">ApplicationCache</dfn> : <a href="infrastructure.html#eventtarget">EventTarget</a> {
// <a href="#concept-appcache-status" title="concept-appcache-status">update status</a>
const unsigned short <a href="#dom-appcache-uncached" title="dom-appcache-UNCACHED">UNCACHED</a> = 0;
@@ -2036,6 +2046,7 @@
// updates
void <a href="#dom-appcache-update" title="dom-appcache-update">update</a>();
+ void <a href="#dom-appcache-abort" title="dom-appcache-abort">abort</a>();
void <a href="#dom-appcache-swapcache" title="dom-appcache-swapCache">swapCache</a>();
// events
@@ -2047,8 +2058,7 @@
attribute <a href="webappapis.html#function">Function</a>? <a href="#handler-appcache-onupdateready" title="handler-appcache-onupdateready">onupdateready</a>;
attribute <a href="webappapis.html#function">Function</a>? <a href="#handler-appcache-oncached" title="handler-appcache-oncached">oncached</a>;
attribute <a href="webappapis.html#function">Function</a>? <a href="#handler-appcache-onobsolete" title="handler-appcache-onobsolete">onobsolete</a>;
-};
-<a href="#applicationcache">ApplicationCache</a> implements <a href="infrastructure.html#eventtarget">EventTarget</a>;</pre><dl class="domintro"><dt><var title="">cache</var> = <var title="">window</var> . <code title="dom-applicationCache"><a href="#dom-applicationcache">applicationCache</a></code></dt>
+};</pre><dl class="domintro"><dt><var title="">cache</var> = <var title="">window</var> . <code title="dom-applicationCache"><a href="#dom-applicationcache">applicationCache</a></code></dt>
<dd>
<p>(In a window.) Returns the <code><a href="#applicationcache">ApplicationCache</a></code> object that applies to the <a href="browsers.html#active-document">active document</a> of that <code><a href="browsers.html#window">Window</a></code>.</p>
@@ -2078,7 +2088,26 @@
<p>Invokes the <a href="#application-cache-download-process">application cache download process</a>.</p>
- <p>Throws an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if there is no application cache to update.</p>
+ <p>Throws an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if there is no application cache to update.</p>
+
+ <p>Calling this method is not usually necessary, as user agents
+ will generally take care of updating <a href="#application-cache" title="application cache">application caches</a> automatically.</p>
+
+ <p>The method can be useful in situations such as long-lived
+ applications. For example, a Web mail application might stay open
+ in a browser tab for weeks at a time. Such an application could
+ want to test for updates each day.</p>
+
+ </dd>
+
+ <dt><var title="">cache</var> . <code title="dom-appcache-abort"><a href="#dom-appcache-abort">abort</a></code>()</dt>
+ <dd>
+
+ <p>Cancels the <a href="#application-cache-download-process">application cache download process</a>.</p>
+
+ <p>This method is intended to be used by Web application showing
+ their own caching progress UI, in case the user wants to stop the
+ update (e.g. because bandwidth is limited).</p>
</dd>
@@ -2087,7 +2116,7 @@
<p>Switches to the most recent application cache, if there is a
newer one. If there isn't, throws an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception.</p>
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception.</p>
<p>This does not cause previously-loaded resources to be reloaded;
for example, images do not suddenly get reloaded and style sheets
@@ -2095,6 +2124,18 @@
that subsequent requests for cached resources will obtain the
newer copies.</p>
+ <p>The <code title="event-appcache-updateready"><a href="#event-appcache-updateready">updateready</a></code>
+ event will fire before this method can be called. Once it fires,
+ the Web application can, at its leisure, call this method to
+ switch the underlying cache to the one with the more recent
+ updates. To make proper use of this, applications have to be able
+ to bring the new features into play; for example, reloading
+ scripts to enable new features.</p>
+
+ <p>An easier alternative to <code title="dom-appcache-swapCache"><a href="#dom-appcache-swapcache">swapCache()</a></code> is just to
+ reload the entire page at a time suitable for the user, using
+ <code title="dom-location-reload"><a href="history.html#dom-location-reload">location.reload()</a></code>.</p>
+
</dd>
</dl><div class="impl">
@@ -2184,7 +2225,16 @@
<a href="#cache-host">cache host</a> is associated, but without giving that
<a href="#cache-host">cache host</a> to the algorithm. If there is no such
<a href="#application-cache">application cache</a>, or if it is marked as <a href="#concept-appcache-obsolete" title="concept-appcache-obsolete">obsolete</a>, then the method
- must raise an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception instead.</p>
+ must raise an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception instead.</p>
+
+ <p>If the <dfn id="dom-appcache-abort" title="dom-appcache-abort"><code>abort()</code></dfn>
+ method is invoked, the user agent must <dfn id="send-a-signal">send a signal</dfn> to
+ the current <a href="#application-cache-download-process">application cache download process</a> for the
+ <a href="#application-cache">application cache</a> with which the
+ <code><a href="#applicationcache">ApplicationCache</a></code> object's <a href="#cache-host">cache host</a> is
+ associated, if any. If there is no such <a href="#application-cache">application
+ cache</a>, or if does not have a current <a href="#application-cache-download-process">application cache
+ download process</a>, then do nothing.</p>
<p>If the <dfn id="dom-appcache-swapcache" title="dom-appcache-swapCache"><code>swapCache()</code></dfn> method
is invoked, the user agent must run the following steps:
@@ -2192,7 +2242,7 @@
</p><ol><li><p>Check that <code><a href="#applicationcache">ApplicationCache</a></code> object's
<a href="#cache-host">cache host</a> is associated with an <a href="#application-cache">application
cache</a>. If it is not, then raise an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
steps.</p></li>
<li><p>Let <var title="">cache</var> be the <a href="#application-cache">application
@@ -2210,7 +2260,7 @@
<a href="#application-cache-group">application cache group</a> as <var title="">cache</var>
whose <a href="#concept-appcache-completeness" title="concept-appcache-completeness">completeness
flag</a> is <i>complete</i> and that is <a href="#concept-appcache-newer" title="concept-appcache-newer">newer</a> than <var title="">cache</var>. If there is not, then raise an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
steps.</p></li>
<li><p>Let <var title="">new cache</var> be the <a href="#concept-appcache-newer" title="concept-appcache-newer">newest</a> <a href="#application-cache">application
@@ -2237,7 +2287,7 @@
</td></tr><tr><td><dfn id="handler-appcache-onupdateready" title="handler-appcache-onupdateready"><code>onupdateready</code></dfn> </td><td> <code title="event-appcache-updateready"><a href="#event-appcache-updateready">updateready</a></code>
</td></tr><tr><td><dfn id="handler-appcache-oncached" title="handler-appcache-oncached"><code>oncached</code></dfn> </td><td> <code title="event-appcache-cached"><a href="#event-appcache-cached">cached</a></code>
</td></tr><tr><td><dfn id="handler-appcache-onobsolete" title="handler-appcache-onobsolete"><code>onobsolete</code></dfn> </td><td> <code title="event-appcache-obsolete"><a href="#event-appcache-obsolete">obsolete</a></code>
- </td></tr></tbody></table></div><h4 id="browser-state"><span class="secno">5.6.10 </span>Browser state</h4><pre class="idl">[Supplemental, NoInterfaceObject]
+ </td></tr></tbody></table></div><h4 id="browser-state"><span class="secno">5.6.10 </span>Browser state</h4><pre class="idl">[NoInterfaceObject]
interface <dfn id="navigatoronline">NavigatorOnLine</dfn> {
readonly attribute boolean <a href="#dom-navigator-online" title="dom-navigator-onLine">onLine</a>;
};</pre><dl class="domintro"><dt><var title="">window</var> . <code title="dom-navigator"><a href="timers.html#dom-navigator">navigator</a></code> . <code title="dom-navigator-onLine"><a href="#dom-navigator-online">onLine</a></code></dt>
@@ -2289,7 +2339,7 @@
<title>Online status</title>
<script>
function updateIndicator() {
- document.getElementById('indicator').textContext = navigator.onLine ? 'online' : 'offline';
+ document.getElementById('indicator').textContent = navigator.onLine ? 'online' : 'offline';
}
</script>
</head>
Index: content-models.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/content-models.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- content-models.html 17 Jun 2011 08:49:05 -0000 1.13
+++ content-models.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
[...1067 lines suppressed...]
+
+ </dd>
+
+ <dt>If <var title="">position</var> is an <a href="infrastructure.html#ascii-case-insensitive">ASCII
+ case-insensitive</a> match for the string "afterend"</dt>
+
+ <dd>
+
+ <p>Insert all the <var title="">new children</var> nodes
+ immediately after <var title="">target</var>.</p>
+
+ </dd>
+
+ </dl><p>The <var title="">new children</var> nodes must be inserted in
+ a manner that preserves their order and fires mutation events as
+ if a <code><a href="infrastructure.html#documentfragment">DocumentFragment</a></code> containing the <var title="">new children</var> had been inserted.</p>
+
+ </li>
+
+ </ol></div></body></html>
Index: states-of-the-type-attribute.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/states-of-the-type-attribute.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- states-of-the-type-attribute.html 17 Jun 2011 08:49:07 -0000 1.12
+++ states-of-the-type-attribute.html 24 Aug 2011 07:56:04 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -738,7 +741,8 @@
<div class="impl">
<p><strong>The <a href="the-input-element.html#value-sanitization-algorithm">value sanitization algorithm</a> is as
- follows</strong>: <a href="common-microsyntaxes.html#strip-line-breaks">Strip line breaks</a> from the <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a>.</p>
+ follows</strong>: <a href="common-microsyntaxes.html#strip-line-breaks">Strip line breaks</a> from the <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a>, then <a href="common-microsyntaxes.html#strip-leading-and-trailing-whitespace">strip leading
+ and trailing whitespace</a> from the <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a>.</p>
<p>When the <code title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple">multiple</a></code>
attribute is removed, the user agent must run the <a href="the-input-element.html#value-sanitization-algorithm">value
@@ -838,9 +842,10 @@
</dl><p>A <dfn id="valid-e-mail-address">valid e-mail address</dfn> is a string that matches the
ABNF production <code title="">1*( atext / "." ) "@" ldh-str *( "." ldh-str )</code>
- where <code title="">atext</code> is defined in RFC 5322 section
- 3.2.3, and <code title="">ldh-str</code> is defined in RFC 1034
- section 3.5. <a href="references.html#refsABNF">[ABNF]</a> <a href="references.html#refsRFC5322">[RFC5322]</a> <a href="references.html#refsRFC1034">[RFC1034]</a></p><p class="note">This requirement is a <a href="introduction.html#willful-violation">willful violation</a>
+ where <code title="">atext</code> is defined in <a href="http://tools.ietf.org/html/rfc5322#section-3.2.3">RFC 5322
+ section 3.2.3</a>, and <code title="">ldh-str</code> is defined in
+ <a href="http://tools.ietf.org/html/rfc1034#section-3.5">RFC 1034
+ section 3.5</a>. <a href="references.html#refsABNF">[ABNF]</a> <a href="references.html#refsRFC5322">[RFC5322]</a> <a href="references.html#refsRFC1034">[RFC1034]</a></p><p class="note">This requirement is a <a href="introduction.html#willful-violation">willful violation</a>
of RFC 5322, which defines a syntax for e-mail addresses that is
simultaneously too strict (before the "@" character), too vague
(after the "@" character), and too lax (allowing comments, white
Index: apis-in-html-documents.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/apis-in-html-documents.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- apis-in-html-documents.html 17 Jun 2011 08:49:05 -0000 1.13
+++ apis-in-html-documents.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -324,13 +324,13 @@
<a href="spec.html#contents">Table of contents</a> –
<a href="semantics.html" class="next">4 The elements of HTML</a>
<ol class="toc"><li><ol><li><a href="apis-in-html-documents.html#apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</a></li><li><a href="apis-in-html-documents.html#interactions-with-xpath-and-xslt"><span class="secno">3.4 </span>Interactions with XPath and XSLT</a></li><li><a href="apis-in-html-documents.html#dynamic-markup-insertion"><span class="secno">3.5 </span>Dynamic markup insertion</a>
- <ol><li><a href="apis-in-html-documents.html#opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</a></li><li><a href="apis-in-html-documents.html#closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</a></li><li><a href="apis-in-html-documents.html#document.write"><span class="secno">3.5.3 </span><code title="dom-document-write">document.write()</code></a></li><li><a href="apis-in-html-documents.html#document.writeln"><span class="secno">3.5.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li><li><a href="apis-in-html-documents.html#innerhtml"><span class="secno">3.5.5 </span><code title="dom-innerHTML">innerHTML</code></a></li><li><a href="apis-in-html-documents.html#outerhtml"><span class="secno">3.5.6 </span><code title="dom-outerHTML">outerHTML</code></a></li><li><a href="apis-in-html-documents.html#insertadjacenthtml"><span class="secno">3.5.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</coe></a></li></ol></li></ol></li></ol></div><h3 id="apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</h3><p>For <a href="dom.html#html-documents">HTML documents</a>, and for <a href="infrastructure.html#html-elements">HTML
- elements</a> in <a href="dom.html#html-documents">HTML documents</a>, certain APIs defined
+ <ol><li><a href="apis-in-html-documents.html#opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</a></li><li><a href="apis-in-html-documents.html#closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</a></li><li><a href="apis-in-html-documents.html#document.write"><span class="secno">3.5.3 </span><code title="dom-document-write">document.write()</code></a></li><li><a href="apis-in-html-documents.html#document.writeln"><span class="secno">3.5.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li><li><a href="apis-in-html-documents.html#innerhtml"><span class="secno">3.5.5 </span><code title="dom-innerHTML">innerHTML</code></a></li><li><a href="apis-in-html-documents.html#outerhtml"><span class="secno">3.5.6 </span><code title="dom-outerHTML">outerHTML</code></a></li><li><a href="apis-in-html-documents.html#insertadjacenthtml"><span class="secno">3.5.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</coe></a></li></ol></li></ol></li></ol></div><h3 id="apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</h3><p>For <a href="infrastructure.html#html-documents">HTML documents</a>, and for <a href="infrastructure.html#html-elements">HTML
+ elements</a> in <a href="infrastructure.html#html-documents">HTML documents</a>, certain APIs defined
in DOM Core become case-insensitive or case-changing, as sometimes
defined in DOM Core, and as summarized <span class="impl">or
- required</span> below. <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><p>This does not apply to <a href="dom.html#xml-documents">XML documents</a> or to elements
+ required</span> below. <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><p>This does not apply to <a href="infrastructure.html#xml-documents">XML documents</a> or to elements
that are not in the <a href="namespaces.html#html-namespace-0">HTML namespace</a> despite being in
- <a href="dom.html#html-documents">HTML documents</a>.</p><dl><dt><code title="dom-Element-tagName"><a href="infrastructure.html#dom-element-tagname">Element.tagName</a></code> and <code title="dom-Node-nodeName">Node.nodeName</code></dt>
+ <a href="infrastructure.html#html-documents">HTML documents</a>.</p><dl><dt><code title="dom-Element-tagName"><a href="infrastructure.html#dom-element-tagname">Element.tagName</a></code> and <code title="dom-Node-nodeName">Node.nodeName</code></dt>
<dd>
@@ -423,7 +423,7 @@
</div>
- <p class="note">Thus, in an <a href="dom.html#html-documents" title="HTML documents">HTML
+ <p class="note">Thus, in an <a href="infrastructure.html#html-documents" title="HTML documents">HTML
document</a> with nodes in multiple namespaces, these methods
will effectively be both case-sensitive and case-insensitive at
the same time.</p>
@@ -436,7 +436,7 @@
<h3 id="interactions-with-xpath-and-xslt"><span class="secno">3.4 </span>Interactions with XPath and XSLT</h3>
<p id="xpath-1.0-processors">Implementations of XPath 1.0 that
- operate on <a href="dom.html#html-documents">HTML documents</a> parsed or created in the
+ operate on <a href="infrastructure.html#html-documents">HTML documents</a> parsed or created in the
manners described in this specification (e.g. as part of the <code title="">document.evaluate()</code> API) must act as if the
following edit was applied to the XPath 1.0 specification.</p>
@@ -521,8 +521,8 @@
</div><h3 id="dynamic-markup-insertion"><span class="secno">3.5 </span><dfn>Dynamic markup insertion</dfn></h3><p class="note">APIs for dynamically inserting markup into the
document interact with the parser, and thus their behavior varies
- depending on whether they are used with <a href="dom.html#html-documents">HTML documents</a>
- (and the <a href="parsing.html#html-parser">HTML parser</a>) or XHTML in <a href="dom.html#xml-documents">XML
+ depending on whether they are used with <a href="infrastructure.html#html-documents">HTML documents</a>
+ (and the <a href="parsing.html#html-parser">HTML parser</a>) or XHTML in <a href="infrastructure.html#xml-documents">XML
documents</a> (and the <a href="the-xhtml-syntax.html#xml-parser">XML parser</a>).</p><h4 id="opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</h4><p>The <dfn id="dom-document-open" title="dom-document-open"><code>open()</code></dfn>
method comes in several variants with different numbers of
arguments.</p><dl class="domintro"><dt><var title="">document</var> = <var title="">document</var> . <code title="dom-document-open"><a href="#dom-document-open">open</a></code>( [ <var title="">type</var> [, <var title="">replace</var> ] ] )</dt>
@@ -548,8 +548,8 @@
<p>The method has no effect if the <code><a href="infrastructure.html#document">Document</a></code> is still
being parsed.</p>
- <p>Throws an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the
- <code><a href="infrastructure.html#document">Document</a></code> is an <a href="dom.html#xml-documents" title="XML documents">XML
+ <p>Throws an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the
+ <code><a href="infrastructure.html#document">Document</a></code> is an <a href="infrastructure.html#xml-documents" title="XML documents">XML
document</a>.</p>
</dd>
@@ -568,8 +568,8 @@
<p>When called with two or fewer arguments, the method must act as
follows:</p>
- <ol><li>If the <code><a href="infrastructure.html#document">Document</a></code> object is not flagged as an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, throw an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
+ <ol><li>If the <code><a href="infrastructure.html#document">Document</a></code> object is not flagged as an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, throw an
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
steps.</li>
<li><p>Let <var title="">type</var> be the value of the first
@@ -626,7 +626,7 @@
<code><a href="offline.html#applicationcache">ApplicationCache</a></code>,
and <code><a href="timers.html#navigator">Navigator</a></code>, objects, the various
<code><a href="browsers.html#barprop">BarProp</a></code> objects, the two <code>Storage</code> objects,
- the various <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> objects, and objects
+ the various <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> objects, and objects
defined by other specifications, like <code>Selection</code>. It
also includes all the Web IDL prototypes in the JavaScript binding,
including the <code><a href="infrastructure.html#document">Document</a></code> object's prototype.)</p></li>
@@ -634,7 +634,7 @@
- <li><p>Change the <a href="dom.html#document-s-character-encoding">document's character encoding</a> to
+ <li><p>Change the <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a> to
UTF-8.</p></li>
<li><p>Set the <code><a href="infrastructure.html#document">Document</a></code> object's <a href="dom.html#reload-override-flag">reload override
@@ -717,7 +717,7 @@
arguments as the original call to the <code title="dom-document-open"><a href="#dom-document-open">open()</a></code> method, and return whatever
that method returned. If the <code><a href="dom.html#htmldocument">HTMLDocument</a></code> object has no
<code><a href="browsers.html#window">Window</a></code> object, then the method must raise an
- <code><a href="common-dom-interfaces.html#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception.</p>
+ <code><a href="infrastructure.html#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception.</p>
</div><h4 id="closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-close"><a href="#dom-document-close">close</a></code>()</dt>
@@ -725,8 +725,8 @@
<p>Closes the input stream that was opened by the <code title="dom-document-open"><a href="#dom-document-open">document.open()</a></code> method.</p>
- <p>Throws an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the
- <code><a href="infrastructure.html#document">Document</a></code> is an <a href="dom.html#xml-documents" title="XML documents">XML
+ <p>Throws an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the
+ <code><a href="infrastructure.html#document">Document</a></code> is an <a href="infrastructure.html#xml-documents" title="XML documents">XML
document</a>.</p>
</dd>
@@ -737,8 +737,8 @@
method must run the following steps:</p>
<ol><li><p>If the <code><a href="infrastructure.html#document">Document</a></code> object is not flagged as an
- <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, throw an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
+ <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, throw an
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
steps.</p></li>
<li><p>If there is no <a href="#script-created-parser">script-created parser</a> associated
@@ -774,8 +774,8 @@
these reasons, use of this method is strongly
discouraged.</strong></p>
- <p>This method throws an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception
- when invoked on <a href="dom.html#xml-documents">XML documents</a>.</p>
+ <p>This method throws an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception
+ when invoked on <a href="infrastructure.html#xml-documents">XML documents</a>.</p>
</dd>
@@ -793,8 +793,8 @@
<ol><li>
- <p>If the method was invoked on an <a href="dom.html#xml-documents" title="XML documents">XML
- document</a>, throw an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code>
+ <p>If the method was invoked on an <a href="infrastructure.html#xml-documents" title="XML documents">XML
+ document</a>, throw an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code>
exception and abort these steps.</p>
@@ -869,8 +869,8 @@
<code title="dom-document-open"><a href="#dom-document-open">open()</a></code> method implicitly
first.</p>
- <p>This method throws an <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception
- when invoked on <a href="dom.html#xml-documents">XML documents</a>.</p>
+ <p>This method throws an <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception
+ when invoked on <a href="infrastructure.html#xml-documents">XML documents</a>.</p>
</dd>
@@ -892,9 +892,9 @@
<p>Can be set, to replace the <code><a href="infrastructure.html#document">Document</a></code>'s contents
with the result of parsing the given string.</p>
- <p>In the case of <a href="dom.html#xml-documents">XML documents</a>, will throw an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> if the <code><a href="infrastructure.html#document">Document</a></code> cannot
- be serialized to XML, and a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> if the given
+ <p>In the case of <a href="infrastructure.html#xml-documents">XML documents</a>, will throw an
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> if the <code><a href="infrastructure.html#document">Document</a></code> cannot
+ be serialized to XML, and a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> if the given
string is not well-formed.</p>
</dd>
@@ -909,19 +909,19 @@
<p>Can be set, to replace the contents of the element with nodes
parsed from the given string.</p>
- <p>In the case of <a href="dom.html#xml-documents">XML documents</a>, will throw an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> if the element cannot be serialized
- to XML, and a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> if the given string is not
+ <p>In the case of <a href="infrastructure.html#xml-documents">XML documents</a>, will throw an
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> if the element cannot be serialized
+ to XML, and a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> if the given string is not
well-formed.</p>
</dd>
</dl><div class="impl">
- <p>On getting, if the node's document is an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, then the attribute must return the
+ <p>On getting, if the node's document is an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, then the attribute must return the
result of running the <a href="the-end.html#html-fragment-serialization-algorithm">HTML fragment serialization
algorithm</a> on the node; otherwise, the node's document is an
- <a href="dom.html#xml-documents" title="XML documents">XML document</a>, and the attribute
+ <a href="infrastructure.html#xml-documents" title="XML documents">XML document</a>, and the attribute
must return the result of running the <a href="the-xhtml-syntax.html#xml-fragment-serialization-algorithm">XML fragment
serialization algorithm</a> on the node instead (this might raise
an exception instead of returning a string).</p>
@@ -930,11 +930,11 @@
<ol><li>
- <p>If the node's document is an <a href="dom.html#html-documents" title="HTML documents">HTML
+ <p>If the node's document is an <a href="infrastructure.html#html-documents" title="HTML documents">HTML
document</a>: Invoke the <a href="the-end.html#html-fragment-parsing-algorithm">HTML fragment parsing
algorithm</a>.</p>
- <p>If the node's document is an <a href="dom.html#xml-documents" title="XML documents">XML
+ <p>If the node's document is an <a href="infrastructure.html#xml-documents" title="XML documents">XML
document</a>: Invoke the <a href="the-xhtml-syntax.html#xml-fragment-parsing-algorithm">XML fragment parsing
algorithm</a>.</p>
@@ -1002,12 +1002,12 @@
<p>Can be set, to replace the element with nodes parsed from the
given string.</p>
- <p>In the case of <a href="dom.html#xml-documents">XML documents</a>, will throw an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> if the element cannot be serialized
- to XML, and a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> if the given string is not
+ <p>In the case of <a href="infrastructure.html#xml-documents">XML documents</a>, will throw an
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> if the element cannot be serialized
+ to XML, and a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> if the given string is not
well-formed.</p>
- <p>Throws a <code><a href="common-dom-interfaces.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception if
+ <p>Throws a <code><a href="infrastructure.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception if
the parent of the element is the <code><a href="infrastructure.html#document">Document</a></code>
node.</p>
@@ -1015,11 +1015,11 @@
</dl><div class="impl">
- <p>On getting, if the node's document is an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>, then the attribute must return the
+ <p>On getting, if the node's document is an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>, then the attribute must return the
result of running the <a href="the-end.html#html-fragment-serialization-algorithm">HTML fragment serialization
algorithm</a> on a fictional node whose only child is the node on
which the attribute was invoked; otherwise, the node's document is
- an <a href="dom.html#xml-documents" title="XML documents">XML document</a>, and the
+ an <a href="infrastructure.html#xml-documents" title="XML documents">XML document</a>, and the
attribute must return the result of running the <a href="the-xhtml-syntax.html#xml-fragment-serialization-algorithm">XML fragment
serialization algorithm</a> on that fictional node instead (this
might raise an exception instead of returning a string).</p>
@@ -1045,7 +1045,7 @@
<p>If <var title="">target</var>'s parent node is a
<code><a href="infrastructure.html#document">Document</a></code> object, throw a
- <code><a href="common-dom-interfaces.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception and abort these
steps.</p>
</li>
@@ -1061,10 +1061,10 @@
<li>
- <p>If <var title="">target</var>'s document is an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>: Invoke the <a href="the-end.html#html-fragment-parsing-algorithm">HTML
+ <p>If <var title="">target</var>'s document is an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>: Invoke the <a href="the-end.html#html-fragment-parsing-algorithm">HTML
fragment parsing algorithm</a>.</p>
- <p>If <var title="">target</var>'s document is an <a href="dom.html#xml-documents" title="XML documents">XML document</a>: Invoke the <a href="the-xhtml-syntax.html#xml-fragment-parsing-algorithm">XML fragment
+ <p>If <var title="">target</var>'s document is an <a href="infrastructure.html#xml-documents" title="XML documents">XML document</a>: Invoke the <a href="the-xhtml-syntax.html#xml-fragment-parsing-algorithm">XML fragment
parsing algorithm</a>.</p>
<p>In either case, the algorithm must be invoked with the string
@@ -1112,11 +1112,11 @@
<dd>Just inside the element, after its last child.</dd>
<dt>"afterend"</dt>
<dd>After the element itself.</dd>
- </dl><p>Throws a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception if the arguments
- have invalid values (e.g., in the case of <a href="dom.html#xml-documents">XML
+ </dl><p>Throws a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception if the arguments
+ have invalid values (e.g., in the case of <a href="infrastructure.html#xml-documents">XML
documents</a>, if the given string is not well-formed).</p>
- <p>Throws a <code><a href="common-dom-interfaces.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception if
+ <p>Throws a <code><a href="infrastructure.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception if
the given position isn't possible (e.g. inserting elements after
the root element of a <code><a href="infrastructure.html#document">Document</a></code>).</p>
@@ -1157,7 +1157,7 @@
<p>If <var title="">target</var>'s parent node is a
<code><a href="infrastructure.html#document">Document</a></code> object, then throw a
- <code><a href="common-dom-interfaces.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception and abort
+ <code><a href="infrastructure.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception and abort
these steps.
</p><p>Otherwise, let <var title="">destination</var> be the parent node
@@ -1180,7 +1180,7 @@
<dd>
- <p>Throw a <code><a href="common-dom-interfaces.html#syntax_err">SYNTAX_ERR</a></code> exception.</p>
+ <p>Throw a <code><a href="infrastructure.html#syntax_err">SYNTAX_ERR</a></code> exception.</p>
</dd>
@@ -1188,10 +1188,10 @@
<li>
- <p>If <var title="">target</var>'s document is an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>: Invoke the <a href="the-end.html#html-fragment-parsing-algorithm">HTML
+ <p>If <var title="">target</var>'s document is an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>: Invoke the <a href="the-end.html#html-fragment-parsing-algorithm">HTML
fragment parsing algorithm</a>.</p>
- <p>If <var title="">target</var>'s document is an <a href="dom.html#xml-documents" title="XML documents">XML document</a>: Invoke the <a href="the-xhtml-syntax.html#xml-fragment-parsing-algorithm">XML fragment
+ <p>If <var title="">target</var>'s document is an <a href="infrastructure.html#xml-documents" title="XML documents">XML document</a>: Invoke the <a href="the-xhtml-syntax.html#xml-fragment-parsing-algorithm">XML fragment
parsing algorithm</a>.</p>
<p>In either case, the algorithm must be invoked with <var title="">text</var> as the <var title="">input</var>, and <var title="">destination</var> as the <var title="concept-frag-parse-context"><a href="the-end.html#concept-frag-parse-context">context</a></var> element.</p>
Index: obsolete.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/obsolete.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- obsolete.html 17 Jun 2011 08:49:07 -0000 1.13
+++ obsolete.html 24 Aug 2011 07:56:04 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -349,7 +352,11 @@
be equal to the element's <a href="elements.html#concept-id" title="concept-id">ID</a>. In
earlier versions of the language, this attribute was intended as a
way to specify possible targets for fragment identifiers in <a href="urls.html#url" title="URL">URLs</a>. The <code title="attr-id"><a href="elements.html#the-id-attribute">id</a></code>
- attribute should be used instead.</p><p class="note">In <a href="syntax.html#syntax">the HTML syntax</a>, specifying a <a href="syntax.html#syntax-doctype" title="syntax-DOCTYPE">DOCTYPE</a> that is an <a href="syntax.html#obsolete-permitted-doctype">obsolete
+ attribute should be used instead.</p><p>Authors should not specify the <code title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength">maxlength</a></code> attribute on
+ <code><a href="the-input-element.html#the-input-element">input</a></code> elements whose <code title="attr-input-type"><a href="the-input-element.html#attr-input-type">type</a></code> attribute is in the <a href="number-state.html#number-state" title="attr-input-type-number">Number</a> state. One valid reason
+ for using the attribute regardless is to help legacy user agents
+ that do not support <code><a href="the-input-element.html#the-input-element">input</a></code> elements with <code title="">type="number"</code> to still render the text field with a
+ useful width.</p><p class="note">In <a href="syntax.html#syntax">the HTML syntax</a>, specifying a <a href="syntax.html#syntax-doctype" title="syntax-DOCTYPE">DOCTYPE</a> that is an <a href="syntax.html#obsolete-permitted-doctype">obsolete
permitted DOCTYPE</a> will also trigger a warning.</p><div class="impl">
<h4 id="warnings-for-obsolete-but-conforming-features"><span class="secno">11.1.1 </span>Warnings for obsolete but conforming features</h4>
@@ -368,7 +375,7 @@
above:</p>
<ul><li><p>The presence of an <a href="syntax.html#obsolete-permitted-doctype">obsolete permitted DOCTYPE</a>
- in an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>.</p></li>
+ in an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a>.</p></li>
<li><p>The presence of a <code title="attr-img-border"><a href="#attr-img-border">border</a></code> attribute on an
<code><a href="embedded-content-1.html#the-img-element">img</a></code> element if its value is the string "<code title="">0</code>".</p></li>
@@ -383,6 +390,9 @@
attribute on an <code><a href="text-level-semantics.html#the-a-element">a</a></code> element, if its value is not the
empty string.</p></li>
+ <li><p>The presence of a <code title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength">maxlength</a></code> attribute on
+ an <code><a href="the-input-element.html#the-input-element">input</a></code> element whose <code title="attr-input-type"><a href="the-input-element.html#attr-input-type">type</a></code> attribute is in the <a href="number-state.html#number-state" title="attr-input-type-number">Number</a> state.</p></li>
+
</ul><p>Conformance checkers must distinguish between pages that have no
conformance errors and have none of these obsolete features, and
pages that have no conformance errors but do have some of these
@@ -495,6 +505,9 @@
<dt><dfn id="attr-link-urn" title="attr-link-urn"><code>urn</code></dfn> on <code><a href="semantics.html#the-link-element">link</a></code> elements</dt>
<dd><p>Specify the preferred persistent identifier using the <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code> attribute instead.</p></dd>
+ <dt><dfn id="attr-form-accept" title="attr-form-accept"><code>accept</code></dfn> on <code><a href="forms.html#the-form-element">form</a></code> elements</dt>
+ <dd><p>Use the <code title="attr-input-accept"><a href="number-state.html#attr-input-accept">accept</a></code> attribute directly on the <code><a href="the-input-element.html#the-input-element">input</a></code> elements instead.</p></dd>
+
<dt><dfn id="attr-area-nohref" title="attr-area-nohref"><code>nohref</code></dfn> on <code><a href="the-map-element.html#the-area-element">area</a></code> elements</dt>
<dd><p>Omitting the <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code>
attribute is sufficient; the <code title="attr-area-nohref"><a href="#attr-area-nohref">nohref</a></code> attribute is
@@ -570,6 +583,9 @@
</dd><dt><dfn id="attr-tdth-axis" title="attr-tdth-axis"><code>axis</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt>
<dd><p>Use the <code title="attr-th-scope"><a href="tabular-data.html#attr-th-scope">scope</a></code> attribute on the relevant <code><a href="tabular-data.html#the-th-element">th</a></code>.</p>
+ </dd><dt><dfn id="attr-td-scope" title="attr-td-scope"><code>scope</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> elements</dt>
+ <dd><p>Use <code><a href="tabular-data.html#the-th-element">th</a></code> elements for heading cells.</p>
+
</dd><dt><dfn id="attr-datasrc" title="attr-datasrc"><code>datasrc</code></dfn> on <code><a href="text-level-semantics.html#the-a-element">a</a></code>, <code><a href="#the-applet-element">applet</a></code>, <code><a href="the-button-element.html#the-button-element">button</a></code>, <code><a href="grouping-content.html#the-div-element">div</a></code>, <code><a href="#frame">frame</a></code>, <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code>, <code><a href="embedded-content-1.html#the-img-element">img</a></code>, <code><a href="the-input-element.html#the-input-element">input</a></code>, <code><a href="forms.html#the-label-element">label</a></code>, <code><a href="forms.html#the-legend-element">legend</a></code>, <code><a href="#the-marquee-element">marquee</a></code>, <code><a href="the-iframe-element.html#the-object-element">object</a></code>, <code><a href="the-button-element.html#the-option-element">option</a></code>, <code><a href="the-button-element.html#the-select-elemet">select</a></code>, <code><a href="text-level-semantics.html#the-span-element">span</a></code>, <code><a href="tabular-data.html#the-table-element">table</a></code>, and <code><a href="the-button-element.html#the-textarea-element">textarea</a></code> elements</dt>
<dt><dfn id="attr-datafld" title="attr-datafld"><code>datafld</code></dfn> on <code><a href="text-level-semantics.html#the-a-element">a</a></code>, <code><a href="#the-applet-element">applet</a></code>, <code><a href="the-button-element.html#the-button-element">button</a></code>, <code><a href="grouping-content.html#the-div-element">div</a></code>, <code><a href="forms.html#the-fieldset-element">fieldset</a></code>, <code><a href="#frame">frame</a></code>, <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code>, <code><a href="embedded-content-1.html#the-img-element">img</a></code>, <code><a href="the-input-element.html#the-input-element">input</a></code>, <code><a href="forms.html#the-label-element">label</a></code>, <code><a href="forms.html#the-legend-element">legend</a></code>, <code><a href="#the-marquee-element">marquee</a></code>, <code><a href="the-iframe-element.html#the-object-element">object</a></code>, <code><a href="the-iframe-element.html#the-param-element">param</a></ode>, <code><a href="the-button-element.html#the-select-element">select</a></code>, <code><a href="text-level-semantics.html#the-span-element">span</a></code>, and <code><a href="the-button-element.html#the-textarea-element">textarea</a></code> elements</dt>
<dt><dfn id="attr-dataformatas" title="attr-dataformatas"><code>dataformatas</code></dfn> on <code><a href="the-button-element.html#the-button-element">button</a></code>, <code><a href="grouping-content.html#the-div-element">div</a></code>, <code><a href="the-input-element.html#the-input-element">input</a></code>, <code><a href="forms.html#the-label-element">label</a></code>, <code><a href="forms.html#the-legend-element">legend</a></code>, <code><a href="#the-marquee-element">marquee</a></code>, <code><a href="the-iframe-element.html#the-object-element">object</a></code>, <code><a href="the-button-element.html#the-option-element">option</a></code>, <code><a href="the-button-element.html#the-select-element">select</a></code>, <code><a href="text-level-semantics.html#the-span-element">span</a></code>, and <code><a href="tabular-data.html#the-table-element">table</a></code> elements</dt>
@@ -1105,8 +1121,7 @@
equivalent to <code><a href="text-level-semantics.html#the-abbr-element">abbr</a></code> elements in terms of semantics and
for purposes of rendering.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="text-level-semantics.html#htmlanchorelement">HTMLAnchorElement</a> {
+ <hr/><pre class="idl">partial interface <a href="text-level-semantics.html#htmlanchorelement">HTMLAnchorElement</a> {
attribute DOMString <a href="#dom-a-coords" title="dom-a-coords">coords</a>;
attribute DOMString <a href="#dom-a-charset" title="dom-a-charset">charset</a>;
attribute DOMString <a href="#dom-a-name" title="dom-a-name">name</a>;
@@ -1118,8 +1133,7 @@
<code><a href="text-level-semantics.html#the-a-element">a</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a> the respective
content attributes of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="the-map-element.html#htmlareaelement">HTMLAreaElement</a> {
+ <hr/><pre class="idl">partial interface <a href="the-map-element.html#htmlareaelement">HTMLAreaElement</a> {
attribute boolean <a href="#dom-area-nohref" title="dom-area-noHref">noHref</a>;
};</pre>
@@ -1142,8 +1156,7 @@
the <code><a href="#basefont">basefont</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a> the
respective content attributes of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="sections.html#htmlbodyelement">HTMLBodyElement</a> {
+ <hr/><pre class="idl">partial interface <a href="sections.html#htmlbodyelement">HTMLBodyElement</a> {
attribute DOMString <a href="#dom-body-text" title="dom-body-text">text</a>;
attribute DOMString <a href="#dom-body-bgcolor" title="dom-body-bgColor">bgColor</a>;
attribute DOMString <a href="#dom-body-background" title="dom-body-background">background</a>;
@@ -1184,8 +1197,7 @@
the element's <code title="attr-body-vlink"><a href="#attr-body-vlink">vlink</a></code> content
attribute.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="text-level-semantics.html#htmlbrelement">HTMLBRElement</a> {
+ <hr/><pre class="idl">partial interface <a href="text-level-semantics.html#htmlbrelement">HTMLBRElement</a> {
attribute DOMString <a href="#dom-br-clear" title="dom-br-clear">clear</a>;
};</pre>
@@ -1193,8 +1205,7 @@
attribute of the <code><a href="text-level-semantics.html#the-br-element">br</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="tabular-data.html#htmltablecaptionelement">HTMLTableCaptionElement</a> {
+ <hr/><pre class="idl">partial interface <a href="tabular-data.html#htmltablecaptionelement">HTMLTableCaptionElement</a> {
attribute DOMString <a href="#dom-caption-align" title="dom-caption-align">align</a>;
};</pre>
@@ -1202,8 +1213,7 @@
attribute of the <code><a href="tabular-data.html#the-caption-element">caption</a></code> element must
<a href="common-dom-interfaces.html#reflect">reflect</a> the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="tabular-data.html#htmltablecolelement">HTMLTableColElement</a> {
+ <hr/><pre class="idl">partial interface <a href="tabular-data.html#htmltablecolelement">HTMLTableColElement</a> {
attribute DOMString <a href="#dom-col-align" title="dom-col-align">align</a>;
attribute DOMString <a href="#dom-col-ch" title="dom-col-ch">ch</a>;
attribute DOMString <a href="#dom-col-choff" title="dom-col-chOff">chOff</a>;
@@ -1245,8 +1255,7 @@
attribute of the <code><a href="#dir">dir</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="grouping-content.html#htmldivelement">HTMLDivElement</a> {
+ <hr/><pre class="idl">partial interface <a href="grouping-content.html#htmldivelement">HTMLDivElement</a> {
attribute DOMString <a href="#dom-div-align" title="dom-div-align">align</a>;
};</pre>
@@ -1254,8 +1263,7 @@
attribute of the <code><a href="grouping-content.html#the-div-element">div</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="grouping-content.html#htmldlistelement">HTMLDListElement</a> {
+ <hr/><pre class="idl">partial interface <a href="grouping-content.html#htmldlistelement">HTMLDListElement</a> {
attribute boolean <a href="#dom-dl-compact" title="dom-dl-compact">compact</a>;
};</pre>
@@ -1263,8 +1271,7 @@
attribute of the <code><a href="grouping-content.html#the-dl-element">dl</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="the-iframe-element.html#htmlembedelement">HTMLEmbedElement</a> {
+ <hr/><pre class="idl">partial interface <a href="the-iframe-element.html#htmlembedelement">HTMLEmbedElement</a> {
attribute DOMString <a href="#dom-embed-align" title="dom-embed-align">align</a>;
attribute DOMString <a href="#dom-embed-name" title="dom-embed-name">name</a>;
};</pre>
@@ -1287,8 +1294,7 @@
the <code><a href="#font">font</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a> the
respective content attributes of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="sections.html#htmlheadingelement">HTMLHeadingElement</a> {
+ <hr/><pre class="idl">partial interface <a href="sections.html#htmlheadingelement">HTMLHeadingElement</a> {
attribute DOMString <a href="#dom-hx-align" title="dom-hx-align">align</a>;
};</pre>
@@ -1303,8 +1309,7 @@
this attribute. (It is mentioned here as it was defined in a
previous version of the DOM specifications.)</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="grouping-content.html#htmlhrelement">HTMLHRElement</a> {
+ <hr/><pre class="idl">partial interface <a href="grouping-content.html#htmlhrelement">HTMLHRElement</a> {
attribute DOMString <a href="#dom-hr-align" title="dom-hr-align">align</a>;
attribute DOMString <a href="#dom-hr-color" title="dom-hr-color">color</a>;
attribute boolean <a href="#dom-hr-noshade" title="dom-hr-noShade">noShade</a>;
@@ -1321,8 +1326,7 @@
the element's <code title="attr-input-noshade">noshade</code>
content attribute.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="semantics.html#htmlhtmlelement">HTMLHtmlElement</a> {
+ <hr/><pre class="idl">partial interface <a href="semantics.html#htmlhtmlelement">HTMLHtmlElement</a> {
attribute DOMString <a href="#dom-html-version" title="dom-html-version">version</a>;
};</pre>
@@ -1330,8 +1334,7 @@
attribute of the <code><a href="semantics.html#the-html-element">html</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="the-iframe-element.html#htmliframeelement">HTMLIFrameElement</a> {
+ <hr/><pre class="idl">partial interface <a href="the-iframe-element.html#htmliframeelement">HTMLIFrameElement</a> {
attribute DOMString <a href="#dom-iframe-align" title="dom-iframe-align">align</a>;
attribute DOMString <a href="#dom-iframe-frameborder" title="dom-iframe-frameBorder">frameBorder</a>;
attribute DOMString <a href="#dom-iframe-longdesc" title="dom-iframe-longDesc">longDesc</a>;
@@ -1367,8 +1370,7 @@
<a href="common-dom-interfaces.html#reflect">reflect</a> the element's <code title="attr-iframe-marginwidth"><a href="#attr-iframe-marginwidth">marginwidth</a></code> content
attribute.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="embedded-content-1.html#htmlimageelement">HTMLImageElement</a> {
+ <hr/><pre class="idl">partial interface <a href="embedded-content-1.html#htmlimageelement">HTMLImageElement</a> {
attribute DOMString <a href="#dom-img-name" title="dom-img-name">name</a>;
attribute DOMString <a href="#dom-img-align" title="dom-img-align">align</a>;
attribute DOMString <a href="#dom-img-border" title="dom-img-border">border</a>;
@@ -1389,8 +1391,7 @@
- <hr/><pre class="idl">[Supplemental]
-interface <a href="the-input-element.html#htmlinputelement">HTMLInputElement</a> {
+ <hr/><pre class="idl">partial interface <a href="the-input-element.html#htmlinputelement">HTMLInputElement</a> {
attribute DOMString <a href="#dom-input-align" title="dom-input-align">align</a>;
attribute DOMString <a href="#dom-input-usemap" title="dom-input-useMap">useMap</a>;
};</pre>
@@ -1403,8 +1404,7 @@
attribute of the <code><a href="the-input-element.html#the-input-element">input</a></code> element must
<a href="common-dom-interfaces.html#reflect">reflect</a> the element's <code title="attr-input-usemap"><a href="#attr-input-usemap">usemap</a></code> content attribute.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="forms.html#htmllegendelement">HTMLLegendElement</a> {
+ <hr/><pre class="idl">partial interface <a href="forms.html#htmllegendelement">HTMLLegendElement</a> {
attribute DOMString <a href="#dom-legend-align" title="dom-legend-align">align</a>;
};</pre>
@@ -1412,8 +1412,7 @@
attribute of the <code><a href="forms.html#the-legend-element">legend</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="grouping-content.html#htmllielement">HTMLLIElement</a> {
+ <hr/><pre class="idl">partial interface <a href="grouping-content.html#htmllielement">HTMLLIElement</a> {
attribute DOMString <a href="#dom-li-type" title="dom-li-type">type</a>;
};</pre>
@@ -1421,8 +1420,7 @@
attribute of the <code><a href="grouping-content.html#the-li-element">li</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="semantics.html#htmllinkelement">HTMLLinkElement</a> {
+ <hr/><pre class="idl">partial interface <a href="semantics.html#htmllinkelement">HTMLLinkElement</a> {
attribute DOMString <a href="#dom-link-charset" title="dom-link-charset">charset</a>;
attribute DOMString <a href="#dom-link-rev" title="dom-link-rev">rev</a>;
attribute DOMString <a href="#dom-link-target" title="dom-link-target">target</a>;
@@ -1437,8 +1435,7 @@
equivalent to <code><a href="grouping-content.html#the-pre-element">pre</a></code> elements in terms of semantics and
for purposes of rendering.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="interactive-elements.html#htmlmenuelement">HTMLMenuElement</a> {
+ <hr/><pre class="idl">partial interface <a href="interactive-elements.html#htmlmenuelement">HTMLMenuElement</a> {
attribute boolean <a href="#dom-menu-compact" title="dom-menu-compact">compact</a>;
};</pre>
@@ -1446,8 +1443,7 @@
attribute of the <code><a href="interactive-elements.html#the-menu-element">menu</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="semantics.html#htmlmetaelement">HTMLMetaElement</a> {
+ <hr/><pre class="idl">partial interface <a href="semantics.html#htmlmetaelement">HTMLMetaElement</a> {
attribute DOMString <a href="#dom-meta-scheme" title="dom-meta-scheme">scheme</a>;
};</pre>
@@ -1489,8 +1485,7 @@
attribute of the <code><a href="semantics.html#the-meta-element">meta</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="the-iframe-element.html#htmlobjectelement">HTMLObjectElement</a> {
+ <hr/><pre class="idl">partial interface <a href="the-iframe-element.html#htmlobjectelement">HTMLObjectElement</a> {
attribute DOMString <a href="#dom-object-align" title="dom-object-align">align</a>;
attribute DOMString <a href="#dom-object-archive" title="dom-object-archive">archive</a>;
attribute DOMString <a href="#dom-object-border" title="dom-object-border">border</a>;
@@ -1518,8 +1513,7 @@
the element's <code title="attr-object-codetype"><a href="#attr-object-codetype">codetype</a></code> content
attribute.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="grouping-content.html#htmlolistelement">HTMLOListElement</a> {
+ <hr/><pre class="idl">partial interface <a href="grouping-content.html#htmlolistelement">HTMLOListElement</a> {
attribute boolean <a href="#dom-ol-compact" title="dom-ol-compact">compact</a>;
};</pre>
@@ -1527,8 +1521,7 @@
attribute of the <code><a href="grouping-content.html#the-ol-element">ol</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="grouping-content.html#htmlparagraphelement">HTMLParagraphElement</a> {
+ <hr/><pre class="idl">partial interface <a href="grouping-content.html#htmlparagraphelement">HTMLParagraphElement</a> {
attribute DOMString <a href="#dom-p-align" title="dom-p-align">align</a>;
};</pre>
@@ -1536,8 +1529,7 @@
attribute of the <code><a href="grouping-content.html#the-p-element">p</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="the-iframe-element.html#htmlparamelement">HTMLParamElement</a> {
+ <hr/><pre class="idl">partial interface <a href="the-iframe-element.html#htmlparamelement">HTMLParamElement</a> {
attribute DOMString <a href="#dom-param-type" title="dom-param-type">type</a>;
attribute DOMString <a href="#dom-param-valuetype" title="dom-param-valueType">valueType</a>;
};</pre>
@@ -1555,8 +1547,7 @@
and for purposes of rendering. (The parser has special behavior for
this element, though.)</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="grouping-content.html#htmlpreelement">HTMLPreElement</a> {
+ <hr/><pre class="idl">partial interface <a href="grouping-content.html#htmlpreelement">HTMLPreElement</a> {
attribute unsigned long <a href="#dom-pre-width" title="dom-pre-width">width</a>;
};</pre>
@@ -1564,8 +1555,7 @@
attribute of the <code><a href="grouping-content.html#the-pre-element">pre</a></code> element must <a href="common-dom-interfaces.html#reflect">reflect</a>
the content attribute of the same name.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="scripting-1.html#htmlscriptelement">HTMLScriptElement</a> {
+ <hr/><pre class="idl">partial interface <a href="scripting-1.html#htmlscriptelement">HTMLScriptElement</a> {
attribute DOMString <a href="#dom-script-event" title="dom-script-event">event</a>;
attribute DOMString <a href="#dom-script-htmlfor" title="dom-script-htmlFor">htmlFor</a>;
};</pre>
@@ -1575,8 +1565,7 @@
attributes of the <code><a href="scripting-1.html#the-script-element">script</a></code> element must return the empty
string on getting, and do nothing on setting.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="tabular-data.html#htmltableelement">HTMLTableElement</a> {
+ <hr/><pre class="idl">partial interface <a href="tabular-data.html#htmltableelement">HTMLTableElement</a> {
attribute DOMString <a href="#dom-table-align" title="dom-table-align">align</a>;
attribute DOMString <a href="#dom-table-bgcolor" title="dom-table-bgColor">bgColor</a>;
attribute DOMString <a href="#dom-table-cellpadding" title="dom-table-cellPadding">cellPadding</a>;
@@ -1606,8 +1595,7 @@
the element's <code title="attr-table-cellspacing"><a href="#attr-table-cellspacing">cellspacing</a></code> content
attribute.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="tabular-data.html#htmltablesectionelement">HTMLTableSectionElement</a> {
+ <hr/><pre class="idl">partial interface <a href="tabular-data.html#htmltablesectionelement">HTMLTableSectionElement</a> {
attribute DOMString <a href="#dom-tbody-align" title="dom-tbody-align">align</a>;
attribute DOMString <a href="#dom-tbody-ch" title="dom-tbody-ch">ch</a>;
attribute DOMString <a href="#dom-tbody-choff" title="dom-tbody-chOff">chOff</a>;
@@ -1635,8 +1623,7 @@
<code title="attr-tbody-valign"><a href="#attr-tbody-valign">valign</a></code> content
attributes.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="tabular-data.html#htmltablecellelement">HTMLTableCellElement</a> {
+ <hr/><pre class="idl">partial interface <a href="tabular-data.html#htmltablecellelement">HTMLTableCellElement</a> {
attribute DOMString <a href="#dom-tdth-abbr" title="dom-tdth-abbr">abbr</a>;
attribute DOMString <a href="#dom-tdth-align" title="dom-tdth-align">align</a>;
attribute DOMString <a href="#dom-tdth-axis" title="dom-tdth-axis">axis</a>;
@@ -1674,8 +1661,7 @@
attribute of the <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> element must
<a href="common-dom-interfaces.html#reflect">reflect</a> the elements' <code title="attr-tdth-valign"><a href="#attr-tdth-valign">valign</a></code> content attributes.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="tabular-data.html#htmltablerowelement">HTMLTableRowElement</a> {
+ <hr/><pre class="idl">partial interface <a href="tabular-data.html#htmltablerowelement">HTMLTableRowElement</a> {
attribute DOMString <a href="#dom-tr-align" title="dom-tr-align">align</a>;
attribute DOMString <a href="#dom-tr-bgcolor" title="dom-tr-bgColor">bgColor</a>;
attribute DOMString <a href="#dom-tr-ch" title="dom-tr-ch">ch</a>;
@@ -1706,8 +1692,7 @@
the element's <code title="attr-tr-valign"><a href="#attr-tr-valign">valign</a></code> content
attribute.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="grouping-content.html#htmlulistelement">HTMLUListElement</a> {
+ <hr/><pre class="idl">partial interface <a href="grouping-content.html#htmlulistelement">HTMLUListElement</a> {
attribute boolean <a href="#dom-ul-compact" title="dom-ul-compact">compact</a>;
attribute DOMString <a href="#dom-ul-type" title="dom-ul-type">type</a>;
};</pre>
@@ -1726,16 +1711,15 @@
<code><a href="#multicol">multicol</a></code>, <code><a href="#nextid">nextid</a></code>, <code><a href="#rb">rb</a></code>, and
<code><a href="#spacer">spacer</a></code> elements must use the
<code><a href="elements.html#htmlunknownelement">HTMLUnknownElement</a></code> interface.</p>
- <hr/><pre class="idl">[Supplemental]
-interface <a href="dom.html#htmldocument">HTMLDocument</a> {
+ <hr/><pre class="idl">partial interface <a href="dom.html#htmldocument">HTMLDocument</a> {
attribute DOMString <a href="#dom-document-fgcolor" title="dom-document-fgColor">fgColor</a>;
attribute DOMString <a href="#dom-document-bgcolor" title="dom-document-bgColor">bgColor</a>;
attribute DOMString <a href="#dom-document-linkcolor" title="dom-document-linkColor">linkColor</a>;
attribute DOMString <a href="#dom-document-vlinkcolor" title="dom-document-vlinkColor">vlinkColor</a>;
attribute DOMString <a href="#dom-document-alinkcolor" title="dom-document-alinkColor">alinkColor</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-anchors" title="dom-document-anchors">anchors</a>;
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-applets" title="dom-document-applets">applets</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-anchors" title="dom-document-anchors">anchors</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-applets" title="dom-document-applets">applets</a>;
void <a href="#dom-document-clear" title="dom-document-clear">clear</a>();
@@ -1765,13 +1749,13 @@
</td></tr><tr><td><dfn id="dom-document-alinkcolor" title="dom-document-alinkColor"><code>alinkColor</code></dfn>
</td><td><code title="attr-body-alink"><a href="#attr-body-alink">alink</a></code>
</td></tr></tbody></table><hr/><p>The <dfn id="dom-document-anchors" title="dom-document-anchors"><code>anchors</code></dfn>
- attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only <code><a href="text-level-semantics.html#the-a-element">a</a></code>
elements with <code title="attr-a-name"><a href="#attr-a-name">name</a></code>
attributes.</p>
<p>The <dfn id="dom-document-applets" title="dom-document-applets"><code>applets</code></dfn>
- attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the
+ attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the
<code><a href="infrastructure.html#document">Document</a></code> node, whose filter matches only
<code><a href="#the-applet-element">applet</a></code> elements.</p>
@@ -1797,7 +1781,7 @@
</ul><p class="note">These requirements are a <a href="introduction.html#willful-violation">willful
violation</a> of the JavaScript specification current at the time
- of writing (ECMAScript edition 3). The JavaScript specification
+ of writing (ECMAScript edition 5). The JavaScript specification
requires that the ToBoolean() operator convert all objects to the
true value, and does not have provisions for objects acting as if
they were <code title="">undefined</code> for the purposes of
Index: toc-status.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/toc-status.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- toc-status.html 17 Jun 2011 08:49:08 -0000 1.12
+++ toc-status.html 24 Aug 2011 07:56:05 -0000 1.13
@@ -57,7 +57,12 @@
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=how-to-read-this-specification" class="status LC">LC</a> <a href="../spec/#how-to-read-this-specification">1.7.1 How to read this specification</a> <span class="id">(how-to-read-this-specification)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=typographic-conventions" class="status LC">LC</a> <a href="../spec/#typographic-conventions">1.7.2 Typographic conventions</a> <span class="id">(typographic-conventions)</span></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=a-quick-introduction-to-html" class="status LC">LC</a> <a href="../spec/#a-quick-introduction-to-html">1.8 A quick introduction to HTML</a> <span class="id">(a-quick-introduction-to-html)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=a-quick-introduction-to-html" class="status LC">LC</a> <a href="../spec/#a-quick-introduction-to-html">1.8 A quick introduction to HTML</a> <span class="id">(a-quick-introduction-to-html)</span>
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=writing-secure-applications-with-html" class="status ADD">ADD</a> <a href="../spec/#writing-secure-applications-with-html">1.8.1 Writing secure applications with HTML</a> <span class="id">(writing-secure-applications-with-html)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=common-pitfalls-to-avoid-when-using-the-scripting-apis" class="status ADD">ADD</a> <a href="../spec/#common-pitfalls-to-avoid-when-using-the-scripting-apis">
+1.8.2 Common pitfalls to avoid when using the scripting
+APIs</a> <span class="id">(common-pitfalls-to-avoid-when-using-the-scripting-apis)</span></li>
+</ol></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=conformance-requirements-for-authors" class="status ADD">ADD</a> <a href="../spec/#conformance-requirements-for-authors">1.9 Conformance requirements for authors</a> <span class="id">(conformance-requirements-for-authors)</span>
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=presentational-markup" class="status ADD">ADD</a> <a href="../spec/#presentational-markup">1.9.1 Presentational markup</a> <span class="id">(presentational-markup)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=syntax-errors" class="status ADD">ADD</a> <a href="../spec/#syntax-errors">1.9.2
@@ -105,8 +110,7 @@
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=non-negative-integers" class="status LC">LC</a> <a href="../spec/#non-negative-integers">2.5.4.1 Non-negative integers</a> <span class="id">(non-negative-integers)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=signed-integers" class="status LC">LC</a> <a href="../spec/#signed-integers">2.5.4.2
Signed integers</a> <span class="id">(signed-integers)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=real-numbers" class="status LC">LC</a> <a href="../spec/#real-numbers">2.5.4.3 Real
-numbers</a> <span class="id">(real-numbers)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=floating-point-numbers" class="status ADD">ADD</a> <a href="../spec/#floating-point-numbers">2.5.4.3 Floating-point numbers</a> <span class="id">(floating-point-numbers)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=percentages-and-dimensions" class="status LC">LC</a> <a href="../spec/#percentages-and-dimensions">2.5.4.4 Percentages and lengths</a> <span class="id">(percentages-and-dimensions)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=lists-of-integers" class="status LC">LC</a> <a href="../spec/#lists-of-integers">2.5.4.5
Lists of integers</a> <span class="id">(lists-of-integers)</span></li>
@@ -164,23 +168,17 @@
attributes</a> <span class="id">(reflecting-content-attributes-in-idl-attributes)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=collections-0" class="status LC">LC</a> <a href="../spec/#collections-0">2.8.2
Collections</a> <span class="id">(collections-0)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=htmlcollection-0" class="status LC">LC</a> <a href="../spec/#htmlcollection-0">2.8.2.1
-HTMLCollection</a> <span class="id">(htmlcollection-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=htmlallcollection-0" class="status LC">LC</a> <a href="../spec/#htmlallcollection-0">2.8.2.2 HTMLAllCollection</a> <span class="id">(htmlallcollection-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=htmlformcontrolscollection-0" class="status LC">LC</a> <a href="../spec/#htmlformcontrolscollection-0">2.8.2.3 HTMLFormControlsCollection</a> <span class="id">(htmlformcontrolscollection-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=htmloptionscollection-0" class="status LC">LC</a> <a href="../spec/#htmloptionscollection-0">2.8.2.4 HTMLOptionsCollection</a> <span class="id">(htmloptionscollection-0)</span></li>
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=htmlallcollection-0" class="status LC">LC</a> <a href="../spec/#htmlallcollection-0">2.8.2.1 HTMLAllCollection</a> <span class="id">(htmlallcollection-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=htmlformcontrolscollection-0" class="status LC">LC</a> <a href="../spec/#htmlformcontrolscollection-0">2.8.2.2 HTMLFormControlsCollection</a> <span class="id">(htmlformcontrolscollection-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=htmloptionscollection-0" class="status LC">LC</a> <a href="../spec/#htmloptionscollection-0">2.8.2.3 HTMLOptionsCollection</a> <span class="id">(htmloptionscollection-0)</span></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=domtokenlist-0" class="status LC">LC</a> <a href="../spec/#domtokenlist-0">2.8.3
-DOMTokenList</a> <span class="id">(domtokenlist-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=domsettabletokenlist-0" class="status LC">LC</a> <a href="../spec/#domsettabletokenlist-0">2.8.4 DOMSettableTokenList</a> <span class="id">(domsettabletokenlist-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=safe-passing-of-structured-data" class="status LC">LC</a> <a href="../spec/#safe-passing-of-structured-data">2.8.5 Safe passing of structured data</a> <span class="id">(safe-passing-of-structured-data)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=domstringmap-0" class="status LC">LC</a> <a href="../spec/#domstringmap-0">2.8.6
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=domstringmap-0" class="status LC">LC</a> <a href="../spec/#domstringmap-0">2.8.3
DOMStringMap</a> <span class="id">(domstringmap-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=dom-feature-strings" class="status LC">LC</a> <a href="../spec/#dom-feature-strings">2.8.7
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=transferable-objects" class="status ADD">ADD</a> <a href="../spec/#transferable-objects">2.8.4 Transferable objects</a> <span class="id">(transferable-objects)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=safe-passing-of-structured-data" class="status LC">LC</a> <a href="../spec/#safe-passing-of-structured-data">2.8.5 Safe passing of structured data</a> <span class="id">(safe-passing-of-structured-data)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=dom-feature-strings" class="status LC">LC</a> <a href="../spec/#dom-feature-strings">2.8.6
DOM feature strings</a> <span class="id">(dom-feature-strings)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=exceptions" class="status LC">LC</a> <a href="../spec/#exceptions">2.8.8
-Exceptions</a> <span class="id">(exceptions)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=garbage-collection" class="status LC">LC</a> <a href="../spec/#garbage-collection">2.8.9
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=garbage-collection" class="status LC">LC</a> <a href="../spec/#garbage-collection">2.8.7
Garbage collection</a> <span class="id">(garbage-collection)</span></li>
</ol></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=namespaces" class="status LC">LC</a> <a href="../spec/#namespaces">2.9
@@ -196,9 +194,7 @@
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=resource-metadata-management" class="status LC">LC</a> <a href="../spec/#resource-metadata-management">3.1.3 Resource metadata management</a> <span class="id">(resource-metadata-management)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=dom-tree-accessors" class="status LC">LC</a> <a href="../spec/#dom-tree-accessors">3.1.4
DOM tree accessors</a> <span class="id">(dom-tree-accessors)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=creating-documents" class="status REC">REC</a> <a href="../spec/#creating-documents">3.1.5
-Creating documents</a> <span class="id">(creating-documents)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=loading-xml-documents" class="status LC">LC</a> <a href="../spec/#loading-xml-documents">3.1.6 Loading XML documents</a> <span class="id">(loading-xml-documents)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=loading-xml-documents" class="status LC">LC</a> <a href="../spec/#loading-xml-documents">3.1.5 Loading XML documents</a> <span class="id">(loading-xml-documents)</span></li>
</ol></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=elements" class="status LC">LC</a> <a href="../spec/#elements">3.2 Elements</a> <span class="id">(elements)</span>
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=semantics-0" class="status LC">LC</a> <a href="../spec/#semantics-0">3.2.1
@@ -251,20 +247,19 @@
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=wai-aria" class="status ADD">ADD</a> <a href="../spec/#wai-aria">3.2.7
WAI-ARIA</a> <span class="id">(wai-aria)</span></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=apis-in-html-documents" class="status LC">LC</a> <a href="../spec/#apis-in-html-documents">3.3 APIs in HTML documents</a> <span class="id">(apis-in-html-documents)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=interactions-with-xpath-and-xslt" class="status LC">LC</a> <a href="../spec/#interactions-with-xpath-and-xslt">3.4 Interactions with XPath and XSLT</a> <span class="id">(interactions-with-xpath-and-xslt)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=dynamic-markup-insertion" class="status LC">LC</a> <a href="../spec/#dynamic-markup-insertion">3.5 Dynamic markup insertion</a> <span class="id">(dynamic-markup-insertion)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=opening-the-input-stream" class="status LC">LC</a> <a href="../spec/#opening-the-input-stream">3.5.1 Opening the input stream</a> <span class="id">(opening-the-input-stream)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=closing-the-input-stream" class="status LC">LC</a> <a href="../spec/#closing-the-input-stream">3.5.2 Closing the input stream</a> <span class="id">(closing-the-input-stream)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=document.write" class="status ADD">ADD</a> <a href="../spec/#document.write">3.5.3
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=interactions-with-xpath-and-xslt" class="status LC">LC</a> <a href="../spec/#interactions-with-xpath-and-xslt">3.3 Interactions with XPath and XSLT</a> <span class="id">(interactions-with-xpath-and-xslt)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=dynamic-markup-insertion" class="status LC">LC</a> <a href="../spec/#dynamic-markup-insertion">3.4 Dynamic markup insertion</a> <span class="id">(dynamic-markup-insertion)</span>
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=opening-the-input-stream" class="status LC">LC</a> <a href="../spec/#opening-the-input-stream">3.4.1 Opening the input stream</a> <span class="id">(opening-the-input-stream)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=closing-the-input-stream" class="status LC">LC</a> <a href="../spec/#closing-the-input-stream">3.4.2 Closing the input stream</a> <span class="id">(closing-the-input-stream)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=document.write" class="status ADD">ADD</a> <a href="../spec/#document.write">3.4.3
document.write()</a> <span class="id">(document.write)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=document.writeln" class="status ADD">ADD</a> <a href="../spec/#document.writeln">3.5.4
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=document.writeln" class="status ADD">ADD</a> <a href="../spec/#document.writeln">3.4.4
document.writeln()</a> <span class="id">(document.writeln)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=innerhtml" class="status LC">LC</a> <a href="../spec/#innerhtml">3.5.5
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=innerhtml" class="status REC">REC</a> <a href="../spec/#innerhtml">3.4.5
innerHTML</a> <span class="id">(innerhtml)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=outerhtml" class="status LC">LC</a> <a href="../spec/#outerhtml">3.5.6
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=outerhtml" class="status LC">LC</a> <a href="../spec/#outerhtml">3.4.6
outerHTML</a> <span class="id">(outerhtml)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=insertadjacenthtml" class="status ADD">ADD</a> <a href="../spec/#insertadjacenthtml">3.5.7
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=insertadjacenthtml" class="status ADD">ADD</a> <a href="../spec/#insertadjacenthtml">3.4.7
insertAdjacentHTML()</a> <span class="id">(insertadjacenthtml)</span></li>
</ol></li>
</ol></li>
@@ -285,7 +280,7 @@
The base element</a> <span class="id">(the-base-element)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-link-element" class="status LC">LC</a> <a href="../spec/#the-link-element">4.2.4
The link element</a> <span class="id">(the-link-element)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-meta-element" class="status ADD">ADD</a> <a href="../spec/#the-meta-element">4.2.5
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-meta-element" class="status LC">LC</a> <a href="../spec/#the-meta-element">4.2.5
The meta element</a> <span class="id">(the-meta-element)</span>
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=standard-metadata-names" class="status LC">LC</a> <a href="../spec/#standard-metadata-names">4.2.5.1 Standard metadata names</a> <span class="id">(standard-metadata-names)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=other-metadata-names" class="status LC">LC</a> <a href="../spec/#other-metadata-names">4.2.5.2 Other metadata names</a> <span class="id">(other-metadata-names)</span></li>
@@ -403,7 +398,7 @@
i element</a> <span class="id">(the-i-element)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-b-element" class="status REC">REC</a> <a href="../spec/#the-b-element">4.6.17 The
b element</a> <span class="id">(the-b-element)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-u-element" class="status ADD">ADD</a> <a href="../spec/#the-u-element">4.6.18 The
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-u-element" class="status UNKNOWN">UNKNOWN</a> <a href="../spec/#the-u-element">4.6.18 The
u element</a> <span class="id">(the-u-element)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-mark-element" class="status LC">LC</a> <a href="../spec/#the-mark-element">4.6.19
The mark element</a> <span class="id">(the-mark-element)</span></li>
@@ -484,9 +479,9 @@
The object element</a> <span class="id">(the-object-element)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-param-element" class="status REC">REC</a> <a href="../spec/#the-param-element">4.8.5
The param element</a> <span class="id">(the-param-element)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-video-element" class="status ADD">ADD</a> <a href="../spec/#the-video-element">4.8.6
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-video-element" class="status LC">LC</a> <a href="../spec/#the-video-element">4.8.6
The video element</a> <span class="id">(the-video-element)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-audio-element" class="status ADD">ADD</a> <a href="../spec/#the-audio-element">4.8.7
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-audio-element" class="status LC">LC</a> <a href="../spec/#the-audio-element">4.8.7
The audio element</a> <span class="id">(the-audio-element)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-source-element" class="status LC">LC</a> <a href="../spec/#the-source-element">4.8.8
The source element</a> <span class="id">(the-source-element)</span></li>
@@ -510,7 +505,8 @@
Seeking</a> <span class="id">(seeking)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=media-resources-with-multiple-media-tracks" class="status FD">FD</a> <a href="../spec/#media-resources-with-multiple-media-tracks">4.8.10.10 Media resources with multiple media
tracks</a> <span class="id">(media-resources-with-multiple-media-tracks)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=tracklist-objects" class="status ADD">ADD</a> <a href="../spec/#tracklist-objects">4.8.10.10.1 TrackList objects</a> <span class="id">(tracklist-objects)</span></li>
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=audiotracklist-and-videotracklist-objects" class="status FD">FD</a> <a href="../spec/#audiotracklist-and-videotracklist-objects">4.8.10.10.1 AudioTrackList and
+VideoTrackList objects</a> <span class="id">(audiotracklist-and-videotracklist-objects)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=selecting-specific-audio-and-video-tracks-declaratively" class="status ADD">ADD</a> <a href="../spec/#selecting-specific-audio-and-video-tracks-declaratively">
4.8.10.10.2 Selecting specific audio and video tracks
declaratively</a> <span class="id">(selecting-specific-audio-and-video-tracks-declaratively)</span></li>
@@ -527,7 +523,8 @@
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=sourcing-out-of-band-text-tracks" class="status WD">WD</a> <a href="../spec/#sourcing-out-of-band-text-tracks">4.8.10.12.3 Sourcing out-of-band text
tracks</a> <span class="id">(sourcing-out-of-band-text-tracks)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=text-track-api" class="status WD">WD</a> <a href="../spec/#text-track-api">4.8.10.12.4 Text track API</a> <span class="id">(text-track-api)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=cue-events" class="status WD">WD</a> <a href="../spec/#cue-events">4.8.10.12.5
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=text-tracks-describing-chapters" class="status ADD">ADD</a> <a href="../spec/#text-tracks-describing-chapters">4.8.10.12.5 Text tracks describing chapters</a> <span class="id">(text-tracks-describing-chapters)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=cue-events" class="status WD">WD</a> <a href="../spec/#cue-events">4.8.10.12.6
Event definitions</a> <span class="id">(cue-events)</span></li>
</ol></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=user-interface" class="status LC">LC</a> <a href="../spec/#user-interface">4.8.10.13
@@ -623,15 +620,15 @@
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element" class="status LC">LC</a> <a href="../spec/#the-input-element">4.10.7
The input element</a> <span class="id">(the-input-element)</span>
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=states-of-the-type-attribute" class="status LC">LC</a> <a href="../spec/#states-of-the-type-attribute">4.10.7.1 States of the type attribute</a> <span class="id">(states-of-the-type-attribute)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=hidden-state" class="status LC">LC</a> <a href="../spec/#hidden-state">4.10.7.1.1
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=hidden-state" class="status REC">REC</a> <a href="../spec/#hidden-state">4.10.7.1.1
Hidden state</a> <span class="id">(hidden-state)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=text-state-and-search-state" class="status LC">LC</a> <a href="../spec/#text-state-and-search-state">4.10.7.1.2 Text state and Search state</a> <span class="id">(text-state-and-search-state)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=text-state-and-search-state" class="status CR">CR</a> <a href="../spec/#text-state-and-search-state">4.10.7.1.2 Text state and Search state</a> <span class="id">(text-state-and-search-state)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=telephone-state" class="status LC">LC</a> <a href="../spec/#telephone-state">4.10.7.1.3 Telephone state</a> <span class="id">(telephone-state)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=url-state" class="status LC">LC</a> <a href="../spec/#url-state">4.10.7.1.4 URL
state</a> <span class="id">(url-state)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=e-mail-state" class="status LC">LC</a> <a href="../spec/#e-mail-state">4.10.7.1.5
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=e-mail-state" class="status CR">CR</a> <a href="../spec/#e-mail-state">4.10.7.1.5
E-mail state</a> <span class="id">(e-mail-state)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=password-state" class="status LC">LC</a> <a href="../spec/#password-state">4.10.7.1.6
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=password-state" class="status REC">REC</a> <a href="../spec/#password-state">4.10.7.1.6
Password state</a> <span class="id">(password-state)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=date-and-time-state" class="status LC">LC</a> <a href="../spec/#date-and-time-state">4.10.7.1.7 Date and Time state</a> <span class="id">(date-and-time-state)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=date-state" class="status LC">LC</a> <a href="../spec/#date-state">4.10.7.1.8
@@ -645,9 +642,9 @@
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=local-date-and-time-state" class="status LC">LC</a> <a href="../spec/#local-date-and-time-state">4.10.7.1.12 Local Date and Time state</a> <span class="id">(local-date-and-time-state)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=number-state" class="status LC">LC</a> <a href="../spec/#number-state">4.10.7.1.13
Number state</a> <span class="id">(number-state)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=range-state" class="status LC">LC</a> <a href="../spec/#range-state">4.10.7.1.14
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=range-state" class="status CR">CR</a> <a href="../spec/#range-state">4.10.7.1.14
Range state</a> <span class="id">(range-state)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=color-state" class="status LC">LC</a> <a href="../spec/#color-state">4.10.7.1.15
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=color-state" class="status CR">CR</a> <a href="../spec/#color-state">4.10.7.1.15
Color state</a> <span class="id">(color-state)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=checkbox-state" class="status LC">LC</a> <a href="../spec/#checkbox-state">4.10.7.1.16 Checkbox state</a> <span class="id">(checkbox-state)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=radio-button-state" class="status LC">LC</a> <a href="../spec/#radio-button-state">4.10.7.1.17 Radio Button state</a> <span class="id">(radio-button-state)</span></li>
@@ -729,8 +726,8 @@
Interactive elements</a> <span class="id">(interactive-elements)</span>
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-details-element" class="status LC">LC</a> <a href="../spec/#the-details-element">4.11.1 The details element</a> <span class="id">(the-details-element)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-summary-element" class="status ADD">ADD</a> <a href="../spec/#the-summary-element">4.11.2 The summary element</a> <span class="id">(the-summary-element)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-command-element" class="status ADD">ADD</a> <a href="../spec/#the-command-element">4.11.3 The command element</a> <span class="id">(the-command-element)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-menu-element" class="status ADD">ADD</a> <a href="../spec/#the-menu-element">4.11.4
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-command-element" class="status LC">LC</a> <a href="../spec/#the-command-element">4.11.3 The command element</a> <span class="id">(the-command-element)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-menu-element" class="status LC">LC</a> <a href="../spec/#the-menu-element">4.11.4
The menu element</a> <span class="id">(the-menu-element)</span>
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=menus-intro" class="status LC">LC</a> <a href="../spec/#menus-intro">4.11.4.1
Introduction</a> <span class="id">(menus-intro)</span></li>
@@ -768,7 +765,7 @@
Introduction</a> <span class="id">(introduction-3)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=links-created-by-a-and-area-elements" class="status ADD">ADD</a> <a href="../spec/#links-created-by-a-and-area-elements">4.12.2 Links created by a and
area elements</a> <span class="id">(links-created-by-a-and-area-elements)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=following-hyperlinks" class="status LC">LC</a> <a href="../spec/#following-hyperlinks">4.12.3 Following hyperlinks</a> <span class="id">(following-hyperlinks)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=following-hyperlinks-0" class="status ADD">ADD</a> <a href="../spec/#following-hyperlinks-0">4.12.3 Following hyperlinks</a> <span class="id">(following-hyperlinks-0)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=linkTypes" class="status LC">LC</a> <a href="../spec/#linkTypes">4.12.4 Link
types</a> <span class="id">(linkTypes)</span>
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=rel-alternate" class="status ADD">ADD</a> <a href="../spec/#rel-alternate">4.12.4.1
@@ -776,28 +773,26 @@
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-author" class="status LC">LC</a> <a href="../spec/#link-type-author">4.12.4.2
Link type "author"</a> <span class="id">(link-type-author)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-bookmark" class="status LC">LC</a> <a href="../spec/#link-type-bookmark">4.12.4.3 Link type "bookmark"</a> <span class="id">(link-type-bookmark)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-external" class="status LC">LC</a> <a href="../spec/#link-type-external">4.12.4.4 Link type "external"</a> <span class="id">(link-type-external)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-help" class="status LC">LC</a> <a href="../spec/#link-type-help">4.12.4.5
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-help" class="status LC">LC</a> <a href="../spec/#link-type-help">4.12.4.4
Link type "help"</a> <span class="id">(link-type-help)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=rel-icon" class="status LC">LC</a> <a href="../spec/#rel-icon">4.12.4.6 Link
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=rel-icon" class="status LC">LC</a> <a href="../spec/#rel-icon">4.12.4.5 Link
type "icon"</a> <span class="id">(rel-icon)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-license" class="status LC">LC</a> <a href="../spec/#link-type-license">4.12.4.7 Link type "license"</a> <span class="id">(link-type-license)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-nofollow" class="status LC">LC</a> <a href="../spec/#link-type-nofollow">4.12.4.8 Link type "nofollow"</a> <span class="id">(link-type-nofollow)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-noreferrer" class="status LC">LC</a> <a href="../spec/#link-type-noreferrer">4.12.4.9 Link type
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-license" class="status LC">LC</a> <a href="../spec/#link-type-license">4.12.4.6 Link type "license"</a> <span class="id">(link-type-license)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-nofollow" class="status LC">LC</a> <a href="../spec/#link-type-nofollow">4.12.4.7 Link type "nofollow"</a> <span class="id">(link-type-nofollow)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-noreferrer" class="status LC">LC</a> <a href="../spec/#link-type-noreferrer">4.12.4.8 Link type
"noreferrer"</a> <span class="id">(link-type-noreferrer)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-pingback" class="status LC">LC</a> <a href="../spec/#link-type-pingback">4.12.4.10 Link type "pingback"</a> <span class="id">(link-type-pingback)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-prefetch" class="status LC">LC</a> <a href="../spec/#link-type-prefetch">4.12.4.11 Link type "prefetch"</a> <span class="id">(link-type-prefetch)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-search" class="status LC">LC</a> <a href="../spec/#link-type-search">4.12.4.12 Link type "search"</a> <span class="id">(link-type-search)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-sidebar" class="status LC">LC</a> <a href="../spec/#link-type-sidebar">4.12.4.13 Link type "sidebar"</a> <span class="id">(link-type-sidebar)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-stylesheet" class="status LC">LC</a> <a href="../spec/#link-type-stylesheet">4.12.4.14 Link type
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-pingback" class="status LC">LC</a> <a href="../spec/#link-type-pingback">4.12.4.9 Link type "pingback"</a> <span class="id">(link-type-pingback)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-prefetch" class="status LC">LC</a> <a href="../spec/#link-type-prefetch">4.12.4.10 Link type "prefetch"</a> <span class="id">(link-type-prefetch)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-search" class="status LC">LC</a> <a href="../spec/#link-type-search">4.12.4.11 Link type "search"</a> <span class="id">(link-type-search)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-stylesheet" class="status LC">LC</a> <a href="../spec/#link-type-stylesheet">4.12.4.12 Link type
"stylesheet"</a> <span class="id">(link-type-stylesheet)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-tag" class="status LC">LC</a> <a href="../spec/#link-type-tag">4.12.4.15
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-tag" class="status LC">LC</a> <a href="../spec/#link-type-tag">4.12.4.13
Link type "tag"</a> <span class="id">(link-type-tag)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=sequential-link-types" class="status LC">LC</a> <a href="../spec/#sequential-link-types">4.12.4.16 Sequential link types</a> <span class="id">(sequential-link-types)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-next" class="status LC">LC</a> <a href="../spec/#link-type-next">4.12.4.16.1 Link type "next"</a> <span class="id">(link-type-next)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-prev" class="status LC">LC</a> <a href="../spec/#link-type-prev">4.12.4.16.2 Link type "prev"</a> <span class="id">(link-type-prev)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=sequential-link-types" class="status LC">LC</a> <a href="../spec/#sequential-link-types">4.12.4.14 Sequential link types</a> <span class="id">(sequential-link-types)</span>
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-next" class="status LC">LC</a> <a href="../spec/#link-type-next">4.12.4.14.1 Link type "next"</a> <span class="id">(link-type-next)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=link-type-prev" class="status LC">LC</a> <a href="../spec/#link-type-prev">4.12.4.14.2 Link type "prev"</a> <span class="id">(link-type-prev)</span></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=other-link-types" class="status LC">LC</a> <a href="../spec/#other-link-types">4.12.4.17 Other link types</a> <span class="id">(other-link-types)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=other-link-types" class="status LC">LC</a> <a href="../spec/#other-link-types">4.12.4.15 Other link types</a> <span class="id">(other-link-types)</span></li>
</ol></li>
</ol></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=common-idioms-without-dedicated-elements" class="status LC">LC</a> <a href="../spec/#common-idioms-without-dedicated-elements">4.13
@@ -1073,7 +1068,7 @@
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=comments" class="status LC">LC</a> <a href="../spec/#comments">8.1.6
Comments</a> <span class="id">(comments)</span></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=parsing" class="status LC">LC</a> <a href="../spec/#parsing">8.2 Parsing HTML
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=parsing" class="status CR">CR</a> <a href="../spec/#parsing">8.2 Parsing HTML
documents</a> <span class="id">(parsing)</span>
<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=overview-of-the-parsing-model" class="status LC">LC</a> <a href="../spec/#overview-of-the-parsing-model">8.2.1 Overview of the parsing model</a> <span class="id">(overview-of-the-parsing-model)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-stream" class="status LC">LC</a> <a href="../spec/#the-input-stream">8.2.2
@@ -1275,88 +1270,94 @@
Introduction</a> <span class="id">(introduction-8)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-css-user-agent-style-sheet-and-presentational-hints" class="status LC">LC</a> <a href="../spec/#the-css-user-agent-style-sheet-and-presentational-hints">
10.2 The CSS user agent style sheet and presentational
-hints</a> <span class="id">(the-css-user-agent-style-sheet-and-presentational-hints)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=introduction-9" class="status WD">WD</a> <a href="../spec/#introduction-9">10.2.1
-Introduction</a> <span class="id">(introduction-9)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=display-types" class="status LC">LC</a> <a href="../spec/#display-types">10.2.2
-Display types</a> <span class="id">(display-types)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=margins-and-padding" class="status LC">LC</a> <a href="../spec/#margins-and-padding">10.2.3 Margins and padding</a> <span class="id">(margins-and-padding)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=alignment" class="status LC">LC</a> <a href="../spec/#alignment">10.2.4
-Alignment</a> <span class="id">(alignment)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=fonts-and-colors" class="status LC">LC</a> <a href="../spec/#fonts-and-colors">10.2.5
-Fonts and colors</a> <span class="id">(fonts-and-colors)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=punctuation-and-decorations" class="status LC">LC</a> <a href="../spec/#punctuation-and-decorations">10.2.6 Punctuation and decorations</a> <span class="id">(punctuation-and-decorations)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=resetting-rules-for-inherited-properties" class="status LC">LC</a> <a href="../spec/#resetting-rules-for-inherited-properties">10.2.7
-Resetting rules for inherited properties</a> <span class="id">(resetting-rules-for-inherited-properties)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-hr-element-0" class="status LC">LC</a> <a href="../spec/#the-hr-element-0">10.2.8
+hints</a> <span class="id">(the-css-user-agent-style-sheet-and-presentational-hints)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=non-replaced-elements" class="status ADD">ADD</a> <a href="../spec/#non-replaced-elements">10.3 Non-replaced elements</a> <span class="id">(non-replaced-elements)</span>
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=hidden-elements" class="status ADD">ADD</a> <a href="../spec/#hidden-elements">10.3.1
+Hidden elements</a> <span class="id">(hidden-elements)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-page" class="status ADD">ADD</a> <a href="../spec/#the-page">10.3.2 The
+page</a> <span class="id">(the-page)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=flow-content-1" class="status ADD">ADD</a> <a href="../spec/#flow-content-1">10.3.3
+Flow content</a> <span class="id">(flow-content-1)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=phrasing-content-1" class="status ADD">ADD</a> <a href="../spec/#phrasing-content-1">10.3.4
+Phrasing content</a> <span class="id">(phrasing-content-1)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=bidirectional-text" class="status ADD">ADD</a> <a href="../spec/#bidirectional-text">10.3.5
+Bidirectional text</a> <span class="id">(bidirectional-text)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=sections-and-headings" class="status ADD">ADD</a> <a href="../spec/#sections-and-headings">10.3.6 Sections and headings</a> <span class="id">(sections-and-headings)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=lists" class="status ADD">ADD</a> <a href="../spec/#lists">10.3.7
+Lists</a> <span class="id">(lists)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=tables" class="status ADD">ADD</a> <a href="../spec/#tables">10.3.8
+Tables</a> <span class="id">(tables)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=form-controls" class="status ADD">ADD</a> <a href="../spec/#form-controls">10.3.9 Form
+controls</a> <span class="id">(form-controls)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-hr-element-0" class="status LC">LC</a> <a href="../spec/#the-hr-element-0">10.3.10
The hr element</a> <span class="id">(the-hr-element-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-fieldset-element-0" class="status LC">LC</a> <a href="../spec/#the-fieldset-element-0">10.2.9 The fieldset element</a> <span class="id">(the-fieldset-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-fieldset-element-0" class="status LC">LC</a> <a href="../spec/#the-fieldset-element-0">10.3.11 The fieldset element</a> <span class="id">(the-fieldset-element-0)</span></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=replaced-elements" class="status LC">LC</a> <a href="../spec/#replaced-elements">10.3
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=replaced-elements" class="status LC">LC</a> <a href="../spec/#replaced-elements">10.4
Replaced elements</a> <span class="id">(replaced-elements)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=embedded-content-2" class="status LC">LC</a> <a href="../spec/#embedded-content-2">10.3.1
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=embedded-content-2" class="status LC">LC</a> <a href="../spec/#embedded-content-2">10.4.1
Embedded content</a> <span class="id">(embedded-content-2)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=timed-text-tracks-0" class="status ADD">ADD</a> <a href="../spec/#timed-text-tracks-0">10.3.2 Timed text tracks</a> <span class="id">(timed-text-tracks-0)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=webvtt-cue-text-rendering-rules" class="status ADD">ADD</a> <a href="../spec/#webvtt-cue-text-rendering-rules">10.3.2.1 WebVTT cue text rendering rules</a> <span class="id">(webvtt-cue-text-rendering-rules)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=applying-css-properties-to-webvtt-node-objects" class="status ADD">ADD</a> <a href="../spec/#applying-css-properties-to-webvtt-node-objects">10.3.2.2 Applying CSS properties to WebVTT Node Objects</a> <span class="id">(applying-css-properties-to-webvtt-node-objects)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=css-extensions" class="status ADD">ADD</a> <a href="../spec/#css-extensions">10.3.2.3
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=timed-text-tracks-0" class="status ADD">ADD</a> <a href="../spec/#timed-text-tracks-0">10.4.2 Timed text tracks</a> <span class="id">(timed-text-tracks-0)</span>
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=webvtt-cue-text-rendering-rules" class="status ADD">ADD</a> <a href="../spec/#webvtt-cue-text-rendering-rules">10.4.2.1 WebVTT cue text rendering rules</a> <span class="id">(webvtt-cue-text-rendering-rules)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=applying-css-properties-to-webvtt-node-objects" class="status ADD">ADD</a> <a href="../spec/#applying-css-properties-to-webvtt-node-objects">10.4.2.2 Applying CSS properties to WebVTT Node Objects</a> <span class="id">(applying-css-properties-to-webvtt-node-objects)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=css-extensions" class="status ADD">ADD</a> <a href="../spec/#css-extensions">10.4.2.3
CSS extensions</a> <span class="id">(css-extensions)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-::cue-pseudo-element" class="status ADD">ADD</a> <a href="../spec/#the-::cue-pseudo-element">10.3.2.3.1 The '::cue' pseudo-element</a> <span class="id">(the-::cue-pseudo-element)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-:past-and-:future-pseudo-classes" class="status ADD">ADD</a> <a href="../spec/#the-:past-and-:future-pseudo-classes">10.3.2.3.2 The ':past' and ':future'
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-::cue-pseudo-element" class="status ADD">ADD</a> <a href="../spec/#the-::cue-pseudo-element">10.4.2.3.1 The '::cue' pseudo-element</a> <span class="id">(the-::cue-pseudo-element)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-:past-and-:future-pseudo-classes" class="status ADD">ADD</a> <a href="../spec/#the-:past-and-:future-pseudo-classes">10.4.2.3.2 The ':past' and ':future'
pseudo-classes</a> <span class="id">(the-:past-and-:future-pseudo-classes)</span></li>
</ol></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=images" class="status LC">LC</a> <a href="../spec/#images">10.3.3
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=images" class="status LC">LC</a> <a href="../spec/#images">10.4.3
Images</a> <span class="id">(images)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=attributes-for-embedded-content-and-images" class="status LC">LC</a> <a href="../spec/#attributes-for-embedded-content-and-images">10.3.4 Attributes for embedded content and
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=attributes-for-embedded-content-and-images" class="status LC">LC</a> <a href="../spec/#attributes-for-embedded-content-and-images">10.4.4 Attributes for embedded content and
images</a> <span class="id">(attributes-for-embedded-content-and-images)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=image-maps-0" class="status LC">LC</a> <a href="../spec/#image-maps-0">10.3.5 Image
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=image-maps-0" class="status LC">LC</a> <a href="../spec/#image-maps-0">10.4.5 Image
maps</a> <span class="id">(image-maps-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=toolbars-0" class="status LC">LC</a> <a href="../spec/#toolbars-0">10.3.6
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=toolbars-0" class="status LC">LC</a> <a href="../spec/#toolbars-0">10.4.6
Toolbars</a> <span class="id">(toolbars-0)</span></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=bindings" class="status LC">LC</a> <a href="../spec/#bindings">10.4
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=bindings" class="status LC">LC</a> <a href="../spec/#bindings">10.5
Bindings</a> <span class="id">(bindings)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=introduction-10" class="status LC">LC</a> <a href="../spec/#introduction-10">10.4.1
-Introduction</a> <span class="id">(introduction-10)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-button-element-0" class="status LC">LC</a> <a href="../spec/#the-button-element-0">10.4.2 The button element</a> <span class="id">(the-button-element-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-details-element-0" class="status LC">LC</a> <a href="../spec/#the-details-element-0">10.4.3 The details element</a> <span class="id">(the-details-element-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-text-entry-widget" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-text-entry-widget">10.4.4
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=introduction-9" class="status WD">WD</a> <a href="../spec/#introduction-9">10.5.1
+Introduction</a> <span class="id">(introduction-9)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-button-element-0" class="status LC">LC</a> <a href="../spec/#the-button-element-0">10.5.2 The button element</a> <span class="id">(the-button-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-details-element-0" class="status LC">LC</a> <a href="../spec/#the-details-element-0">10.5.3 The details element</a> <span class="id">(the-details-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-text-entry-widget" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-text-entry-widget">10.5.4
The input element as a text entry widget</a> <span class="id">(the-input-element-as-a-text-entry-widget)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-domain-specific-widgets" class="status LC">LC</a> <a href="../spec/#the-input-element-as-domain-specific-widgets">10.4.5 The input element as
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-domain-specific-widgets" class="status LC">LC</a> <a href="../spec/#the-input-element-as-domain-specific-widgets">10.5.5 The input element as
domain-specific widgets</a> <span class="id">(the-input-element-as-domain-specific-widgets)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-range-control" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-range-control">10.4.6 The input element as a range
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-range-control" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-range-control">10.5.6 The input element as a range
control</a> <span class="id">(the-input-element-as-a-range-control)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-color-well" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-color-well">10.4.7 The input element as a color
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-color-well" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-color-well">10.5.7 The input element as a color
well</a> <span class="id">(the-input-element-as-a-color-well)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=the-input-element-as-a-checkbox-and-radio-button-widgets" class="status ADD">ADD</a> <a href="../spec/#the-input-element-as-a-checkbox-and-radio-button-widgets">
-10.4.8 The input element as a checkbox and
+10.5.8 The input element as a checkbox and
radio button widgets</a> <span class="id">(the-input-element-as-a-checkbox-and-radio-button-widgets)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-file-upload-control" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-file-upload-control">10.4.9 The input element as a file
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-file-upload-control" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-file-upload-control">10.5.9 The input element as a file
upload control</a> <span class="id">(the-input-element-as-a-file-upload-control)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-button" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-button">10.4.10 The input element as a
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-input-element-as-a-button" class="status LC">LC</a> <a href="../spec/#the-input-element-as-a-button">10.5.10 The input element as a
button</a> <span class="id">(the-input-element-as-a-button)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-marquee-element-0" class="status LC">LC</a> <a href="../spec/#the-marquee-element-0">10.4.11 The marquee element</a> <span class="id">(the-marquee-element-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-meter-element-0" class="status LC">LC</a> <a href="../spec/#the-meter-element-0">10.4.12 The meter element</a> <span class="id">(the-meter-element-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-progress-element-0" class="status LC">LC</a> <a href="../spec/#the-progress-element-0">10.4.13 The progress element</a> <span class="id">(the-progress-element-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-select-element-0" class="status LC">LC</a> <a href="../spec/#the-select-element-0">10.4.14 The select element</a> <span class="id">(the-select-element-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-textarea-element-0" class="status LC">LC</a> <a href="../spec/#the-textarea-element-0">10.4.15 The textarea element</a> <span class="id">(the-textarea-element-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-keygen-element-0" class="status LC">LC</a> <a href="../spec/#the-keygen-element-0">10.4.16 The keygen element</a> <span class="id">(the-keygen-element-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-time-element-0" class="status LC">LC</a> <a href="../spec/#the-time-element-0">10.4.17 The time element</a> <span class="id">(the-time-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-marquee-element-0" class="status LC">LC</a> <a href="../spec/#the-marquee-element-0">10.5.11 The marquee element</a> <span class="id">(the-marquee-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-meter-element-0" class="status LC">LC</a> <a href="../spec/#the-meter-element-0">10.5.12 The meter element</a> <span class="id">(the-meter-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-progress-element-0" class="status LC">LC</a> <a href="../spec/#the-progress-element-0">10.5.13 The progress element</a> <span class="id">(the-progress-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-select-element-0" class="status LC">LC</a> <a href="../spec/#the-select-element-0">10.5.14 The select element</a> <span class="id">(the-select-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-textarea-element-0" class="status LC">LC</a> <a href="../spec/#the-textarea-element-0">10.5.15 The textarea element</a> <span class="id">(the-textarea-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-keygen-element-0" class="status LC">LC</a> <a href="../spec/#the-keygen-element-0">10.5.16 The keygen element</a> <span class="id">(the-keygen-element-0)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-time-element-0" class="status LC">LC</a> <a href="../spec/#the-time-element-0">10.5.17 The time element</a> <span class="id">(the-time-element-0)</span></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=frames-and-framesets" class="status LC">LC</a> <a href="../spec/#frames-and-framesets">10.5
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=frames-and-framesets" class="status LC">LC</a> <a href="../spec/#frames-and-framesets">10.6
Frames and framesets</a> <span class="id">(frames-and-framesets)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=interactive-media" class="status LC">LC</a> <a href="../spec/#interactive-media">10.6
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=interactive-media" class="status LC">LC</a> <a href="../spec/#interactive-media">10.7
Interactive media</a> <span class="id">(interactive-media)</span>
-<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=links-forms-and-navigation" class="status ADD">ADD</a> <a href="../spec/#links-forms-and-navigation">10.6.1 Links, forms, and navigation</a> <span class="id">(links-forms-and-navigation)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-title-attribute-0" class="status LC">LC</a> <a href="../spec/#the-title-attribute-0">10.6.2 The title
+<ol><li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=links-forms-and-navigation" class="status ADD">ADD</a> <a href="../spec/#links-forms-and-navigation">10.7.1 Links, forms, and navigation</a> <span class="id">(links-forms-and-navigation)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=the-title-attribute-0" class="status LC">LC</a> <a href="../spec/#the-title-attribute-0">10.7.2 The title
attribute</a> <span class="id">(the-title-attribute-0)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=editing-hosts" class="status LC">LC</a> <a href="../spec/#editing-hosts">10.6.3
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=editing-hosts" class="status LC">LC</a> <a href="../spec/#editing-hosts">10.7.3
Editing hosts</a> <span class="id">(editing-hosts)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=text-rendered-in-native-user-interfaces" class="status ADD">ADD</a> <a href="../spec/#text-rendered-in-native-user-interfaces">10.6.4 Text rendered in native user
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=text-rendered-in-native-user-interfaces" class="status ADD">ADD</a> <a href="../spec/#text-rendered-in-native-user-interfaces">10.7.4 Text rendered in native user
interfaces</a> <span class="id">(text-rendered-in-native-user-interfaces)</span></li>
</ol></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=print-media" class="status LC">LC</a> <a href="../spec/#print-media">10.7 Print
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=print-media" class="status LC">LC</a> <a href="../spec/#print-media">10.8 Print
media</a> <span class="id">(print-media)</span></li>
</ol></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=obsolete" class="status ADD">ADD</a> <a href="../spec/#obsolete">11 Obsolete
@@ -1382,7 +1383,9 @@
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=text-html-sandboxed" class="status ADD">ADD</a> <a href="../spec/#text-html-sandboxed">12.2
text/html-sandboxed</a> <span class="id">(text-html-sandboxed)</span></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=application-xhtml-xml" class="status ADD">ADD</a> <a href="../spec/#application-xhtml-xml">12.3 application/xhtml+xml</a> <span class="id">(application-xhtml-xml)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=text-cache-manifest" class="status ADD">ADD</a> <a href="../spec/#text-cache-manifest">12.4
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=application-x-www-form-urlencoded" class="status ADD">ADD</a> <a href="../spec/#application-x-www-form-urlencoded">12.4
+application/x-www-form-urlencoded</a> <span class="id">(application-x-www-form-urlencoded)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/add-section.html?section=text-cache-manifest" class="status ADD">ADD</a> <a href="../spec/#text-cache-manifest">12.5
text/cache-manifest</a> <span class="id">(text-cache-manifest)</span></li>
</ol></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=index" class="status REC">REC</a> <a href="../spec/#index">Index</a> <span class="id">(index)</span>
@@ -1394,6 +1397,6 @@
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=events-0" class="status LC">LC</a> <a href="../spec/#events-0">Events</a> <span class="id">(events-0)</span></li>
</ol></li>
<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=references" class="status REC">REC</a> <a href="../spec/#references">References</a> <span class="id">(references)</span></li>
-<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=acknowledgements" class="status LC">LC</a> <a href="../spec/#acknowledgements">Acknowledgements</a> <span class="id">(acknowledgements)</span></li>
+<li><a target="_blank" href="http://www.whatwg.org/specs/web-apps/current-work/edit-section.html?section=acknowledgements" class="status REC">REC</a> <a href="../spec/#acknowledgements">Acknowledgements</a> <span class="id">(acknowledgements)</span></li>
</body></html>
Index: named-character-references.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/named-character-references.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- named-character-references.html 17 Jun 2011 08:49:07 -0000 1.11
+++ named-character-references.html 24 Aug 2011 07:56:04 -0000 1.12
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
Index: references.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/references.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- references.html 17 Jun 2011 08:49:07 -0000 1.13
+++ references.html 24 Aug 2011 07:56:04 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -387,8 +390,7 @@
230-265. London Mathematical Society, 1937.</dd>
<dt id="refsCOOKIES">[COOKIES]</dt>
- <dd><cite><a href="http://tools.ietf.org/html/draft-ietf-httpstate-cookie">HTTP State
- Management Mechanism</a></cite>, A. Barth. IETF.</dd>
+ <dd><cite><a href="http://tools.ietf.org/html/rfc6265">HTTP State Management Mechanism</a></cite>, A. Barth. IETF.</dd>
<dt id="refsCORS">[CORS]</dt>
<dd><cite><a href="http://dev.w3.org/2006/waf/access-control/">Cross-Origin
@@ -414,6 +416,11 @@
<dd><cite><a href="http://www.w3.org/TR/css3-fonts/">CSS Fonts
Module Level 3</a></cite>, J. Daggett. W3C.</dd>
+ <dt id="refsCSSIMAGES">[CSSIMAGES]</dt>
+ <dd><cite><a href="http://dev.w3.org/csswg/css3-images/">CSS Image
+ Values and Replaced Content Module Level 3</a></cite>, E. Etemad,
+ T. Atkins. W3C.</dd>
+
<dt id="refsCSSOM">[CSSOM]</dt>
<dd><cite><a href="http://dev.w3.org/csswg/cssom/">Cascading Style Sheets
Object Model (CSSOM)</a></cite>, A. van Kesteren. W3C.</dd>
@@ -539,7 +546,7 @@
Van Deursen. W3C.</dd>
<dt id="refsMFREL">[MFREL]</dt>
- <dd><cite><a href="http://microformats.org/wiki/existing-rel-values">Microformats Wiki: existing rel values</a></cite>. Microformats.</dd>
+ <dd><cite><a href="http://microformats.org/wiki/existing-rel-values#HTML5_link_type_extensions">Microformats Wiki: existing rel values</a></cite>. Microformats.</dd>
<dt id="refsMIMESNIFF">[MIMESNIFF]</dt>
<dd><cite><a href="http://tools.ietf.org/html/draft-abarth-mime-sniff">Media
@@ -560,7 +567,10 @@
Section 4.6.2. OpenSearch.org.</dd>
<dt id="refsORIGIN">[ORIGIN]</dt>
- <dd><cite><a href="http://tools.ietf.org/html/draft-ietf-websec-origin">The Web Origin Concept</a></cite>, A. Barth. IETF.</dd>
+ <dd><cite><a href="http://tools.ietf.org/html/draft-ietf-websec-origin">The Web Origin Concept</a></cite>, A. Barth. IETF.</dd>
+
+ <dt id="refsPDF">[PDF]</dt>
+ <dd>(Non-normative) <cite><a href="http://www.adobe.com/devnet/acrobat/pdfs/PDF32000_2008.pdf">Document management — Portable document format — Part 1: PDF</a></cite>. ISO.</dd>
<dt id="refsPINGBACK">[PINGBACK]</dt>
<dd><cite><a href="http://www.hixie.ch/specs/pingback/pingback">Pingback
@@ -735,9 +745,7 @@
C. Wicksteed, M. Davis, A. Freytag, M. Scherer. Unicode Consortium.</dd>
<dt id="refsSELECTORS">[SELECTORS]</dt>
- <dd><cite><a href="http://www.w3.org/TR/css3-selectors">Selectors</a></cite>,
- T. Çelik, E. Etemad, D. Glazman, I. Hickson, P. Linss,
- J. Williams. W3C.</dd>
+ <dd><cite><a href="http://dev.w3.org/csswg/selectors4/">Selectors</a></cite>, E. Etemad, T. Çelik, D. Glazman, I. Hickson, P. Linss, J. Williams. W3C.</dd>
<dt id="refsSHIFTJIS">[SHIFTJIS]</dt>
<dd><cite>JIS X0208: 7-bit and 8-bit double byte coded KANJI sets
Index: semantics.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/semantics.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- semantics.html 17 Jun 2011 08:49:07 -0000 1.13
+++ semantics.html 24 Aug 2011 07:56:04 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -315,12 +318,12 @@
}
return null;
}
- ]]></script><script src="link-fixup.js"/><link href="style.css" rel="stylesheet"/><link href="apis-in-html-documents.html" title="3.3 APIs in HTML documents" rel="prev"/><link href="spec.html#contents" title="Table of contents" rel="index"/><link href="scripting-1.html" title="4.3 Scripting" rel="next"/></head><body><div class="head" id="head">
+ ]]></script><script src="link-fixup.js"/><link href="style.css" rel="stylesheet"/><link href="content-models.html" title="3.2.5 Content models" rel="prev"/><link href="spec.html#contents" title="Table of contents" rel="index"/><link href="scripting-1.html" title="4.3 Scripting" rel="next"/></head><body><div class="head" id="head">
<p><a href="http://www.w3.org/"><img alt="W3C" height="48" src="http://www.w3.org/Icons/w3c_home" width="72"/></a></p>
<h1>HTML5</h1>
</div><div>
- <a href="apis-in-html-documents.html" class="prev">3.3 APIs in HTML documents</a> –
+ <a href="content-models.html" class="prev">3.2.5 Content models</a> –
<a href="spec.html#contents">Table of contents</a> –
<a href="scripting-1.html" class="next">4.3 Scripting</a>
<ol class="toc"><li><a href="semantics.html#semantics"><span class="secno">4 </span>The elements of HTML</a>
@@ -455,10 +458,10 @@
</dl><div class="impl">
<p>The IDL attribute <dfn id="dom-title-text" title="dom-title-text"><code>text</code></dfn> must return a
- concatenation of the contents of all the <a href="infrastructure.html#text-node" title="text node">text nodes</a> that are direct children of the
- <code><a href="#the-title-element">title</a></code> element (ignoring any other nodes such as
- comments or elements), in tree order. On setting, it must act the
- same way as the <code><a href="infrastructure.html#textcontent">textContent</a></code> IDL attribute.</p>
+ concatenation of the contents of all the <a href="infrastructure.html#text-node" title="text node">text nodes</a> that are children of the <code><a href="#the-title-element">title</a></code>
+ element (ignoring any other nodes such as comments or elements), in
+ tree order. On setting, it must act the same way as the
+ <code><a href="infrastructure.html#textcontent">textContent</a></code> IDL attribute.</p>
</div><div class="example">
@@ -582,11 +585,11 @@
attribute boolean <a href="#dom-link-disabled" title="dom-link-disabled">disabled</a>;
attribute DOMString <a href="#dom-link-href" title="dom-link-href">href</a>;
attribute DOMString <a href="#dom-link-rel" title="dom-link-rel">rel</a>;
- readonly attribute <a href="common-dom-interfaces.html#domtokenlist">DOMTokenList</a> <a href="#dom-link-rellist" title="dom-link-relList">relList</a>;
+ readonly attribute <a href="infrastructure.html#domtokenlist">DOMTokenList</a> <a href="#dom-link-rellist" title="dom-link-relList">relList</a>;
attribute DOMString <a href="#dom-link-media" title="dom-link-media">media</a>;
attribute DOMString <a href="#dom-link-hreflang" title="dom-link-hreflang">hreflang</a>;
attribute DOMString <a href="#dom-link-type" title="dom-link-type">type</a>;
- [PutForwards=<a href="common-dom-interfaces.html#dom-domsettabletokenlist-value" title="dom-DOMSettableTokenList-value">value</a>] readonly attribute <a href="common-dom-interfaces.html#domsettabletokenlist">DOMSettableTokenList</a> <a href="#dom-link-sizes" title="dom-link-sizes">sizes</a>;
+ [PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <a href="infrastructure.html#domsettabletokenlist">DOMSettableTokenList</a> <a href="#dom-link-sizes" title="dom-link-sizes">sizes</a>;
};
<a href="#htmllinkelement">HTMLLinkElement</a> implements <span>LinkStyle</span>;</pre>
</dd>
@@ -617,7 +620,20 @@
<code><a href="#the-link-element">link</a></code> element has a <code title="attr-link-rel"><a href="#attr-link-rel">rel</a></code> attribute with the value <code title="">next stylesheet</code>, it creates both a
<a href="links.html#hyperlink">hyperlink</a> (for the <code title="rel-next"><a href="links.html#link-type-next">next</a></code>
keyword) and an <a href="links.html#external-resource-link">external resource link</a> (for the <code title="rel-stylesheet"><a href="links.html#link-type-stylesheet">stylesheet</a></code> keyword), and they are
- affected by other attributes (such as <code title="attr-link-media"><a href="#attr-link-media">media</a></code> or <code title="attr-link-title"><a href="#attr-link-title">title</a></code>) differently.</p><p>The exact behavior for links to external resources depends on the
+ affected by other attributes (such as <code title="attr-link-media"><a href="#attr-link-media">media</a></code> or <code title="attr-link-title"><a href="#attr-link-title">title</a></code>) differently.</p><div class="example">
+
+ <p>For example, the following <code><a href="#the-link-element">link</a></code> element creates two
+ hyperlinks (to the same page):</p>
+
+ <pre><link rel="author license" href="/about"></pre>
+
+ <p>The two links created by this element are one whose semantic is
+ that the target page has information about the current page's
+ author, and one whose semantic is that the target page has
+ information regarding the license under which the current page is
+ provided.</p>
+
+ </div><p>The exact behavior for links to external resources depends on the
exact relationship, as defined for the relevant link type. Some of
the attributes control whether or not the external resource is to be
applied (as defined below).</p><div class="impl">
@@ -901,7 +917,7 @@
also be specified. Otherwise, it must be omitted.</p><p>The <dfn id="attr-meta-charset" title="attr-meta-charset"><code>charset</code></dfn>
attribute specifies the character encoding used by the
document. This is a <a href="#character-encoding-declaration">character encoding declaration</a>. If
- the attribute is present in an <a href="dom.html#xml-documents" title="XML documents">XML
+ the attribute is present in an <a href="infrastructure.html#xml-documents" title="XML documents">XML
document</a>, its value must be an <a href="infrastructure.html#ascii-case-insensitive">ASCII
case-insensitive</a> match for the string "<code title="">UTF-8</code>" (and the document is therefore forced to use
UTF-8 as its encoding).</p><p class="note">The <code title="attr-meta-charset"><a href="#attr-meta-charset">charset</a></code>
@@ -915,14 +931,14 @@
values depend on the exact context, as described in subsequent
sections of this specification.</p><p>If a <code><a href="#the-meta-element">meta</a></code> element has a <dfn id="attr-meta-name" title="attr-meta-name"><code>name</code></dfn> attribute, it sets
document metadata. Document metadata is expressed in terms of
- name/value pairs, the <code title="attr-meta-name"><a href="#attr-meta-name">name</a></code>
+ name-value pairs, the <code title="attr-meta-name"><a href="#attr-meta-name">name</a></code>
attribute on the <code><a href="#the-meta-element">meta</a></code> element giving the name, and the
<code title="attr-meta-content"><a href="#attr-meta-content">content</a></code> attribute on the same
element giving the value. The name specifies what aspect of metadata
is being set; valid names and the meaning of their values are
described in the following sections. If a <code><a href="#the-meta-element">meta</a></code> element
has no <code title="attr-meta-content"><a href="#attr-meta-content">content</a></code> attribute,
- then the value part of the metadata name/value pair is the empty
+ then the value part of the metadata name-value pair is the empty
string.</p><div class="impl">
<p>The <dfn id="dom-meta-name" title="dom-meta-name"><code>name</code></dfn> and <dfn id="dom-meta-content" title="dom-meta-content"><code>content</code></dfn> IDL attributes
@@ -1255,9 +1271,9 @@
state</a> and a <code><a href="#the-meta-element">meta</a></code> element with the <code title="attr-meta-charset"><a href="#attr-meta-charset">charset</a></code> attribute present.</p>
<p>The <a href="#attr-meta-http-equiv-content-type" title="attr-meta-http-equiv-content-type">Encoding
- declaration state</a> may be used in <a href="dom.html#html-documents">HTML
+ declaration state</a> may be used in <a href="infrastructure.html#html-documents">HTML
documents</a>, but elements with an <code title="attr-meta-http-equiv"><a href="#attr-meta-http-equiv">http-equiv</a></code> attribute in that
- state must not be used in <a href="dom.html#xml-documents">XML documents</a>.</p>
+ state must not be used in <a href="infrastructure.html#xml-documents">XML documents</a>.</p>
</dd>
@@ -1560,7 +1576,7 @@
</ul><p>In addition, due to a number of restrictions on <code><a href="#the-meta-element">meta</a></code>
elements, there can only be one <code><a href="#the-meta-element">meta</a></code>-based character
- encoding declaration per document.</p><p>If an <a href="dom.html#html-documents" title="HTML documents">HTML document</a> does not
+ encoding declaration per document.</p><p>If an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a> does not
start with a BOM, and if its encoding is not explicitly given by
<a href="fetching-resources.html#content-type" title="Content-Type">Content-Type metadata</a>, and the
document is not <a href="the-iframe-element.html#an-iframe-srcdoc-document">an <code>iframe</code> <code title="attr-iframe-srcdoc">srcdoc</code> document</a>, then the
@@ -1574,7 +1590,7 @@
document must not have a <a href="#character-encoding-declaration">character encoding
declaration</a>. (In this case, the source is already decoded,
since it is part of the document that contained the
- <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code>.)</p><p>If an <a href="dom.html#html-documents" title="HTML documents">HTML document</a> contains
+ <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code>.)</p><p>If an <a href="infrastructure.html#html-documents" title="HTML documents">HTML document</a> contains
a <code><a href="#the-meta-element">meta</a></code> element with a <code title="attr-meta-charset"><a href="#attr-meta-charset">charset</a></code> attribute or a
<code><a href="#the-meta-element">meta</a></code> element with an <code title="attr-meta-http-equiv"><a href="#attr-meta-http-equiv">http-equiv</a></code> attribute in the
<a href="#attr-meta-http-equiv-content-type" title="attr-meta-http-equiv-content-type">Encoding declaration
@@ -1617,7 +1633,7 @@
algorithms described in this specification intentionally do not
distinguish it from UTF-16. <a href="references.html#refsUNICODE">[UNICODE]</a></p><p class="note">Using non-UTF-8 encodings can have unexpected
results on form submission and URL encodings, which use the
- <a href="dom.html#document-s-character-encoding">document's character encoding</a> by default.</p><p>In XHTML, the XML declaration should be used for inline character
+ <a href="infrastructure.html#document-s-character-encoding">document's character encoding</a> by default.</p><p>In XHTML, the XML declaration should be used for inline character
encoding information, if necessary.</p><div class="example">
<p>In HTML, to declare that the character encoding is UTF-8, the
@@ -1687,15 +1703,17 @@
</div><p id="style-default-media">The default, if the <code title="attr-style-media"><a href="#attr-style-media">media</a></code> attribute is omitted, is
"<code title="">all</code>", meaning that by default styles apply to
all media.</p><p>The <dfn id="attr-style-scoped" title="attr-style-scoped"><code>scoped</code></dfn>
- attribute is a <a href="common-microsyntaxes.html#boolean-attribute">boolean attribute</a>. If set, it indicates
- that the styles are intended just for the subtree rooted at the
- <code><a href="#the-style-element">style</a></code> element's parent element, as opposed to the whole
- <code><a href="infrastructure.html#document">Document</a></code>.</p><div class="impl">
+ attribute is a <a href="common-microsyntaxes.html#boolean-attribute">boolean attribute</a>. If present, it
+ indicates that the styles are intended just for the subtree rooted
+ at the <code><a href="#the-style-element">style</a></code> element's parent element, as opposed to
+ the whole <code><a href="infrastructure.html#document">Document</a></code>. If the <code title="attr-style-scoped"><a href="#attr-style-scoped">scoped</a></code> attribute is present, the
+ <code><a href="#the-style-element">style</a></code> element must be the first element of <a href="content-models.html#flow-content">flow
+ content</a> in its parent element, if any.</p><div class="impl">
<p>If the <code title="attr-style-scoped"><a href="#attr-style-scoped">scoped</a></code> attribute is
present, then the user agent must apply the specified style
information only to the <code><a href="#the-style-element">style</a></code> element's parent element
- (if any), and that element's child nodes. Otherwise, the specified
+ (if any), and that element's descendants. Otherwise, the specified
styles must, if applied, be applied to the entire document.</p>
<p>For scoped CSS resources, the effect of @-rules must be scoped to
@@ -1731,12 +1749,11 @@
evaluated. For styling languages that consist of pure text (as
opposed to XML), user agents must evaluate <code><a href="#the-style-element">style</a></code>
elements by passing the concatenation of the contents of all the
- <a href="infrastructure.html#text-node" title="text node">text nodes</a> that are direct children
- of the <code><a href="#the-style-element">style</a></code> element (not any other nodes such as
- comments or elements), in <a href="infrastructure.html#tree-order">tree order</a>, to the style
- system. For XML-based styling languages, user agents must pass all
- the child nodes of the <code><a href="#the-style-element">style</a></code> element to the style
- system.</p>
+ <a href="infrastructure.html#text-node" title="text node">text nodes</a> that are children of the
+ <code><a href="#the-style-element">style</a></code> element (not any other nodes such as comments or
+ elements), in <a href="infrastructure.html#tree-order">tree order</a>, to the style system. For
+ XML-based styling languages, user agents must pass all the child
+ nodes of the <code><a href="#the-style-element">style</a></code> element to the style system.</p>
<p>All <a href="urls.html#url" title="URL">URLs</a> found by the styling language's
processor must be <a href="urls.html#resolve-a-url" title="resolve a url">resolved</a>,
Index: index.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/index.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- index.html 17 Jun 2011 08:49:06 -0000 1.12
+++ index.html 24 Aug 2011 07:56:04 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -360,7 +363,7 @@
<td><a href="elements.html#global-attributes" title="global attributes">globals</a></td>
<td><code><a href="elements.html#htmlelement">HTMLElement</a></code></td>
</tr><tr><th><code><a href="sections.html#the-address-element">address</a></code></th>
- <td>Contact information for a page or section</td>
+ <td>Contact information for a page or <code><a href="sections.html#the-article-element">article</a></code> element</td>
<td><a href="content-models.html#flow-content" title="Flow content">flow</a>;
<a href="dnd.html#formatblock-candidate" title="formatBlock candidate"><code title="">formatBlock</code> candidate</a></td>
<td><a href="content-models.html#flow-content" title="Flow content">flow</a></td>
@@ -1345,6 +1348,7 @@
<td><a href="elements.html#global-attributes" title="global attributes">globals</a>;
<code title="attr-fe-autofocus"><a href="association-of-controls-and-forms.html#attr-fe-autofocus">autofocus</a></code>;
<code title="attr-textarea-cols"><a href="the-button-element.html#attr-textarea-cols">cols</a></code>;
+ <code title="attr-textarea-dirname"><a href="the-button-element.html#attr-textarea-dirname">dirname</a></code>;
<code title="attr-fe-disabled"><a href="association-of-controls-and-forms.html#attr-fe-disabled">disabled</a></code>;
<code title="attr-fae-form"><a href="association-of-controls-and-forms.html#attr-fae-form">form</a></code>;
<code title="attr-textarea-maxlength"><a href="the-button-element.html#attr-textarea-maxlength">maxlength</a></code>;
@@ -1840,7 +1844,7 @@
</td><td> Hint that the <a href="the-iframe-element.html#media-resource">media resource</a> can be started automatically when the page is loaded
</td><td> <a href="common-microsyntaxes.html#boolean-attribute">Boolean attribute</a>
</td></tr><tr><th> <code title="">border</code>
- </th><td> <code title="attr-table-border"><a href="tabular-data.html#attr-table-border">border</a></code>
+ </th><td> <code title="attr-table-border"><a href="tabular-data.html#attr-table-border">table</a></code>
</td><td> Explicit indication that the <code><a href="tabular-data.html#the-table-element">table</a></code> element is not being used for layout purposes
</td><td> The empty string, or "<code title="">1</code>"
</td></tr><tr><th> <code title="">challenge</code>
@@ -2259,9 +2263,10 @@
</th><td> <code title="attr-iframe-sandbox"><a href="the-iframe-element.html#attr-iframe-sandbox">iframe</a></code>
</td><td> Security rules for nested content
</td><td> <a href="common-microsyntaxes.html#unordered-set-of-unique-space-separated-tokens">Unordered set of unique space-separated tokens</a>, <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a>, consisting of
+ "<code title="attr-iframe-sandbox-allow-forms"><a href="the-iframe-element.html#attr-iframe-sandbox-allow-forms">allow-forms</a></code>",
"<code title="attr-iframe-sandbox-allow-same-origin"><a href="the-iframe-element.html#attr-iframe-sandbox-allow-same-origin">allow-same-origin</a></code>",
- "<code title="attr-iframe-sandbox-allow-forms"><a href="the-iframe-element.html#attr-iframe-sandbox-allow-forms">allow-forms</a></code>", and
- "<code title="attr-iframe-sandbox-allow-scripts"><a href="the-iframe-element.html#attr-iframe-sandbox-allow-scripts">allow-scripts</a></code>"
+ "<code title="attr-iframe-sandbox-allow-scripts"><a href="the-iframe-element.html#attr-iframe-sandbox-allow-scripts">allow-scripts</a></code> and
+ "<code title="attr-iframe-sandbox-allow-top-navigation"><a href="the-iframe-element.html#attr-iframe-sandbox-allow-top-navigation">allow-top-navigation</a></code>"
</td></tr><tr><th> <code title="">spellcheck</code>
</th><td> <a href="editing.html#attr-spellcheck" title="attr-spellcheck">HTML elements</a>
</td><td> Whether the element is to have its spelling and grammar checked
@@ -2914,6 +2919,9 @@
</td></tr><tr><td> <code><a href="interactive-elements.html#the-details-element">details</a></code>
</td><td> <code><a href="interactive-elements.html#htmldetailselement">HTMLDetailsElement</a></code> : <code><a href="elements.html#htmlelement">HTMLElement</a></code>
+ </td></tr><tr><td> <code><a href="text-level-semantics.html#the-dfn-element">dfn</a></code>
+ </td><td> <code><a href="elements.html#htmlelement">HTMLElement</a></code>
+
</td></tr><tr><td> <code><a href="grouping-content.html#the-div-element">div</a></code>
</td><td> <code><a href="grouping-content.html#htmldivelement">HTMLDivElement</a></code> : <code><a href="elements.html#htmlelement">HTMLElement</a></code>
@@ -3016,6 +3024,12 @@
</td></tr><tr><td> <code><a href="text-level-semantics.html#the-mark-element">mark</a></code>
</td><td> <code><a href="elements.html#htmlelement">HTMLElement</a></code>
+ </td></tr><tr><td> <code><a href="interactive-elements.html#the-menu-element">menu</a></code>
+ </td><td> <code><a href="interactive-elements.html#htmlmenuelement">HTMLMenuElement</a></code> : <code><a href="elements.html#htmlelement">HTMLElement</a></code>
+
+ </td></tr><tr><td> <code><a href="semantics.html#the-meta-element">meta</a></code>
+ </td><td> <code><a href="semantics.html#htmlmetaelement">HTMLMetaElement</a></code> : <code><a href="elements.html#htmlelement">HTMLElement</a></code>
+
</td></tr><tr><td> <code><a href="the-button-element.html#the-meter-element">meter</a></code>
</td><td> <code><a href="the-button-element.html#htmlmeterelement">HTMLMeterElement</a></code> : <code><a href="elements.html#htmlelement">HTMLElement</a></code>
@@ -3053,7 +3067,7 @@
</td><td> <code><a href="the-button-element.html#htmlprogresselement">HTMLProgressElement</a></code> : <code><a href="elements.html#htmlelement">HTMLElement</a></code>
</td></tr><tr><td> <code><a href="text-level-semantics.html#the-q-element">q</a></code>
- </td><td> <code><a href="elements.html#htmlelement">HTMLElement</a></code>
+ </td><td> <code><a href="grouping-content.html#htmlquoteelement">HTMLQuoteElement</a></code> : <code><a href="elements.html#htmlelement">HTMLElement</a></code>
</td></tr><tr><td> <code><a href="text-level-semantics.html#the-rp-element">rp</a></code>
</td><td> <code><a href="elements.html#htmlelement">HTMLElement</a></code>
@@ -3070,6 +3084,9 @@
</td></tr><tr><td> <code><a href="text-level-semantics.html#the-samp-element">samp</a></code>
</td><td> <code><a href="elements.html#htmlelement">HTMLElement</a></code>
+ </td></tr><tr><td> <code><a href="scripting-1.html#the-script-element">script</a></code>
+ </td><td> <code><a href="scripting-1.html#htmlscriptelement">HTMLScriptElement</a></code> : <code><a href="elements.html#htmlelement">HTMLElement</a></code>
+
</td></tr><tr><td> <code><a href="sections.html#the-section-element">section</a></code>
</td><td> <code><a href="elements.html#htmlelement">HTMLElement</a></code>
@@ -3188,6 +3205,10 @@
</td><td> <code><a href="infrastructure.html#event">Event</a></code>
</td><td> Fired at elements when the user requests their context menu
+ </td></tr><tr><td> <code title="event-DOMContentLoaded">DOMContentLoaded</code>
+ </td><td> <code><a href="infrastructure.html#event">Event</a></code>
+ </td><td> Fired at the <code><a href="infrastructure.html#document">Document</a></code> once the parser has finished
+
</td></tr><tr><td> <code title="event-error">error</code>
</td><td> <code><a href="infrastructure.html#event">Event</a></code>
</td><td> Fired at elements when network and script errors occur
@@ -3259,5 +3280,5 @@
</td><td> Fired at the <code><a href="browsers.html#window">Window</a></code> object when the page is going away
</td></tr></tbody></table><p class="note">See also <a href="the-iframe-element.html#mediaevents">media element
- events</a>, <a href="offline.html#appcacheevents">application cache events</a>,
- and <a href="dnd.html#dndevents">drag-and-drop events</a>.</p></body></html>
+ events</a>, <a href="#mediasteamevents"><code>MediaStream</code> and
+ <code>PeerConnection</code> events</a>, <a href="offline.html#appcacheevents">application cache events</a>, and <a href="dnd.html#dndevents">drag-and-drop events</a>.</p></body></html>
Index: the-button-element.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/the-button-element.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- the-button-element.html 17 Jun 2011 08:49:07 -0000 1.13
+++ the-button-element.html 24 Aug 2011 07:56:05 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -354,7 +357,7 @@
attribute DOMString <a href="association-of-controls-and-forms.html#dom-fs-formaction" title="dom-fs-formAction">formAction</a>;
attribute DOMString <a href="association-of-controls-and-forms.html#dom-fs-formenctype" title="dom-fs-formEnctype">formEnctype</a>;
attribute DOMString <a href="association-of-controls-and-forms.html#dom-fs-formmethod" title="dom-fs-formMethod">formMethod</a>;
- attribute DOMString <a href="association-of-controls-and-forms.html#dom-fs-formnovalidate" title="dom-fs-formNoValidate">formNoValidate</a>;
+ attribute boolean <a href="association-of-controls-and-forms.html#dom-fs-formnovalidate" title="dom-fs-formNoValidate">formNoValidate</a>;
attribute DOMString <a href="association-of-controls-and-forms.html#dom-fs-formtarget" title="dom-fs-formTarget">formTarget</a>;
attribute DOMString <a href="association-of-controls-and-forms.html#dom-fe-name" title="dom-fe-name">name</a>;
attribute DOMString <a href="#dom-button-type" title="dom-button-type">type</a>;
@@ -364,7 +367,7 @@
readonly attribute <a href="association-of-controls-and-forms.html#validitystate">ValidityState</a> <a href="association-of-controls-and-forms.html#dom-cva-validity" title="dom-cva-validity">validity</a>;
readonly attribute DOMString <a href="association-of-controls-and-forms.html#dom-cva-validationmessage" title="dom-cva-validationMessage">validationMessage</a>;
boolean <a href="association-of-controls-and-forms.html#dom-cva-checkvalidatity" title="dom-cva-checkValidatity">checkValidity</a>();
- void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(in DOMString error);
+ void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(DOMString error);
readonly attribute <a href="infrastructure.html#nodelist">NodeList</a> <a href="forms.html#dom-lfe-labels" title="dom-lfe-labels">labels</a>;
};</pre>
@@ -496,13 +499,16 @@
readonly attribute <a href="common-dom-interfaces.html#htmloptionscollection">HTMLOptionsCollection</a> <a href="#dom-select-options" title="dom-select-options">options</a>;
attribute unsigned long <a href="#dom-select-length" title="dom-select-length">length</a>;
- getter any <a href="#dom-select-item" title="dom-select-item">item</a>(in unsigned long index);
- any <a href="#dom-select-nameditem" title="dom-select-namedItem">namedItem</a>(in DOMString name);
- void <a href="#dom-select-add" title="dom-select-add">add</a>(in <a href="elements.html#htmlelement">HTMLElement</a> element, in optional <a href="elements.html#htmlelement">HTMLElement</a>? before);
- void <a href="#dom-select-add" title="dom-select-add">add</a>(in <a href="elements.html#htmlelement">HTMLElement</a> element, in long before);
- void <a href="#dom-select-remove" title="dom-select-remove">remove</a>(in long index);
+ getter <a href="infrastructure.html#element">Element</a> <a href="#dom-select-item" title="dom-select-item">item</a>(unsigned long index);
+ object <a href="#dom-select-nameditem" title="dom-select-namedItem">namedItem</a>(DOMString name);
+ void <a href="#dom-select-add" title="dom-select-add">add</a>(<a href="#htmloptionelement">HTMLOptionElement</a> element, optional <a href="elements.html#htmlelement">HTMLElement</a>? before);
+ void <a href="#dom-select-add" title="dom-select-add">add</a>(<a href="#htmloptgroupelement">HTMLOptGroupElement</a> element, optional <a href="elements.html#htmlelement">HTMLElement</a>? before);
+ void <a href="#dom-select-add" title="dom-select-add">add</a>(<a href="#htmloptionelement">HTMLOptionElement</a> element, long before);
+ void <a href="#dom-select-add" title="dom-select-add">add</a>(<a href="#htmloptgroupelement">HTMLOptGroupElement</a> element, long before);
+ void <a href="#dom-select-remove" title="dom-select-remove">remove</a>(long index);
+ <a href="common-dom-interfaces.html#dom-htmloptionscollection-setter" title="dom-HTMLOptionsCollection-setter">setter creator</a> void (unsigned long index, <a href="#htmloptionelement">HTMLOptionElement</a> option);
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-select-selectedoptions" title="dom-select-selectedOptions">selectedOptions</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-select-selectedoptions" title="dom-select-selectedOptions">selectedOptions</a>;
attribute long <a href="#dom-select-selectedindex" title="dom-select-selectedIndex">selectedIndex</a>;
attribute DOMString <a href="#dom-select-value" title="dom-select-value">value</a>;
@@ -510,7 +516,7 @@
readonly attribute <a href="association-of-controls-and-forms.html#validitystate">ValidityState</a> <a href="association-of-controls-and-forms.html#dom-cva-validity" title="dom-cva-validity">validity</a>;
readonly attribute DOMString <a href="association-of-controls-and-forms.html#dom-cva-validationmessage" title="dom-cva-validationMessage">validationMessage</a>;
boolean <a href="association-of-controls-and-forms.html#dom-cva-checkvalidatity" title="dom-cva-checkValidatity">checkValidity</a>();
- void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(in DOMString error);
+ void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(DOMString error);
readonly attribute <a href="infrastructure.html#nodelist">NodeList</a> <a href="forms.html#dom-lfe-labels" title="dom-lfe-labels">labels</a>;
};</pre>
@@ -706,17 +712,16 @@
<p>If <var title="">before</var> is omitted, null, or a number out
of range, then <var title="">element</var> will be added at the
end of the list.</p>
- <p>This method will throw a <code><a href="common-dom-interfaces.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code>
+ <p>This method will throw a <code><a href="infrastructure.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code>
exception if <var title="">element</var> is an ancestor of the
- element into which it is to be inserted. If <var title="">element</var> is not an <code><a href="#the-option-element">option</a></code> or
- <code><a href="#the-optgroup-element">optgroup</a></code> element, then the method does nothing.</p>
+ element into which it is to be inserted.</p>
</dd>
<dt><var title="">select</var> . <code title="dom-select-selectedOptions"><a href="#dom-select-selectedoptions">selectedOptions</a></code></dt>
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <a href="#concept-select-option-list" title="concept-select-option-list">list of options</a> that are
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <a href="#concept-select-option-list" title="concept-select-option-list">list of options</a> that are
selected.</p>
</dd>
@@ -764,7 +769,7 @@
instant.</p>
<p>The <dfn id="dom-select-length" title="dom-select-length"><code>length</code></dfn> IDL
- attribute must return the number of nodes <a href="common-dom-interfaces.html#represented-by-the-collection" title="represented by the collection">represented</a> by the <code title="dom-select-options"><a href="#dom-select-options">options</a></code> collection. On setting, it
+ attribute must return the number of nodes <a href="infrastructure.html#represented-by-the-collection" title="represented by the collection">represented</a> by the <code title="dom-select-options"><a href="#dom-select-options">options</a></code> collection. On setting, it
must act like the attribute of the same name on the <code title="dom-select-options"><a href="#dom-select-options">options</a></code> collection.</p>
<p>The <dfn id="dom-select-item" title="dom-select-item"><code>item(<var title="">index</var>)</code></dfn> method must return the value
@@ -775,11 +780,17 @@
returned by the method of the same name on the <code title="dom-select-options"><a href="#dom-select-options">options</a></code> collection, when invoked
with the same argument.</p>
+ <p>When the user agent is to <dfn id="dom-htmlselectelement-setter" title="dom-HTMLSelectElement-setter">set the value of a new indexed
+ property</dfn> for a given property index <var title="">index</var>
+ to a new value <var title="">value</var>, it must instead <a href="common-dom-interfaces.html#dom-htmloptionscollection-setter" title="dom-HTMLOptionsCollection-setter">set the value of a new
+ indexed property</a> with the given property index <var title="">index</var> to the new value <var title="">value</var> on the
+ <code title="dom-select-options"><a href="#dom-select-options">options</a></code> collection.</p>
+
<p>Similarly, the <dfn id="dom-select-add" title="dom-select-add"><code>add()</code></dfn> and <dfn id="dom-select-remove" title="dom-select-remove"><code>remove()</code></dfn> methods must
act like their namesake methods on that same <code title="dom-select-options"><a href="#dom-select-options">options</a></code> collection.</p>
<p>The <dfn id="dom-select-selectedoptions" title="dom-select-selectedOptions"><code>selectedOptions</code></dfn>
- IDL attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at
+ IDL attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at
the <code><a href="#the-select-element">select</a></code> node, whose filter matches the elements in
the <a href="#concept-select-option-list" title="concept-select-option-list">list of options</a>
that have their <a href="#concept-option-selectedness" title="concept-option-selectedness">selectedness</a> set to
@@ -819,9 +830,8 @@
<dfn id="dom-select-size" title="dom-select-size"><code>size</code></dfn> IDL attributes
must <a href="common-dom-interfaces.html#reflect">reflect</a> the respective content attributes of the
same name. The <code title="dom-select-size"><a href="#dom-select-size">size</a></code> IDL
- attribute is <a href="common-dom-interfaces.html#limited-to-only-non-negative-numbers">limited to only non-negative numbers</a>, with
- the default value zero (which for historical reasons is different
- from the default value of the <code title="attr-select-size"><a href="#attr-select-size">size</a></code> content attribute that it
+ attribute has a default value of zero (which for historical reasons
+ is different from the default value of the <code title="attr-select-size"><a href="#attr-select-size">size</a></code> content attribute that it
reflects).</p>
<p>The <code title="dom-cva-willValidate"><a href="association-of-controls-and-forms.html#dom-cva-willvalidate">willValidate</a></code>, <code title="dom-cva-validity"><a href="association-of-controls-and-forms.html#dom-cva-validity">validity</a></code>, and <code title="dom-cva-validationMessage"><a href="association-of-controls-and-forms.html#dom-cva-validationmessage">validationMessage</a></code>
attributes, and the <code title="dom-cva-checkValidatity"><a href="association-of-controls-and-forms.html#dom-cva-checkvalidatity">checkValidity()</a></code> and <code title="dom-cva-setCustomValidity"><a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity">setCustomValidity()</a></code>
@@ -848,6 +858,18 @@
</select>
</p></pre>
+ <p>When there is no default option, a placeholder can be used
+ instead:</p>
+
+ <pre><select name="unittype" <strong>required</strong>>
+ <strong><option value=""> Select unit type </option></strong>
+ <option value="1"> Miner </option>
+ <option value="2"> Puffer </option>
+ <option value="3"> Snipey </option>
+ <option value="4"> Max </option>
+ <option value="5"> Firebot </option>
+</select></pre>
+
</div><div class="example">
<p>Here, the user is offered a set of options from which he can
@@ -864,6 +886,26 @@
</select>
</p></pre>
+ </div><div class="example">
+
+ <p>Sometimes, a user has to select one or more items. This example
+ shows such an interface.</p>
+
+ <pre><p>Select the songs from that you would like on your Act II Mix Tape:</p>
+<select multiple required name="act2">
+ <option value="s1">It Sucks to Be Me (Reprise)
+ <option value="s2">There is Life Outside Your Apartment
+ <option value="s3">The More You Ruv Someone
+ <option value="s4">Schadenfreude
+ <option value="s5">I Wish I Could Go Back to College
+ <option value="s6">The Money Song
+ <option value="s7">School for Monsters
+ <option value="s8">The Money Song (Reprise)
+ <option value="s9">There's a Fine, Fine Line (Reprise)
+ <option value="s10">What Do You Do With a B.A. in English? (Reprise)
+ <option value="s11">For Now
+</select></pre>
+
</div><h4 id="the-datalist-element"><span class="secno">4.10.10 </span>The <dfn><code>datalist</code></dfn> element</h4><dl class="element"><dt>Categories</dt>
<dd><a href="content-models.html#flow-content">Flow content</a>.</dd>
<dd><a href="content-models.html#phrasing-content">Phrasing content</a>.</dd>
@@ -877,7 +919,7 @@
<dt>DOM interface:</dt>
<dd>
<pre class="idl">interface <dfn id="htmldatalistelement">HTMLDataListElement</dfn> : <a href="elements.html#htmlelement">HTMLElement</a> {
- readonly attribute <a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a> <a href="#dom-datalist-options" title="dom-datalist-options">options</a>;
+ readonly attribute <a href="infrastructure.html#htmlcollection">HTMLCollection</a> <a href="#dom-datalist-options" title="dom-datalist-options">options</a>;
};</pre>
</dd>
</dl><p>The <code><a href="#the-datalist-element">datalist</a></code> element represents a set of
@@ -896,13 +938,13 @@
</p><dl class="domintro"><dt><var title="">datalist</var> . <code title="dom-datalist-options"><a href="#dom-datalist-options">options</a></code></dt>
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the <code>options</code> elements of the table.</p>
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the <code>options</code> elements of the table.</p>
</dd>
</dl><div class="impl">
<p>The <dfn id="dom-datalist-options" title="dom-datalist-options"><code>options</code></dfn>
- IDL attribute must return an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at
+ IDL attribute must return an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at
the <code><a href="#the-datalist-element">datalist</a></code> node, whose filter matches
<code><a href="#the-option-element">option</a></code> elements.</p>
@@ -994,10 +1036,10 @@
<dt>DOM interface:</dt>
<dd>
<pre class="idl">[NamedConstructor=<a href="#dom-option" title="dom-option">Option</a>(),
- NamedConstructor=<a href="#dom-option-t" title="dom-option-t">Option</a>(in DOMString text),
- NamedConstructor=<a href="#dom-option-tv" title="dom-option-tv">Option</a>(in DOMString text, in DOMString value),
- NamedConstructor=<a href="#dom-option-tvd" title="dom-option-tvd">Option</a>(in DOMString text, in DOMString value, in boolean defaultSelected),
- NamedConstructor=<a href="#dom-option-tvds" title="dom-option-tvds">Option</a>(in DOMString text, in DOMString value, in boolean defaultSelected, in boolean selected)]
+ NamedConstructor=<a href="#dom-option-t" title="dom-option-t">Option</a>(DOMString text),
+ NamedConstructor=<a href="#dom-option-tv" title="dom-option-tv">Option</a>(DOMString text, DOMString value),
+ NamedConstructor=<a href="#dom-option-tvd" title="dom-option-tvd">Option</a>(DOMString text, DOMString value, boolean defaultSelected),
+ NamedConstructor=<a href="#dom-option-tvds" title="dom-option-tvds">Option</a>(DOMString text, DOMString value, boolean defaultSelected, boolean selected)]
interface <dfn id="htmloptionelement">HTMLOptionElement</dfn> : <a href="elements.html#htmlelement">HTMLElement</a> {
attribute boolean <a href="#dom-option-disabled" title="dom-option-disabled">disabled</a>;
readonly attribute <a href="forms.html#htmlformelement">HTMLFormElement</a>? <a href="#dom-option-form" title="dom-option-form">form</a>;
@@ -1028,11 +1070,11 @@
</div><p>The <dfn id="attr-option-label" title="attr-option-label"><code>label</code></dfn>
attribute provides a label for element. The <dfn id="concept-option-label" title="concept-option-label">label</dfn> of an <code><a href="#the-option-element">option</a></code>
- element is the value of the <code title="attr-option-label"><a href="#attr-option-label">label</a></code> attribute, if there is one,
- or the <code><a href="infrastructure.html#textcontent">textContent</a></code> of the element, if there isn't.</p><p>The <dfn id="attr-option-value" title="attr-option-value"><code>value</code></dfn>
+ element is the value of the <code title="attr-option-label"><a href="#attr-option-label">label</a></code> content attribute, if there
+ is one, or, if there is not, the value of the element's <code title="dom-option-text"><a href="#dom-option-text">text</a></code> IDL attribute.</p><p>The <dfn id="attr-option-value" title="attr-option-value"><code>value</code></dfn>
attribute provides a value for element. The <dfn id="concept-option-value" title="concept-option-value">value</dfn> of an <code><a href="#the-option-element">option</a></code>
- element is the value of the <code title="attr-option-value"><a href="#attr-option-value">value</a></code> attribute, if there is one,
- or the <code><a href="infrastructure.html#textcontent">textContent</a></code> of the element, if there isn't.</p><p>The <dfn id="attr-option-selected" title="attr-option-selected"><code>selected</code></dfn>
+ element is the value of the <code title="attr-option-value"><a href="#attr-option-value">value</a></code> content attribute, if there
+ is one, or, if there is not, the value of the element's <code title="dom-option-text"><a href="#dom-option-text">text</a></code> IDL attribute.</p><p>The <dfn id="attr-option-selected" title="attr-option-selected"><code>selected</code></dfn>
attribute is a <a href="common-microsyntaxes.html#boolean-attribute">boolean attribute</a>. It represents the
default <a href="#concept-option-selectedness" title="concept-option-selectedness">selectedness</a> of the
element.</p><div class="impl">
@@ -1142,10 +1184,10 @@
<p>The <dfn id="dom-option-text" title="dom-option-text"><code>text</code></dfn> IDL
attribute, on getting, must return the value of the
- <code><a href="infrastructure.html#textcontent">textContent</a></code> IDL attribute on the element with leading
- and trailing <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a>
- removed, and with any sequences of two or more <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a> replaced by a single U+0020 SPACE
- character. On setting, it must act as if the
+ <code><a href="infrastructure.html#textcontent">textContent</a></code> IDL attribute on the element, with <a href="common-microsyntaxes.html#strip-leading-and-trailing-whitespace" title="strip leading and trailing whitespace">leading and trailing
+ whitespace stripped</a>, and with any sequences of two or more
+ <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a> replaced by a
+ single U+0020 SPACE character. On setting, it must act as if the
<code><a href="infrastructure.html#textcontent">textContent</a></code> IDL attribute on the element had been set
to the new value.</p>
@@ -1227,7 +1269,7 @@
readonly attribute <a href="association-of-controls-and-forms.html#validitystate">ValidityState</a> <a href="association-of-controls-and-forms.html#dom-cva-validity" title="dom-cva-validity">validity</a>;
readonly attribute DOMString <a href="association-of-controls-and-forms.html#dom-cva-validationmessage" title="dom-cva-validationMessage">validationMessage</a>;
boolean <a href="association-of-controls-and-forms.html#dom-cva-checkvalidatity" title="dom-cva-checkValidatity">checkValidity</a>();
- void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(in DOMString error);
+ void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(DOMString error);
readonly attribute <a href="infrastructure.html#nodelist">NodeList</a> <a href="forms.html#dom-lfe-labels" title="dom-lfe-labels">labels</a>;
@@ -1235,7 +1277,7 @@
attribute unsigned long <a href="association-of-controls-and-forms.html#dom-textarea-input-selectionstart" title="dom-textarea/input-selectionStart">selectionStart</a>;
attribute unsigned long <a href="association-of-controls-and-forms.html#dom-textarea-input-selectionend" title="dom-textarea/input-selectionEnd">selectionEnd</a>;
attribute DOMString <a href="association-of-controls-and-forms.html#dom-textarea-input-selectiondirection" title="dom-textarea/input-selectionDirection">selectionDirection</a>;
- void <a href="association-of-controls-and-forms.html#dom-textarea-input-setselectionrange" title="dom-textarea/input-setSelectionRange">setSelectionRange</a>(in unsigned long start, in unsigned long end, in optional DOMString direction);
+ void <a href="association-of-controls-and-forms.html#dom-textarea-input-setselectionrange" title="dom-textarea/input-setSelectionRange">setSelectionRange</a>(unsigned long start, unsigned long end, optional DOMString direction);
};</pre>
</dd>
</dl><p>The <code><a href="#the-textarea-element">textarea</a></code> element <a href="rendering.html#represents">represents</a> a
@@ -1537,7 +1579,7 @@
readonly attribute <a href="association-of-controls-and-forms.html#validitystate">ValidityState</a> <a href="association-of-controls-and-forms.html#dom-cva-validity" title="dom-cva-validity">validity</a>;
readonly attribute DOMString <a href="association-of-controls-and-forms.html#dom-cva-validationmessage" title="dom-cva-validationMessage">validationMessage</a>;
boolean <a href="association-of-controls-and-forms.html#dom-cva-checkvalidatity" title="dom-cva-checkValidatity">checkValidity</a>();
- void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(in DOMString error);
+ void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(DOMString error);
readonly attribute <a href="infrastructure.html#nodelist">NodeList</a> <a href="forms.html#dom-lfe-labels" title="dom-lfe-labels">labels</a>;
};</pre>
@@ -1765,7 +1807,7 @@
<dt>DOM interface:</dt>
<dd>
<pre class="idl">interface <dfn id="htmloutputelement">HTMLOutputElement</dfn> : <a href="elements.html#htmlelement">HTMLElement</a> {
- [PutForwards=<a href="common-dom-interfaces.html#dom-domsettabletokenlist-value" title="dom-DOMSettableTokenList-value">value</a>] readonly attribute <a href="common-dom-interfaces.html#domsettabletokenlist">DOMSettableTokenList</a> <a href="#dom-output-htmlfor" title="dom-output-htmlFor">htmlFor</a>;
+ [PutForwards=<span title="dom-DOMSettableTokenList-value">value</span>] readonly attribute <a href="infrastructure.html#domsettabletokenlist">DOMSettableTokenList</a> <a href="#dom-output-htmlfor" title="dom-output-htmlFor">htmlFor</a>;
readonly attribute <a href="forms.html#htmlformelement">HTMLFormElement</a>? <a href="association-of-controls-and-forms.html#dom-fae-form" title="dom-fae-form">form</a>;
attribute DOMString <a href="association-of-controls-and-forms.html#dom-fe-name" title="dom-fe-name">name</a>;
@@ -1777,7 +1819,7 @@
readonly attribute <a href="association-of-controls-and-forms.html#validitystate">ValidityState</a> <a href="association-of-controls-and-forms.html#dom-cva-validity" title="dom-cva-validity">validity</a>;
readonly attribute DOMString <a href="association-of-controls-and-forms.html#dom-cva-validationmessage" title="dom-cva-validationMessage">validationMessage</a>;
boolean <a href="association-of-controls-and-forms.html#dom-cva-checkvalidatity" title="dom-cva-checkValidatity">checkValidity</a>();
- void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(in DOMString error);
+ void <a href="association-of-controls-and-forms.html#dom-cva-setcustomvalidity" title="dom-cva-setCustomValidity">setCustomValidity</a>(DOMString error);
readonly attribute <a href="infrastructure.html#nodelist">NodeList</a> <a href="forms.html#dom-lfe-labels" title="dom-lfe-labels">labels</a>;
};</pre>
@@ -1932,9 +1974,9 @@
completion represented by the element. The <dfn id="attr-progress-value" title="attr-progress-value"><code>value</code></dfn> attribute
specifies how much of the task has been completed, and the <dfn id="attr-progress-max" title="attr-progress-max"><code>max</code></dfn> attribute specifies
how much work the task requires in total. The units are arbitrary
- and not specified.</p><p class="note">To make an determinate progress bar, add a <code title="attr-progress-value"><a href="#attr-progress-value">value</a></code> attribute with the current
+ and not specified.</p><p class="note">To make a determinate progress bar, add a <code title="attr-progress-value"><a href="#attr-progress-value">value</a></code> attribute with the current
progress (either a number from 0.0 to 1.0, or, if the <code title="attr-progress-max"><a href="#attr-progress-max">max</a></code> attribute is specified, a
- number from 0 to the value of the <code title="attr-progress-max"><a href="#attr-progress-max">max</a></code> attribute. To make an
+ number from 0 to the value of the <code title="attr-progress-max"><a href="#attr-progress-max">max</a></code> attribute). To make an
indeterminate progress bar, remove the <code title="attr-progress-value"><a href="#attr-progress-value">value</a></code> attribute.</p><p>Authors are encouraged to also include the current value and the
maximum value inline as text inside the element, so that the
progress is made available to users of legacy user agents.</p><div class="example">
@@ -2037,7 +2079,9 @@
<p>The <dfn id="dom-progress-max" title="dom-progress-max"><code>max</code></dfn> IDL
attribute must <a href="common-dom-interfaces.html#reflect">reflect</a> the content attribute of the
- same name. The default value for <code title="dom-progress-max"><a href="#dom-progress-max">max</a></code> is 1.0.</p>
+ same name, <a href="common-dom-interfaces.html#limited-to-numbers-greater-than-zero">limited to numbers greater than zero</a>. The
+ default value for <code title="dom-progress-max"><a href="#dom-progress-max">max</a></code> is
+ 1.0.</p>
<p>The <code title="dom-lfe-labels"><a href="forms.html#dom-lfe-labels">labels</a></code> attribute provides
a list of the element's <code><a href="forms.html#the-label-element">label</a></code>s.</p>
@@ -2170,11 +2214,14 @@
<dd>
<p>If the <code title="attr-meter-max"><a href="#attr-meter-max">max</a></code> attribute is
- specified and a value could be parsed out of it, the maximum value
- is that value. Otherwise, the maximum value is 1.0.</p>
+ specified and a value could be parsed out of it, then the
+ candidate maximum value is that value. Otherwise, the candidate
+ maximum value is 1.0.</p>
- <p>If the maximum value would be less than the minimum value, then
- the maximum value is actually the same as the minimum value.</p>
+ <p>If the candidate maximum value is greater than or equal to the
+ minimum value, then the maximum value is the candidate maximum
+ value. Otherwise, the maximum value is the same as the minimum
+ value.</p>
</dd>
@@ -2184,13 +2231,16 @@
<p>If the <code title="attr-meter-value"><a href="#attr-meter-value">value</a></code> attribute is
specified and a value could be parsed out of it, then that value
- is the actual value. Otherwise, the actual value is zero.</p>
+ is the candidate actual value. Otherwise, the candidate actual
+ value is zero.</p>
- <p>If the actual value would be less than the minimum value, then
- the actual value is actually the same as the minimum value.</p>
+ <p>If the candidate actual value is less than the minimum value,
+ then the actual value is the minimum value.</p>
- <p>If, on the other hand, the actual value would be greater than
- the maximum value, then the actual value is the maximum value.</p>
+ <p>Otherwise, if the candidate actual value is greater than the
+ maximum value, then the actual value is the maximum value.</p>
+
+ <p>Otherwise, the actual value is the candidate actual value.</p>
</dd>
@@ -2199,14 +2249,17 @@
<dd>
<p>If the <code title="attr-meter-low"><a href="#attr-meter-low">low</a></code> attribute is
- specified and a value could be parsed out of it, then the low
- boundary is that value. Otherwise, the low boundary is the same as
- the minimum value.</p>
+ specified and a value could be parsed out of it, then the
+ candidate low boundary is that value. Otherwise, the candidate low
+ boundary is the same as the minimum value.</p>
- <p>If the low boundary is then less than the minimum value, then
- the low boundary is actually the same as the minimum
- value. Similarly, if the low boundary is greater than the maximum
- value, then it is actually the maximum value instead.</p>
+ <p>If the candidate low boundary is less than the minimum value,
+ then the low boundary is the minimum value.</p>
+
+ <p>Otherwise, if the candidate low boundary is greater than the
+ maximum value, then the low boundary is the maximum value.</p>
+
+ <p>Otherwise, the low boundary is the candidate low boundary.</p>
</dd>
@@ -2215,14 +2268,17 @@
<dd>
<p>If the <code title="attr-meter-high"><a href="#attr-meter-high">high</a></code> attribute is
- specified and a value could be parsed out of it, then the high
- boundary is that value. Otherwise, the high boundary is the same
- as the maximum value.</p>
+ specified and a value could be parsed out of it, then the
+ candidate high boundary is that value. Otherwise, the candidate
+ high boundary is the same as the maximum value.</p>
- <p>If the high boundary is then less than the low boundary, then
- the high boundary is actually the same as the low
- boundary. Similarly, if the high boundary is greater than the
- maximum value, then it is actually the maximum value instead.</p>
+ <p>If the candidate high boundary is less than the low boundary,
+ then the high boundary is the low boundary.</p>
+
+ <p>Otherwise, if the candidate high boundary is greater than the
+ maximum value, then the high boundary is the maximum value.</p>
+
+ <p>Otherwise, the high boundary is the candidate high boundary.</p>
</dd>
@@ -2232,13 +2288,18 @@
<p>If the <code title="attr-meter-optimum"><a href="#attr-meter-optimum">optimum</a></code>
attribute is specified and a value could be parsed out of it, then
- the optimum point is that value. Otherwise, the optimum point is
- the midpoint between the minimum value and the maximum value.</p>
+ the candidate optimum point is that value. Otherwise, the
+ candidate optimum point is the midpoint between the minimum value
+ and the maximum value.</p>
- <p>If the optimum point is then less than the minimum value, then
- the optimum point is actually the same as the minimum
- value. Similarly, if the optimum point is greater than the maximum
- value, then it is actually the maximum value instead.</p>
+ <p>If the candidate optimum point is less than the minimum value,
+ then the optimum point is the minimum value.</p>
+
+ <p>Otherwise, if the candidate optimum point is greater than the
+ maximum value, then the optimum point is the maximum value.</p>
+
+ <p>Otherwise, the optimum point is the candidate optimum
+ point.</p>
</dd>
@@ -2252,20 +2313,18 @@
optimum point is equal to the low boundary or the high boundary, or
anywhere in between them, then the region between the low and high
boundaries of the gauge must be treated as the optimum region, and
- the low and high parts, if any, must be treated as
- suboptimal. Otherwise, if the optimum point is less than the low
- boundary, then the region between the minimum value and the low
- boundary must be treated as the optimum region, the region between
- the low boundary and the high boundary must be treated as a
- suboptimal region, and the region between the high boundary and the
- maximum value must be treated as an even less good region. Finally,
- if the optimum point is higher than the high boundary, then the
- situation is reversed; the region between the high boundary and the
- maximum value must be treated as the optimum region, the region
- between the high boundary and the low boundary must be treated as a
- suboptimal region, and the remaining region between the low boundary
- and the minimum value must be treated as an even less good
- region.</p>
+ the low and high parts, if any, must be treated as suboptimal.
+ Otherwise, if the optimum point is less than the low boundary, then
+ the region between the minimum value and the low boundary must be
+ treated as the optimum region, the region from the low boundary up
+ to the high boundary must be treated as a suboptimal region, and the
+ remaining region must be treated as an even less good region.
+ Finally, if the optimum point is higher than the high boundary, then
+ the situation is reversed; the region between the high boundary and
+ the maximum value must be treated as the optimum region, the region
+ from the high boundary down to the low boundary must be treated as a
+ suboptimal region, and the remaining region must be treated as an
+ even less good region.</p>
<p><strong>UA requirements for showing the gauge</strong>: When
representing a <code><a href="#the-meter-element">meter</a></code> element to the user, the UA should
@@ -2317,9 +2376,35 @@
the number as a floating point number</a> and then the <code title="dom-meter-value"><a href="#dom-meter-value">value</a></code> content attribute must be set
to that string.</p>
- <p>The <dfn id="dom-meter-min" title="dom-meter-min"><code>min</code></dfn>, <dfn id="dom-meter-max" title="dom-meter-max"><code>max</code></dfn>, <dfn id="dom-meter-low" title="dom-meter-low"><code>low</code></dfn>, <dfn id="dom-meter-high" title="dom-meter-high"><code>high</code></dfn>, and <dfn id="dom-meter-optimum" title="dom-meter-optimum"><code>optimum</code></dfn> IDL attributes
- must <a href="common-dom-interfaces.html#reflect">reflect</a> the respective content attributes of the
- same name.</p>
+ <p>The <dfn id="dom-meter-min" title="dom-meter-min"><code>min</code></dfn> IDL
+ attribute, on getting, must return the <a href="#concept-meter-minimum" title="concept-meter-minimum">minimum value</a>. On setting, the
+ given value must be converted to the <a href="common-microsyntaxes.html#best-representation-of-the-number-as-a-floating-point-number">best representation of
+ the number as a floating point number</a> and then the <code title="dom-meter-min"><a href="#dom-meter-min">min</a></code> content attribute must be set to
+ that string.</p>
+
+ <p>The <dfn id="dom-meter-max" title="dom-meter-max"><code>max</code></dfn> IDL
+ attribute, on getting, must return the <a href="#concept-meter-maximum" title="concept-meter-maximum">maximum value</a>. On setting, the
+ given value must be converted to the <a href="common-microsyntaxes.html#best-representation-of-the-number-as-a-floating-point-number">best representation of
+ the number as a floating point number</a> and then the <code title="dom-meter-max"><a href="#dom-meter-max">max</a></code> content attribute must be set to
+ that string.</p>
+
+ <p>The <dfn id="dom-meter-low" title="dom-meter-low"><code>low</code></dfn> IDL
+ attribute, on getting, must return the <a href="#concept-meter-low" title="concept-meter-low">low boundary</a>. On setting, the given
+ value must be converted to the <a href="common-microsyntaxes.html#best-representation-of-the-number-as-a-floating-point-number">best representation of the
+ number as a floating point number</a> and then the <code title="dom-meter-low"><a href="#dom-meter-low">low</a></code> content attribute must be set to
+ that string.</p>
+
+ <p>The <dfn id="dom-meter-high" title="dom-meter-high"><code>high</code></dfn> IDL
+ attribute, on getting, must return the <a href="#concept-meter-high" title="concept-meter-high">high boundary</a>. On setting, the
+ given value must be converted to the <a href="common-microsyntaxes.html#best-representation-of-the-number-as-a-floating-point-number">best representation of
+ the number as a floating point number</a> and then the <code title="dom-meter-high"><a href="#dom-meter-high">high</a></code> content attribute must be set to
+ that string.</p>
+
+ <p>The <dfn id="dom-meter-optimum" title="dom-meter-optimum"><code>optimum</code></dfn> IDL
+ attribute, on getting, must return the <a href="#concept-meter-optimum" title="concept-meter-optimum">optimum value</a>. On setting, the
+ given value must be converted to the <a href="common-microsyntaxes.html#best-representation-of-the-number-as-a-floating-point-number">best representation of
+ the number as a floating point number</a> and then the <code title="dom-meter-optimum"><a href="#dom-meter-optimum">optimum</a></code> content attribute must be
+ set to that string.</p>
<p>The <code title="dom-lfe-labels"><a href="forms.html#dom-lfe-labels">labels</a></code> attribute provides
a list of the element's <code><a href="forms.html#the-label-element">label</a></code>s.</p>
Index: dnd.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/dnd.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- dnd.html 17 Jun 2011 08:49:05 -0000 1.13
+++ dnd.html 24 Aug 2011 07:56:03 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -329,10 +332,10 @@
<em>drag-and-drop operation</em> actually is.</p><p>On a visual medium with a pointing device, a drag operation could
be the default action of a <code title="event-mousedown">mousedown</code> event that is followed by a
series of <code title="event-mousemove">mousemove</code> events, and
- the drop could be triggered by the mouse being released.</p><p>On media without a pointing device, the user would probably have
- to explicitly indicate his intention to perform a drag-and-drop
- operation, stating what he wishes to drag and where he wishes to
- drop it, respectively.</p><div class="impl">
+ the drop could be triggered by the mouse being released.</p><p>When using an input modality other than a pointing device, users
+ would probably have to explicitly indicate their intention to
+ perform a drag-and-drop operation, stating what they wish to drag
+ and where they wish to drop it, respectively.</p><div class="impl">
<p>However it is implemented, drag-and-drop operations must have a
starting point (e.g. where the mouse was clicked, or the start of
@@ -547,14 +550,14 @@
readonly attribute <a href="#datatransferitemlist">DataTransferItemList</a> <a href="#dom-datatransfer-items" title="dom-DataTransfer-items">items</a>;
- void <a href="#dom-datatransfer-setdragimage" title="dom-DataTransfer-setDragImage">setDragImage</a>(in Element image, in long x, in long y);
- void <a href="#dom-datatransfer-addelement" title="dom-DataTransfer-addElement">addElement</a>(in Element element);
+ void <a href="#dom-datatransfer-setdragimage" title="dom-DataTransfer-setDragImage">setDragImage</a>(Element image, long x, long y);
+ void <a href="#dom-datatransfer-addelement" title="dom-DataTransfer-addElement">addElement</a>(Element element);
/* old interface */
readonly attribute DOMStringList <a href="#dom-datatransfer-types" title="dom-DataTransfer-types">types</a>;
- DOMString <a href="#dom-datatransfer-getdata" title="dom-DataTransfer-getData">getData</a>(in DOMString format);
- void <a href="#dom-datatransfer-setdata" title="dom-DataTransfer-setData">setData</a>(in DOMString format, in DOMString data);
- void <a href="#dom-datatransfer-cleardata" title="dom-DataTransfer-clearData">clearData</a>(in optional DOMString format);
+ DOMString <a href="#dom-datatransfer-getdata" title="dom-DataTransfer-getData">getData</a>(DOMString format);
+ void <a href="#dom-datatransfer-setdata" title="dom-DataTransfer-setData">setData</a>(DOMString format, DOMString data);
+ void <a href="#dom-datatransfer-cleardata" title="dom-DataTransfer-clearData">clearData</a>(optional DOMString format);
readonly attribute <a href="infrastructure.html#filelist">FileList</a> <a href="#dom-datatransfer-files" title="dom-DataTransfer-files">files</a>;
};</pre><dl class="domintro"><dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-dropEffect"><a href="#dom-datatransfer-dropeffect">dropEffect</a></code> [ = <var title="">value</var> ]</dt>
@@ -894,11 +897,11 @@
</div><h5 id="the-datatransferitemlist-interface"><span class="secno">7.7.3.1 </span>The <code><a href="#datatransferitemlist">DataTransferItemList</a></code> interface</h5><p>Each <code><a href="#datatransfer">DataTransfer</a></code> object is associated with a
<code><a href="#datatransferitemlist">DataTransferItemList</a></code> object.</p><pre class="idl">interface <dfn id="datatransferitemlist">DataTransferItemList</dfn> {
readonly attribute unsigned long <a href="#dom-datatransferitemlist-length" title="dom-DataTransferItemList-length">length</a>;
- <a href="#dom-datatransferitemlist-item" title="dom-DataTransferItemList-item">getter</a> <a href="#datatransferitem">DataTransferItem</a> (in unsigned long index);
- <a href="#dom-datatransferitemlist-removeitem" title="dom-DataTransferItemList-removeItem">deleter</a> void (in unsigned long index);
+ <a href="#dom-datatransferitemlist-item" title="dom-DataTransferItemList-item">getter</a> <a href="#datatransferitem">DataTransferItem</a> (unsigned long index);
+ <a href="#dom-datatransferitemlist-removeitem" title="dom-DataTransferItemList-removeItem">deleter</a> void (unsigned long index);
void <a href="#dom-datatransferitemlist-clear" title="dom-DataTransferItemList-clear">clear</a>();
- <a href="#datatransferitem">DataTransferItem</a>? <a href="#dom-datatransferitemlist-add" title="dom-DataTransferItemList-add">add</a>(in DOMString data, in DOMString type); <a href="#datatransferitem">DataTransferItem</a>? <a href="#dom-datatransferitemlist-add" title="dom-DataTransferItemList-add">add</a>(in <a href="infrastructure.html#file">File</a> data);};</pre><dl class="domintro"><dt><var title="">items</var> . <code title="dom-DataTransferItemList-length"><a href="#dom-datatransferitemlist-length">length</a></code></dt>
+ <a href="#datatransferitem">DataTransferItem</a>? <a href="#dom-datatransferitemlist-add" title="dom-DataTransferItemList-add">add</a>(DOMString data, DOMString type); <a href="#datatransferitem">DataTransferItem</a>? <a href="#dom-datatransferitemlist-add" title="dom-DataTransferItemList-add">add</a>(<a href="infrastructure.html#file">File</a> data);};</pre><dl class="domintro"><dt><var title="">items</var> . <code title="dom-DataTransferItemList-length"><a href="#dom-datatransferitemlist-length">length</a></code></dt>
<dd><p>Returns the number of items in the <a href="#drag-data-store">drag data store</a>.</p></dd>
@@ -989,7 +992,7 @@
<ol><li><p>If the <code><a href="#datatransferitemlist">DataTransferItemList</a></code> object is not in the
<i title="concept-dnd-rw"><a href="#concept-dnd-rw">read/write mode</a></i>, throw an
- <code><a href="common-dom-interfaces.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception and abort these
steps.</p></li>
<li><p>Remove the <var title="">i</var>th item from the <a href="#drag-data-store">drag
@@ -1019,7 +1022,7 @@
list</a> whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a> is <i>Plain Unicode string</i> and whose <a href="#the-drag-data-item-type-string" title="the drag data item type string">type string</a> is
equal to the value of the method's second argument,
<a href="infrastructure.html#converted-to-ascii-lowercase">converted to ASCII lowercase</a>, then throw a
- <code><a href="common-dom-interfaces.html#not_supported_err">NOT_SUPPORTED_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#not_supported_err">NOT_SUPPORTED_ERR</a></code> exception and abort these
steps.</p>
<p>Otherwise, add an item to the <a href="#drag-data-store-item-list">drag data store item
@@ -1053,13 +1056,13 @@
</ol></div><h5 id="the-datatransferitem-interface"><span class="secno">7.7.3.2 </span>The <code><a href="#datatransferitem">DataTransferItem</a></code> interface</h5><p>Each <code><a href="#datatransferitem">DataTransferItem</a></code> object is associated with a
<code><a href="#datatransfer">DataTransfer</a></code> object.</p><pre class="idl">interface <dfn id="datatransferitem">DataTransferItem</dfn> {
- readonly attribute DOMString <a href="#dom-datatransferitem-kind" title="dom-DataTransferItem-kind">kind</a>;
- readonly attribute DOMString <a href="#dom-datatransferitem-type" title="dom-DataTransferItem-type">type</a>;
- void <a href="#dom-datatransferitem-getasstring" title="dom-DataTransferItem-getAsString">getAsString</a>(in <a href="#functionstringcallback">FunctionStringCallback</a>? callback); <a href="infrastructure.html#file">File</a>? <a href="#dom-datatransferitem-getasfile" title="dom-DataTransferItem-getAsFile">getAsFile</a>();};
+ readonly attribute DOMString <a href="#dom-datatransferitem-kind" title="dom-DataTransferItem-kind">kind</a>;
+ readonly attribute DOMString <a href="#dom-datatransferitem-type" title="dom-DataTransferItem-type">type</a>;
+ void <a href="#dom-datatransferitem-getasstring" title="dom-DataTransferItem-getAsString">getAsString</a>(<a href="#functionstringcallback">FunctionStringCallback</a>? callback); <a href="infrastructure.html#file">File</a>? <a href="#dom-datatransferitem-getasfile" title="dom-DataTransferItem-getAsFile">getAsFile</a>();};
[Callback=FunctionOnly, NoInterfaceObject]
interface <dfn id="functionstringcallback">FunctionStringCallback</dfn> {
- void <span title="dom-FunctionStringCallback-handleEvent">handleEvent</span>(in DOMString data);
+ void <span title="dom-FunctionStringCallback-handleEvent">handleEvent</span>(DOMString data);
};</pre><dl class="domintro"><dt><var title="">item</var> . <code title="dom-DataTransferItem-kind"><a href="#dom-datatransferitem-kind">kind</a></code></dt>
<dd>
@@ -1163,7 +1166,7 @@
all use the <code><a href="#dragevent">DragEvent</a></code> interface.</p><pre class="idl">interface <dfn id="dragevent">DragEvent</dfn> : <a href="infrastructure.html#mouseevent">MouseEvent</a> {
readonly attribute <a href="#datatransfer">DataTransfer</a>? <a href="#dom-dragevent-datatransfer" title="dom-DragEvent-dataTransfer">dataTransfer</a>;
- void <a href="#dom-dragevent-initdragevent" title="dom-DragEvent-initDragEvent">initDragEvent</a>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any dummyArg, in long detailArg, in long screenXArg, in long screenYArg, in long clientXArg, in long clientYArg, in boolean ctrlKeyArg, in boolean altKeyArg, in boolean shiftKeyArg, in boolean metaKeyArg, in unsigned short buttonArg, in EventTarget relatedTargetArg, in <a href="#datatransfer">DataTransfer</a>? dataTransferArg);
+ void <a href="#dom-dragevent-initdragevent" title="dom-DragEvent-initDragEvent">initDragEvent</a>(DOMString typeArg, boolean canBubbleArg, boolean cancelableArg, any dummyArg, long detailArg, long screenXArg, long screenYArg, long clientXArg, long clientYArg, boolean ctrlKeyArg, boolean altKeyArg, boolean shiftKeyArg, boolean metaKeyArg, unsigned short buttonArg, EventTarget relatedTargetArg, <a href="#datatransfer">DataTransfer</a>? dataTransferArg);
};</pre><dl class="domintro"><dt><var title="">event</var> . <code title="dom-DragEvent-dataTransfer"><a href="#dom-dragevent-datatransfer">dataTransfer</a></code></dt>
<dd>
@@ -2455,8 +2458,8 @@
<dd class="impl">
<p><strong>Action</strong>: The user agent must run the following
steps:</p>
- <ol><li><p>If the document is an <a href="dom.html#xml-documents" title="XML documents">XML
- document</a>, then throw an <code><a href="common-dom-interfaces.html#invalid_access_err">INVALID_ACCESS_ERR</a></code>
+ <ol><li><p>If the document is an <a href="infrastructure.html#xml-documents" title="XML documents">XML
+ document</a>, then throw an <code><a href="infrastructure.html#invalid_access_err">INVALID_ACCESS_ERR</a></code>
exception and abort these steps.</p></li>
<li><p>If the <var title="">value</var> argument wasn't
specified, abort these steps without doing anything.</p></li>
Index: links.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/links.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- links.html 17 Jun 2011 08:49:06 -0000 1.13
+++ links.html 24 Aug 2011 07:56:04 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -324,9 +327,9 @@
<a href="spec.html#contents">Table of contents</a> –
<a href="browsers.html" class="next">5 Loading Web pages</a>
<ol class="toc"><li><ol><li><a href="links.html#links"><span class="secno">4.12 </span>Links</a>
- <ol><li><a href="links.html#introduction-3"><span class="secno">4.12.1 </span>Introduction</a></li><li><a href="links.html#links-created-by-a-and-area-elements"><span class="secno">4.12.2 </span>Links created by <code>a</code> and <code>area</code> elements</a></li><li><a href="links.html#following-hyperlinks"><span class="secno">4.12.3 </span>Following hyperlinks</a></li><li><a href="links.html#linkTypes"><span class="secno">4.12.4 </span>Link types</a>
- <ol><li><a href="links.html#rel-alternate"><span class="secno">4.12.4.1 </span>Link type "<code>alternate</code>"</a></li><li><a href="links.html#link-type-author"><span class="secno">4.12.4.2 </span>Link type "<code>author</code>"</a></li><li><a href="links.html#link-type-bookmark"><span class="secno">4.12.4.3 </span>Link type "<code>bookmark</code>"</a></li><li><a href="links.html#link-type-external"><span class="secno">4.12.4.4 </span>Link type "<code>external</code>"</a></li><li><a href="links.html#link-type-help"><span class="secno">4.12.4.5 </span>Link type "<code>help</code>"</a></li><li><a href="links.html#rel-icon"><span class="secno">4.12.4.6 </span>Link type "<code>icon</code>"</a></li><li><a href="links.html#link-type-license"><span class="secno">4.12.4.7 </span>Link type "<code>license</code>"</a></li><li><a href="links.html#link-type-nofollow"><span class="secno">4.12.4.8 </span>Link type "<code>nofollow</code>"</a></li><li><a href="links.html#link-type-noreferrer"><span class="secno">412.4.9 </span>Link type "<code>noreferrer</code>"</a></li><li><a href="links.html#link-type-pingback"><span class="secno">4.12.4.10 </span>Link type "<code>pingback</code>"</a></li><li><a href="links.html#link-type-prefetch"><span class="secno">4.12.4.11 </span>Link type "<code>prefetch</code>"</a></li><li><a href="links.html#link-type-search"><span class="secno">4.12.4.12 </span>Link type "<code>search</code>"</a></li><li><a href="links.html#link-type-sidebar"><span class="secno">4.12.4.13 </span>Link type "<code>sidebar</code>"</a></li><li><a href="links.html#link-type-stylesheet"><span class="secno">4.12.4.14 </span>Link type "<code>stylesheet</code>"</a></li><li><a href="links.html#link-type-tag"><span class="secno">4.12.4.15 </span>Link type "<code>tag</code>"</a></li><li><a href="links.html#sequential-link-types"><span class="secno">4.12.4.16 </span>Sequential link types</a>
- <ol><li><a href="links.html#link-type-next"><span class="secno">4.12.4.16.1 </span>Link type "<code>next</code>"</a></li><li><a href="links.html#link-type-prev"><span class="secno">4.12.4.16.2 </span>Link type "<code>prev</code>"</a></li></ol></li><li><a href="links.html#other-link-types"><span class="secno">4.12.4.17 </span>Other link types</a></li></ol></li></ol></li><li><a href="links.html#common-idioms-without-dedicated-elements"><span class="secno">4.13 </span>Common idioms without dedicated elements</a>
+ <ol><li><a href="links.html#introduction-3"><span class="secno">4.12.1 </span>Introduction</a></li><li><a href="links.html#links-created-by-a-and-area-elements"><span class="secno">4.12.2 </span>Links created by <code>a</code> and <code>area</code> elements</a></li><li><a href="links.html#following-hyperlinks-0"><span class="secno">4.12.3 </span>Following hyperlinks</a></li><li><a href="links.html#linkTypes"><span class="secno">4.12.4 </span>Link types</a>
+ <ol><li><a href="links.html#rel-alternate"><span class="secno">4.12.4.1 </span>Link type "<code>alternate</code>"</a></li><li><a href="links.html#link-type-author"><span class="secno">4.12.4.2 </span>Link type "<code>author</code>"</a></li><li><a href="links.html#link-type-bookmark"><span class="secno">4.12.4.3 </span>Link type "<code>bookmark</code>"</a></li><li><a href="links.html#link-type-help"><span class="secno">4.12.4.4 </span>Link type "<code>help</code>"</a></li><li><a href="links.html#rel-icon"><span class="secno">4.12.4.5 </span>Link type "<code>icon</code>"</a></li><li><a href="links.html#link-type-license"><span class="secno">4.12.4.6 </span>Link type "<code>license</code>"</a></li><li><a href="links.html#link-type-nofollow"><span class="secno">4.12.4.7 </span>Link type "<code>nofollow</code>"</a></li><li><a href="links.html#link-type-noreferrer"><span class="secno">4.12.4.8 </span>Link type "<code>noreferrer</code>"</a></li><li><a href="links.html#link-type-pingback"><span class="secno"4.12.4.9 </span>Link type "<code>pingback</code>"</a></li><li><a href="links.html#link-type-prefetch"><span class="secno">4.12.4.10 </span>Link type "<code>prefetch</code>"</a></li><li><a href="links.html#link-type-search"><span class="secno">4.12.4.11 </span>Link type "<code>search</code>"</a></li><li><a href="links.html#link-type-stylesheet"><span class="secno">4.12.4.12 </span>Link type "<code>stylesheet</code>"</a></li><li><a href="links.html#link-type-tag"><span class="secno">4.12.4.13 </span>Link type "<code>tag</code>"</a></li><li><a href="links.html#sequential-link-types"><span class="secno">4.12.4.14 </span>Sequential link types</a>
+ <ol><li><a href="links.html#link-type-next"><span class="secno">4.12.4.14.1 </span>Link type "<code>next</code>"</a></li><li><a href="links.html#link-type-prev"><span class="secno">4.12.4.14.2 </span>Link type "<code>prev</code>"</a></li></ol></li><li><a href="links.html#other-link-types"><span class="secno">4.12.4.15 </span>Other link types</a></li></ol></li></ol></li><li><a href="links.html#common-idioms-without-dedicated-elements"><span class="secno">4.13 </span>Common idioms without dedicated elements</a>
<ol><li><a href="links.html#the-main-part-of-the-content"><span class="secno">4.13.1 </span>The main part of the content</a></li><li><a href="links.html#rel-up"><span class="secno">4.13.2 </span>Bread crumb navigation</a></li><li><a href="links.html#tag-clouds"><span class="secno">4.13.3 </span>Tag clouds</a></li><li><a href="links.html#conversations"><span class="secno">4.13.4 </span>Conversations</a></li><li><a href="links.html#footnotes"><span class="secno">4.13.5 </span>Footnotes</a></li></ol></li><li><a href="links.html#matching-html-elements-using-selectors"><span class="secno">4.14 </span>Matching HTML elements using selectors</a>
<ol><li><a href="links.html#selectors"><span class="secno">4.14.1 </span>Case-sensitivity</a></li><li><a href="links.html#pseudo-classes"><span class="secno">4.14.2 </span>Pseudo-classes</a></li></ol></li></ol></li></ol></div><h3 id="links"><span class="secno">4.12 </span>Links</h3><h4 id="introduction-3"><span class="secno">4.12.1 </span>Introduction</h4><p>Links are a conceptual construct, created by <code><a href="text-level-semantics.html#the-a-element">a</a></code>,
<code><a href="the-map-element.html#the-area-element">area</a></code>, and <code><a href="semantics.html#the-link-element">link</a></code> elements, that <a href="rendering.html#represents" title="represents">represent</a> a connection between two
@@ -401,12 +404,12 @@
agents must not use metadata included in the link to the resource to
determine its type.</span></p><div class="impl">
- <h4 id="following-hyperlinks"><span class="secno">4.12.3 </span><dfn>Following hyperlinks</dfn></h4>
+ <h4 id="following-hyperlinks-0"><span class="secno">4.12.3 </span>Following hyperlinks</h4>
- <p>When a user <em>follows a hyperlink</em> created by an element,
- the user agent must <a href="urls.html#resolve-a-url" title="resolve a url">resolve</a> the
- <a href="urls.html#url">URL</a> given by the <code title="attr-hyperlink-href"><a href="#attr-hyperlink-href">href</a></code> attribute of that element,
- relative to that element, and if that is successful, must
+ <p>When a user <dfn id="following-hyperlinks" title="following hyperlinks">follows a
+ hyperlink</dfn> created by an element, the user agent must <a href="urls.html#resolve-a-url" title="resolve a url">resolve</a> the <a href="urls.html#url">URL</a> given by
+ the <code title="attr-hyperlink-href"><a href="#attr-hyperlink-href">href</a></code> attribute of that
+ element, relative to that element, and if that is successful, must
<a href="history.html#navigate">navigate</a> a <a href="browsers.html#browsing-context">browsing
context</a> to the resulting <a href="urls.html#absolute-url">absolute URL</a>. In the
case of server-side image maps, that <a href="urls.html#absolute-url">absolute URL</a> must
@@ -434,10 +437,12 @@
new <a href="browsers.html#browsing-context">browsing context</a>, it must be navigated with
<a href="history.html#replacement-enabled">replacement enabled</a>.</p>
- <p>Otherwise, if the hyperlink is a <a href="#rel-sidebar-hyperlink" title="rel-sidebar-hyperlink">sidebar hyperlink</a> and the user
- agent implements a feature that can be considered a secondary
- browsing context, such a secondary browsing context may be selected
- as the browsing context to be navigated.</p>
+
+ <p>Otherwise, if the hyperlink is a <dfn id="rel-sidebar-hyperlink" title="rel-sidebar-hyperlink">sidebar hyperlink</dfn> and the user
+ agent implements a feature that can be considered a <a href="browsers.html#secondary-browsing-context">secondary
+ browsing context</a>, such a <a href="browsers.html#secondary-browsing-context">secondary browsing
+ context</a> may be selected as the browsing context to be
+ navigated.</p>
<p>Otherwise, if the element is an <code><a href="text-level-semantics.html#the-a-element">a</a></code> or
<code><a href="the-map-element.html#the-area-element">area</a></code> element with no <code title="attr-hyperlink-target"><a href="#attr-hyperlink-target">target</a></code> attribute, but the
@@ -473,10 +478,7 @@
</div><p>Except where otherwise specified, a keyword must not be specified
more than once per <code title="attr-hyperlink-rel"><a href="#attr-hyperlink-rel">rel</a></code>
- attribute.</p><p>The link types that contain no U+003A COLON characters (:),
- including all those defined in this specification, are <a href="infrastructure.html#ascii-case-insensitive">ASCII
- case-insensitive</a> values<span class="impl">, and must be
- compared as such</span>.</p><p class="example">Thus, <code title="">rel="next"</code> is the
+ attribute.</p><p>Link types are always <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a><span class="impl">, and must be compared as such</span>.</p><p class="example">Thus, <code title="">rel="next"</code> is the
same as <code title="">rel="NEXT"</code>.</p><table><thead><tr><th rowspan="2">Link type</th>
<th colspan="2">Effect on...</th>
<th rowspan="2">Brief description</th>
@@ -494,10 +496,6 @@
<td><em>not allowed</em></td>
<td><a href="#hyperlink">Hyperlink</a></td>
<td>Gives the permalink for the nearest ancestor section.</td>
- </tr><tr><td><code title="rel-external"><a href="#link-type-external">external</a></code></td>
- <td><em>not allowed</em></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td>Indicates that the referenced document is not part of the same site as the current document.</td>
</tr><tr><td><code title="rel-help"><a href="#link-type-help">help</a></code></td>
<td><a href="#hyperlink">Hyperlink</a></td>
<td><a href="#hyperlink">Hyperlink</a></td>
@@ -538,16 +536,12 @@
<td><a href="#hyperlink">Hyperlink</a></td>
<td><a href="#hyperlink">Hyperlink</a></td>
<td>Gives a link to a resource that can be used to search through the current document and its related pages.</td>
- </tr><tr><td><code title="rel-sidebar"><a href="#link-type-sidebar">sidebar</a></code></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
- <td>Specifies that the referenced document, if retrieved, is intended to be shown in the browser's sidebar (if it has one).</td>
</tr><tr><td><code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code></td>
<td><a href="#external-resource-link" title="external resource link">External Resource</a></td>
<td><em>not allowed</em></td>
<td>Imports a stylesheet.</td>
</tr><tr><td><code title="rel-tag"><a href="#link-type-tag">tag</a></code></td>
- <td><a href="#hyperlink">Hyperlink</a></td>
+ <td><em>not allowed</em></td>
<td><a href="#hyperlink">Hyperlink</a></td>
<td>Gives a tag (identified by the given address) that applies to the current document.</td>
</tr></tbody></table><div class="impl">
@@ -703,11 +697,7 @@
</article>
</body>
...</pre>
- </div><h5 id="link-type-external"><span class="secno">4.12.4.4 </span>Link type "<dfn title="rel-external"><code>external</code></dfn>"</h5><p>The <code title="rel-external"><a href="#link-type-external">external</a></code> keyword may be
- used with <code><a href="text-level-semantics.html#the-a-element">a</a></code> and <code><a href="the-map-element.html#the-area-element">area</a></code> elements. This
- keyword creates a <a href="#hyperlink">hyperlink</a>.</p><p>The <code title="rel-external"><a href="#link-type-external">external</a></code> keyword indicates
- that the link is leading to a document that is not part of the site
- that the current document forms a part of.</p><h5 id="link-type-help"><span class="secno">4.12.4.5 </span>Link type "<dfn title="rel-help"><code>help</code></dfn>"</h5><p>The <code title="rel-help"><a href="#link-type-help">help</a></code> keyword may be used with
+ </div><h5 id="link-type-help"><span class="secno">4.12.4.4 </span>Link type "<dfn title="rel-help"><code>help</code></dfn>"</h5><p>The <code title="rel-help"><a href="#link-type-help">help</a></code> keyword may be used with
<code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-map-element.html#the-area-element">area</a></code>
elements. This keyword creates a <a href="#hyperlink">hyperlink</a>.</p><p>For <code><a href="text-level-semantics.html#the-a-element">a</a></code> and <code><a href="the-map-element.html#the-area-element">area</a></code> elements, the <code title="rel-help"><a href="#link-type-help">help</a></code> keyword indicates that the referenced
document provides further help information for the parent of the
@@ -721,7 +711,9 @@
<pre> <p><label> Topic: <input name=topic> <a href="help/topic.html" rel="help">(Help)</a></label></p></pre>
</div><p>For <code><a href="semantics.html#the-link-element">link</a></code> elements, the <code title="rel-help"><a href="#link-type-help">help</a></code> keyword indicates that the referenced
- document provides help for the page as a whole.</p><h5 id="rel-icon"><span class="secno">4.12.4.6 </span>Link type "<dfn title="rel-icon"><code>icon</code></dfn>"</h5><p>The <code title="rel-icon"><a href="#rel-icon">icon</a></code> keyword may be used with
+ document provides help for the page as a whole.</p><p>For <code><a href="text-level-semantics.html#the-a-element">a</a></code> and <code><a href="the-map-element.html#the-area-element">area</a></code> elements, on some
+ browsers, the <code title="rel-help"><a href="#link-type-help">help</a></code> keyword causes the
+ link to use a different cursor.</p><h5 id="rel-icon"><span class="secno">4.12.4.5 </span>Link type "<dfn title="rel-icon"><code>icon</code></dfn>"</h5><p>The <code title="rel-icon"><a href="#rel-icon">icon</a></code> keyword may be used with
<code><a href="semantics.html#the-link-element">link</a></code> elements. This keyword creates an <a href="#external-resource-link" title="external resource link">external resource link</a>.</p><div class="impl">
<p>The specified resource is an icon representing the page or site,
@@ -732,26 +724,31 @@
icons. <span class="impl">If multiple icons are provided, the user
agent must select the most appropriate icon according to the <code title="attr-link-type"><a href="semantics.html#attr-link-type">type</a></code>, <code title="attr-link-media"><a href="semantics.html#attr-link-media">media</a></code>, and <code title="attr-link-sizes"><a href="#attr-link-sizes">sizes</a></code> attributes. If there are
multiple equally appropriate icons, user agents must use the last
- one declared in <a href="infrastructure.html#tree-order">tree order</a>. If the user agent tries to
- use an icon but that icon is determined, upon closer examination, to
- in fact be inappropriate (e.g. because it uses an unsupported
- format), then the user agent must try the next-most-appropriate icon
- as determined by the attributes.</span></p><div class="impl">
+ one declared in <a href="infrastructure.html#tree-order">tree order</a> at the time that the user
+ agent collected the list of icons. If the user agent tries to use an
+ icon but that icon is determined, upon closer examination, to in
+ fact be inappropriate (e.g. because it uses an unsupported format),
+ then the user agent must try the next-most-appropriate icon as
+ determined by the attributes.</span></p><div class="impl">
+
+ <p class="note">User agents are not required to update icons when
+ the list of icons changes, but are encouraged to do so.</p>
<p>There is no default type for resources given by the <code title="rel-icon"><a href="#rel-icon">icon</a></code> keyword. However, for the purposes of
<a href="semantics.html#concept-link-type-sniffing">determining the type of the
resource</a>, user agents must expect the resource to be an image.</p>
</div><p>The <dfn id="attr-link-sizes" title="attr-link-sizes"><code>sizes</code></dfn>
- attribute gives the sizes of icons for visual media.</p><p>If specified, the attribute must have a value that is an
- <a href="common-microsyntaxes.html#unordered-set-of-unique-space-separated-tokens">unordered set of unique space-separated tokens</a>, which
- are <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a>. The values must all be
- either an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for the string
- "<code title="attr-link-sizes-any"><a href="#attr-link-sizes-any">any</a></code>", or a value that
- consists of two <a href="common-microsyntaxes.html#valid-non-negative-integer" title="valid non-negative integer">valid
- non-negative integers</a> that do not have a leading U+0030 DIGIT
- ZERO (0) character and that are separated by a single U+0078 LATIN
- SMALL LETTER X or U+0058 LATIN CAPITAL LETTER X character.</p><p>The keywords represent icon sizes.</p><div class="impl">
+ attribute gives the sizes of icons for visual media. Its value, if
+ present, is merely advisory. User agents may use the value to decide
+ which icon(s) to use if multiple icons are available.</p><p>If specified, the attribute must have a value that is an
+ <a href="common-microsyntaxes.html#unordered-set-of-unique-space-separated-tokens">unordered set of unique space-separated tokens</a> which
+ are <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a>. Each value must be either
+ an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for the string "<code title="attr-link-sizes-any"><a href="#attr-link-sizes-any">any</a></code>", or a value that consists of
+ two <a href="common-microsyntaxes.html#valid-non-negative-integer" title="valid non-negative integer">valid non-negative
+ integers</a> that do not have a leading U+0030 DIGIT ZERO (0)
+ character and that are separated by a single U+0078 LATIN SMALL
+ LETTER X or U+0058 LATIN CAPITAL LETTER X character.</p><p>The keywords represent icon sizes.</p><div class="impl">
<p>To parse and process the attribute's value, the user agent must
first <a href="common-microsyntaxes.html#split-a-string-on-spaces" title="split a string on spaces">split the attribute's
@@ -796,10 +793,6 @@
icon sizes that are not actually available in the linked
resource.</p><div class="impl">
- <p>If the attribute is not specified, then the user agent must
- assume that the given icon is appropriate, but less appropriate than
- an icon of a known and appropriate size.</p>
-
<p>In the absence of a <code><a href="semantics.html#the-link-element">link</a></code> with the <code title="rel-icon"><a href="#rel-icon">icon</a></code> keyword, for <code><a href="infrastructure.html#document">Document</a></code>s
obtained over HTTP or HTTPS, user agents may instead attempt to
<a href="fetching-resources.html#fetch">fetch</a> and use an icon with the <a href="urls.html#absolute-url">absolute
@@ -828,7 +821,10 @@
<body>
...</pre>
- </div><h5 id="link-type-license"><span class="secno">4.12.4.7 </span>Link type "<dfn title="rel-license"><code>license</code></dfn>"</h5><p>The <code title="rel-license"><a href="#link-type-license">license</a></code> keyword may be used
+ </div><p>For historical reasons, the <code title="rel-icon"><a href="#rel-icon">icon</a></code>
+ keyword may be preceded by the keyword "<code title="">shortcut</code>". If the "<code title="">shortcut</code>"
+ keyword is present, it must be come immediately before the <code title="rel-icon"><a href="#rel-icon">icon</a></code> keyword and the two keywords must be
+ separated by only a single U+0020 SPACE character.</p><h5 id="link-type-license"><span class="secno">4.12.4.6 </span>Link type "<dfn title="rel-license"><code>license</code></dfn>"</h5><p>The <code title="rel-license"><a href="#link-type-license">license</a></code> keyword may be used
with <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-map-element.html#the-area-element">area</a></code>
elements. This keyword creates a <a href="#hyperlink">hyperlink</a>.</p><p>The <code title="rel-license"><a href="#link-type-license">license</a></code> keyword indicates
that the referenced document provides the copyright license terms
@@ -881,7 +877,7 @@
must also treat the keyword "<code title="">copyright</code>" like
the <code title="rel-license"><a href="#link-type-license">license</a></code> keyword.</p>
- </div><h5 id="link-type-nofollow"><span class="secno">4.12.4.8 </span>Link type "<dfn title="rel-nofollow"><code>nofollow</code></dfn>"</h5><p>The <code title="rel-nofollow"><a href="#link-type-nofollow">nofollow</a></code> keyword may be
+ </div><h5 id="link-type-nofollow"><span class="secno">4.12.4.7 </span>Link type "<dfn title="rel-nofollow"><code>nofollow</code></dfn>"</h5><p>The <code title="rel-nofollow"><a href="#link-type-nofollow">nofollow</a></code> keyword may be
used with <code><a href="text-level-semantics.html#the-a-element">a</a></code> and <code><a href="the-map-element.html#the-area-element">area</a></code> elements. This
keyword does not create a <a href="#hyperlink">hyperlink</a>, but <a href="#hyperlink-annotation" title="hyperlink annotation">annotates</a> any other hyperlinks
created by the element (the implied hyperlink, if no other keywords
@@ -889,7 +885,7 @@
that the link is not endorsed by the original author or publisher of
the page, or that the link to the referenced document was included
primarily because of a commercial relationship between people
- affiliated with the two pages.</p><h5 id="link-type-noreferrer"><span class="secno">4.12.4.9 </span>Link type "<dfn title="rel-noreferrer"><code>noreferrer</code></dfn>"</h5><p>The <code title="rel-noreferrer"><a href="#link-type-noreferrer">noreferrer</a></code> keyword may be
+ affiliated with the two pages.</p><h5 id="link-type-noreferrer"><span class="secno">4.12.4.8 </span>Link type "<dfn title="rel-noreferrer"><code>noreferrer</code></dfn>"</h5><p>The <code title="rel-noreferrer"><a href="#link-type-noreferrer">noreferrer</a></code> keyword may be
used with <code><a href="text-level-semantics.html#the-a-element">a</a></code> and <code><a href="the-map-element.html#the-area-element">area</a></code> elements. This
keyword does not create a <a href="#hyperlink">hyperlink</a>, but <a href="#hyperlink-annotation" title="hyperlink annotation">annotates</a> any other hyperlinks
created by the element (the implied hyperlink, if no other keywords
@@ -905,25 +901,20 @@
<p>This keyword also <a href="browsers.html#noopener">causes the <code title="dom-opener">opener</code> attribute to remain null</a> if the
hyperlink creates a new <a href="browsers.html#browsing-context">browsing context</a>.</p>
- </div><h5 id="link-type-pingback"><span class="secno">4.12.4.10 </span>Link type "<dfn title="rel-pingback"><code>pingback</code></dfn>"</h5><p>The <code title="rel-pingback"><a href="#link-type-pingback">pingback</a></code> keyword may be
+ </div><h5 id="link-type-pingback"><span class="secno">4.12.4.9 </span>Link type "<dfn title="rel-pingback"><code>pingback</code></dfn>"</h5><p>The <code title="rel-pingback"><a href="#link-type-pingback">pingback</a></code> keyword may be
used with <code><a href="semantics.html#the-link-element">link</a></code> elements. This keyword creates an <a href="#external-resource-link" title="external resource link">external resource link</a>.</p><p>For the semantics of the <code title="rel-pingback"><a href="#link-type-pingback">pingback</a></code> keyword, see the Pingback 1.0
- specification. <a href="references.html#refsPINGBACK">[PINGBACK]</a></p><h5 id="link-type-prefetch"><span class="secno">4.12.4.11 </span>Link type "<dfn title="rel-prefetch"><code>prefetch</code></dfn>"</h5><p>The <code title="rel-prefetch"><a href="#link-type-prefetch">prefetch</a></code> keyword may be
+ specification. <a href="references.html#refsPINGBACK">[PINGBACK]</a></p><h5 id="link-type-prefetch"><span class="secno">4.12.4.10 </span>Link type "<dfn title="rel-prefetch"><code>prefetch</code></dfn>"</h5><p>The <code title="rel-prefetch"><a href="#link-type-prefetch">prefetch</a></code> keyword may be
used with <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-map-element.html#the-area-element">area</a></code>
elements. This keyword creates an <a href="#external-resource-link" title="external resource link">external resource link</a>.</p><p>The <code title="rel-prefetch"><a href="#link-type-prefetch">prefetch</a></code> keyword indicates
that preemptively fetching and caching the specified resource is
likely to be beneficial, as it is highly likely that the user will
- require this resource.</p><p>There is no default type for resources given by the <code title="rel-prefetch"><a href="#link-type-prefetch">prefetch</a></code> keyword.</p><h5 id="link-type-search"><span class="secno">4.12.4.12 </span>Link type "<dfn title="rel-search"><code>search</code></dfn>"</h5><p>The <code title="rel-search"><a href="#link-type-search">search</a></code> keyword may be used
+ require this resource.</p><p>There is no default type for resources given by the <code title="rel-prefetch"><a href="#link-type-prefetch">prefetch</a></code> keyword.</p><h5 id="link-type-search"><span class="secno">4.12.4.11 </span>Link type "<dfn title="rel-search"><code>search</code></dfn>"</h5><p>The <code title="rel-search"><a href="#link-type-search">search</a></code> keyword may be used
with <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-map-element.html#the-area-element">area</a></code>
elements. This keyword creates a <a href="#hyperlink">hyperlink</a>.</p><p>The <code title="rel-search"><a href="#link-type-search">search</a></code> keyword indicates that
the referenced document provides an interface specifically for
searching the document and its related resources.</p><p class="note">OpenSearch description documents can be used with
<code><a href="semantics.html#the-link-element">link</a></code> elements and the <code title="rel-search"><a href="#link-type-search">search</a></code> link type to enable user agents to
- autodiscover search interfaces. <a href="references.html#refsOPENSEARCH">[OPENSEARCH]</a></p><h5 id="link-type-sidebar"><span class="secno">4.12.4.13 </span>Link type "<dfn title="rel-sidebar"><code>sidebar</code></dfn>"</h5><p>The <code title="rel-sidebar"><a href="#link-type-sidebar">sidebar</a></code> keyword may be used
- with <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-map-element.html#the-area-element">area</a></code>
- elements. This keyword creates a <a href="#hyperlink">hyperlink</a>.</p><p>The <code title="rel-sidebar"><a href="#link-type-sidebar">sidebar</a></code> keyword indicates
- that the referenced document, if retrieved, is intended to be shown
- in a <a href="browsers.html#secondary-browsing-context">secondary browsing context</a> (if possible), instead
- of in the current <a href="browsers.html#browsing-context">browsing context</a>.</p><p>A <a href="#hyperlink">hyperlink</a> with the <code title="rel-sidebar"><a href="#link-type-sidebar">sidebar</a></code> keyword specified is a <dfn id="rel-sidebar-hyperlink" title="rel-sidebar-hyperlink">sidebar hyperlink</dfn>.</p><h5 id="link-type-stylesheet"><span class="secno">4.12.4.14 </span>Link type "<dfn title="rel-stylesheet"><code>stylesheet</code></dfn>"</h5><p>The <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code> keyword may be
+ autodiscover search interfaces. <a href="references.html#refsOPENSEARCH">[OPENSEARCH]</a></p><h5 id="link-type-stylesheet"><span class="secno">4.12.4.12 </span>Link type "<dfn title="rel-stylesheet"><code>stylesheet</code></dfn>"</h5><p>The <code title="rel-stylesheet"><a href="#link-type-stylesheet">stylesheet</a></code> keyword may be
used with <code><a href="semantics.html#the-link-element">link</a></code> elements. This keyword creates an <a href="#external-resource-link" title="external resource link">external resource link</a> that
contributes to the <a href="semantics.html#styling">styling processing model</a>.</p><p>The specified resource is a resource that describes how to
present the document. Exactly how the resource is to be processed
@@ -939,27 +930,27 @@
defer obtaining the resource until it is part of the <span>preferred
style sheet set</span>. <a href="references.html#refsCSSOM">[CSSOM]</a></p>
<p><strong>Quirk</strong>: If the document has been set to
- <a href="dom.html#quirks-mode">quirks mode</a>, has the <a href="origin-0.html#same-origin">same origin</a> as the
+ <a href="infrastructure.html#quirks-mode">quirks mode</a>, has the <a href="origin-0.html#same-origin">same origin</a> as the
<a href="urls.html#url">URL</a> of the external resource<!-- CVE-2010-0654 -->, and
the <a href="fetching-resources.html#content-type" title="Content-Type">Content-Type metadata</a> of the
external resource is not a supported style sheet type, the user
agent must instead assume it to be <code title="">text/css</code>.</p>
- </div><h5 id="link-type-tag"><span class="secno">4.12.4.15 </span>Link type "<dfn title="rel-tag"><code>tag</code></dfn>"</h5><p>The <code title="rel-tag"><a href="#link-type-tag">tag</a></code> keyword may be used
- with <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-map-element.html#the-area-element">area</a></code>
- elements. This keyword creates a <a href="#hyperlink">hyperlink</a>.</p><p>The <code title="rel-tag"><a href="#link-type-tag">tag</a></code> keyword indicates that the
+ </div><h5 id="link-type-tag"><span class="secno">4.12.4.13 </span>Link type "<dfn title="rel-tag"><code>tag</code></dfn>"</h5><p>The <code title="rel-tag"><a href="#link-type-tag">tag</a></code> keyword may be used with
+ <code><a href="text-level-semantics.html#the-a-element">a</a></code> and <code><a href="the-map-element.html#the-area-element">area</a></code> elements. This keyword creates
+ a <a href="#hyperlink">hyperlink</a>.</p><p>The <code title="rel-tag"><a href="#link-type-tag">tag</a></code> keyword indicates that the
<em>tag</em> that the referenced document represents applies to the
current document.</p><p class="note">Since it indicates that the tag <em>applies to the
current document</em>, it would be inappropriate to use this keyword
in the markup of a <a href="#tag-cloud">tag cloud</a>, which lists
- the popular tag across a set of pages.</p><h5 id="sequential-link-types"><span class="secno">4.12.4.16 </span>Sequential link types</h5><p>Some documents form part of a sequence of documents.</p><p>A sequence of documents is one where each document can have a
+ the popular tags across a set of pages.</p><h5 id="sequential-link-types"><span class="secno">4.12.4.14 </span>Sequential link types</h5><p>Some documents form part of a sequence of documents.</p><p>A sequence of documents is one where each document can have a
<em>previous sibling</em> and a <em>next sibling</em>. A document
with no previous sibling is the start of its sequence, a document
- with no next sibling is the end of its sequence.</p><p>A document may be part of multiple sequences.</p><h6 id="link-type-next"><span class="secno">4.12.4.16.1 </span>Link type "<dfn title="rel-next"><code>next</code></dfn>"</h6><p>The <code title="rel-next"><a href="#link-type-next">next</a></code> keyword may be used with
+ with no next sibling is the end of its sequence.</p><p>A document may be part of multiple sequences.</p><h6 id="link-type-next"><span class="secno">4.12.4.14.1 </span>Link type "<dfn title="rel-next"><code>next</code></dfn>"</h6><p>The <code title="rel-next"><a href="#link-type-next">next</a></code> keyword may be used with
<code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-map-element.html#the-area-element">area</a></code>
elements. This keyword creates a <a href="#hyperlink">hyperlink</a>.</p><p>The <code title="rel-next"><a href="#link-type-next">next</a></code> keyword indicates that the
document is part of a sequence, and that the link is leading to the
- document that is the next logical document in the sequence.</p><h6 id="link-type-prev"><span class="secno">4.12.4.16.2 </span>Link type "<dfn title="rel-prev"><code>prev</code></dfn>"</h6><p>The <code title="rel-prev"><a href="#link-type-prev">prev</a></code> keyword may be used with
+ document that is the next logical document in the sequence.</p><h6 id="link-type-prev"><span class="secno">4.12.4.14.2 </span>Link type "<dfn title="rel-prev"><code>prev</code></dfn>"</h6><p>The <code title="rel-prev"><a href="#link-type-prev">prev</a></code> keyword may be used with
<code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-map-element.html#the-area-element">area</a></code>
elements. This keyword creates a <a href="#hyperlink">hyperlink</a>.</p><p>The <code title="rel-prev"><a href="#link-type-prev">prev</a></code> keyword indicates that the
document is part of a sequence, and that the link is leading to the
@@ -969,8 +960,8 @@
must also treat the keyword "<code title="">previous</code>" like
the <code title="rel-prev"><a href="#link-type-prev">prev</a></code> keyword.</p>
- </div><h5 id="other-link-types"><span class="secno">4.12.4.17 </span>Other link types</h5><p><dfn id="concept-rel-extensions" title="concept-rel-extensions">Extensions to the predefined
- set of link types</dfn> may be registered in the <a href="http://microformats.org/wiki/existing-rel-values">Microformats wiki existing-rel-values page</a>. <a href="references.html#refsMFREL">[MFREL]</a></p><p>Anyone is free to edit the <span title="">Microformats wiki
+ </div><h5 id="other-link-types"><span class="secno">4.12.4.15 </span>Other link types</h5><p><dfn id="concept-rel-extensions" title="concept-rel-extensions">Extensions to the predefined
+ set of link types</dfn> may be registered in the <a href="http://microformats.org/wiki/existing-rel-values#HTML5_link_type_extensions">Microformats wiki existing-rel-values page</a>. <a href="references.html#refsMFREL">[MFREL]</a></p><p>Anyone is free to edit the <span title="">Microformats wiki
existing-rel-values page</span> at any time to add a type. Extension
types must be specified with the following information:</p><dl><dt>Keyword</dt>
@@ -1128,7 +1119,7 @@
add the value to the Wiki, with the details described above, with
the "proposed" status.</p>
- </div><p>Types defined as extensions in the <a href="http://microformats.org/wiki/existing-rel-values">Microformats
+ </div><p>Types defined as extensions in the <a href="http://microformats.org/wiki/existing-rel-values#HTML5_link_type_extensions">Microformats
wiki existing-rel-values page</a> with the status "proposed" or
"ratified" may be used with the <code title="">rel</code> attribute
on <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-a-element">a</a></code>, and <code><a href="the-map-element.html#the-area-element">area</a></code> elements
@@ -1473,16 +1464,16 @@
<h4 id="selectors"><span class="secno">4.14.1 </span>Case-sensitivity</h4>
<p>Attribute and element <em>names</em> of <a href="infrastructure.html#html-elements">HTML
- elements</a> in <a href="dom.html#html-documents">HTML documents</a> must be treated as
+ elements</a> in <a href="infrastructure.html#html-documents">HTML documents</a> must be treated as
<a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a>.</p>
<p>Classes from the <code title="attr-class"><a href="elements.html#classes">class</a></code> attribute
- of <a href="infrastructure.html#html-elements">HTML elements</a> in documents that are in <a href="dom.html#quirks-mode">quirks
+ of <a href="infrastructure.html#html-elements">HTML elements</a> in documents that are in <a href="infrastructure.html#quirks-mode">quirks
mode</a> must be treated as <a href="infrastructure.html#ascii-case-insensitive">ASCII
case-insensitive</a>.</p>
<p>Attribute selectors on an <a href="infrastructure.html#html-elements" title="HTML elements">HTML
- element</a> in an <a href="dom.html#html-documents" title="HTML documents">HTML
+ element</a> in an <a href="infrastructure.html#html-documents" title="HTML documents">HTML
document</a> must treat the <em>values</em> of attributes with
the following names as <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a>, with one
exception as noted below:</p>
@@ -1545,8 +1536,8 @@
<h4 id="pseudo-classes"><span class="secno">4.14.2 </span>Pseudo-classes</h4>
<p>There are a number of dynamic selectors that can be used with
- HTML. This section defines when these selectors match HTML
- elements.</p>
+ HTML. This section defines when these selectors match HTML elements.
+ <a href="references.html#refsSELECTORS">[SELECTORS]</a> <a href="references.html#refsCSSUI">[CSSUI]</a></p>
<dl><dt><dfn id="selector-link" title="selector-link"><code>:link</code></dfn></dt>
<dt><dfn id="selector-visited" title="selector-visited"><code>:visited</code></dfn></dt>
@@ -1654,7 +1645,7 @@
<li><code><a href="the-button-element.html#the-textarea-element">textarea</a></code> elements that are not <a href="association-of-controls-and-forms.html#concept-fe-disabled" title="concept-fe-disabled">disabled</a></li>
- <li><code><a href="the-button-element.html#the-optgroup-element">optgroup</a></code> elements that are not <span title="concept-optgroup-disabled">disabled</span></li>
+ <li><code><a href="the-button-element.html#the-optgroup-element">optgroup</a></code> elements that do not have a <code title="attr-optgroup-disabled"><a href="the-button-element.html#attr-optgroup-disabled">disabled</a></code> attribute</li>
<li><code><a href="the-button-element.html#the-option-element">option</a></code> elements that are not <a href="the-button-element.html#concept-option-disabled" title="concept-option-disabled">disabled</a></li>
@@ -1689,7 +1680,7 @@
<li><code><a href="the-button-element.html#the-textarea-element">textarea</a></code> elements that are <a href="association-of-controls-and-forms.html#concept-fe-disabled" title="concept-fe-disabled">disabled</a></li>
- <li><code><a href="the-button-element.html#the-optgroup-element">optgroup</a></code> elements that are <span title="concept-optgroup-disabled">disabled</span></li>
+ <li><code><a href="the-button-element.html#the-optgroup-element">optgroup</a></code> elements that have a <code title="attr-optgroup-disabled"><a href="the-button-element.html#attr-optgroup-disabled">disabled</a></code> attribute</li>
<li><code><a href="the-button-element.html#the-option-element">option</a></code> elements that are <a href="the-button-element.html#concept-option-disabled" title="concept-option-disabled">disabled</a></li>
@@ -1892,20 +1883,20 @@
</dd>
- <dt><dfn id="selector-ltr" title="selector-ltr"><code>:ltr</code></dfn></dt>
+ <dt><dfn id="selector-ltr" title="selector-ltr"><code>:dir(ltr)</code></dfn></dt>
<dd>
- <p>The <code title="selector-ltr"><a href="#selector-ltr">:ltr</a></code> pseudo-class must
+ <p>The <code title="selector-ltr"><a href="#selector-ltr">:dir(ltr)</a></code> pseudo-class must
match all elements whose <a href="elements.html#the-directionality" title="the directionality">directionality</a> is '<a href="elements.html#concept-ltr" title="concept-ltr">ltr</a>'.</p>
</dd>
- <dt><dfn id="selector-rtl" title="selector-rtl"><code>:rtl</code></dfn></dt>
+ <dt><dfn id="selector-rtl" title="selector-rtl"><code>:dir(rtl)</code></dfn></dt>
<dd>
- <p>The <code title="selector-rtl"><a href="#selector-rtl">:rtl</a></code> pseudo-class must
+ <p>The <code title="selector-rtl"><a href="#selector-rtl">:dir(rtl)</a></code> pseudo-class must
match all elements whose <a href="elements.html#the-directionality" title="the directionality">directionality</a> is '<a href="elements.html#concept-rtl" title="concept-rtl">rtl</a>'.</p>
</dd>
Index: spec.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/spec.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- spec.html 17 Jun 2011 08:49:07 -0000 1.15
+++ spec.html 24 Aug 2011 07:56:04 -0000 1.16
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -320,7 +323,7 @@
<h1>HTML5</h1>
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id="editor-s-draft-17-june-2011">Editor's Draft 17 June 2011</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-23-august-2011">Editor's Draft 23 August 2011</h2>
<dl><dt>Latest Published Version:</dt>
<dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
<dt>Latest Editor's Draft:</dt>
@@ -345,10 +348,10 @@
<a href="Overview.html">single page HTML</a>,
<a href="spec.html">multipage HTML</a>,
<a href="author/">web developer edition</a>.
-This is revision 1.5014.
+This is revision 1.5222.
</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
- © 2011 <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.org/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C
+ © 2011 <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>
and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document
@@ -370,10 +373,12 @@
given to defining clear conformance criteria for user agents in an
effort to improve interoperability.</p><h2 class="no-num no-toc" id="status-of-this-document">Status of This document</h2><p><em>This section describes the status of this document at the
time of its publication. Other documents may supersede this
- document. A list of current W3C publications and the most recently
- formally published revision of this technical report can be found in
- the <a href="http://www.w3.org/TR/">W3C technical reports index</a>
- at http://www.w3.org/TR/.</em></p><p>If you wish to make comments regarding this document in a manner
+ document. A list of current W3C publications and the
+
+ most recently formally published <!-- DO NOT CHANGE THIS BACK TO THE STANDARD BOILERPLATE, AS IT IS INACCURATE -->
+
+ revision of this technical report can be found in the <a href="http://www.w3.org/TR/">W3C technical reports index</a> at
+ http://www.w3.org/TR/.</em></p><p>If you wish to make comments regarding this document in a manner
that is tracked by the W3C, please submit them via using <a href="http://www.w3.org/Bugs/Public/enter_bug.cgi?product=HTML%20WG">our
public bug database</a>. If you do not have an account then you can
enter feedback using this form:</p><form action="http://www.whatwg.org/specs/web-apps/current-work/file-spam.cgi" method="post">
@@ -453,8 +458,6 @@
HTML specifications:</p><dl><dt>E-mail notifications of changes</dt>
<dd>HTML-Diffs mailing list (diff-marked HTML versions for each change): <a href="http://lists.w3.org/Archives/Public/public-html-diffs/latest">http://lists.w3.org/Archives/Public/public-html-diffs/latest</a></dd>
<dd>Commit-Watchers mailing list (complete source diffs): <a href="http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org">http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org</a></dd>
- <dt>Real-time notifications of changes:</dt>
- <dd>Generated diff-marked HTML versions for each change: <a href="http://twitter.com/HTML5">http://twitter.com/HTML5</a></dd>
<dt>Browsable version-control record of all changes:</dt>
<dd>CVSWeb interface with side-by-side diffs: <a href="http://dev.w3.org/cvsweb/html5/">http://dev.w3.org/cvsweb/html5/</a></dd>
<dd>Annotated summary with unified diffs: <a href="http://html5.org/tools/web-apps-tracker">http://html5.org/tools/web-apps-tracker</a></dd>
@@ -463,7 +466,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 17 June 2011 Editor's Draft.
+ This specification is the 23 August 2011 Editor's Draft.
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -485,7 +488,9 @@
<li><a href="introduction.html#structure-of-this-specification"><span class="secno">1.7 </span>Structure of this specification</a>
<ol><li><a href="introduction.html#how-to-read-this-specification"><span class="secno">1.7.1 </span>How to read this specification</a></li>
<li><a href="introduction.html#typographic-conventions"><span class="secno">1.7.2 </span>Typographic conventions</a></li></ol></li>
- <li><a href="introduction.html#a-quick-introduction-to-html"><span class="secno">1.8 </span>A quick introduction to HTML</a></li>
+ <li><a href="introduction.html#a-quick-introduction-to-html"><span class="secno">1.8 </span>A quick introduction to HTML</a>
+ <ol><li><a href="introduction.html#writing-secure-applications-with-html"><span class="secno">1.8.1 </span>Writing secure applications with HTML</a></li>
+ <li><a href="introduction.html#common-pitfalls-to-avoid-when-using-the-scripting-apis"><span class="secno">1.8.2 </span>Common pitfalls to avoid when using the scripting APIs</a></li></ol></li>
<li><a href="introduction.html#conformance-requirements-for-authors"><span class="secno">1.9 </span>Conformance requirements for authors</a>
<ol><li><a href="introduction.html#presentational-markup"><span class="secno">1.9.1 </span>Presentational markup</a></li>
<li><a href="introduction.html#syntax-errors"><span class="secno">1.9.2 </span>Syntax errors</a></li>
@@ -512,7 +517,7 @@
<li><a href="common-microsyntaxes.html#numbers"><span class="secno">2.5.4 </span>Numbers</a>
<ol><li><a href="common-microsyntaxes.html#non-negative-integers"><span class="secno">2.5.4.1 </span>Non-negative integers</a></li>
<li><a href="common-microsyntaxes.html#signed-integers"><span class="secno">2.5.4.2 </span>Signed integers</a></li>
- <li><a href="common-microsyntaxes.html#real-numbers"><span class="secno">2.5.4.3 </span>Real numbers</a></li>
+ <li><a href="common-microsyntaxes.html#floating-point-numbers"><span class="secno">2.5.4.3 </span>Floating-point numbers</a></li>
<li><a href="common-microsyntaxes.html#percentages-and-dimensions"><span class="secno">2.5.4.4 </span>Percentages and lengths</a></li>
<li><a href="common-microsyntaxes.html#lists-of-integers"><span class="secno">2.5.4.5 </span>Lists of integers</a></li>
<li><a href="common-microsyntaxes.html#lists-of-dimensions"><span class="secno">2.5.4.6 </span>Lists of dimensions</a></li></ol></li>
@@ -546,17 +551,14 @@
<li><a href="common-dom-interfaces.html#common-dom-interfaces"><span class="secno">2.8 </span>Common DOM interfaces</a>
<ol><li><a href="common-dom-interfaces.html#reflecting-content-attributes-in-idl-attributes"><span class="secno">2.8.1 </span>Reflecting content attributes in IDL attributes</a></li>
<li><a href="common-dom-interfaces.html#collections-0"><span class="secno">2.8.2 </span>Collections</a>
- <ol><li><a href="common-dom-interfaces.html#htmlcollection-0"><span class="secno">2.8.2.1 </span>HTMLCollection</a></li>
- <li><a href="common-dom-interfaces.html#htmlallcollection-0"><span class="secno">2.8.2.2 </span>HTMLAllCollection</a></li>
- <li><a href="common-dom-interfaces.html#htmlformcontrolscollection-0"><span class="secno">2.8.2.3 </span>HTMLFormControlsCollection</a></li>
- <li><a href="common-dom-interfaces.html#htmloptionscollection-0"><span class="secno">2.8.2.4 </span>HTMLOptionsCollection</a></li></ol></li>
- <li><a href="common-dom-interfaces.html#domtokenlist-0"><span class="secno">2.8.3 </span>DOMTokenList</a></li>
- <li><a href="common-dom-interfaces.html#domsettabletokenlist-0"><span class="secno">2.8.4 </span>DOMSettableTokenList</a></li>
+ <ol><li><a href="common-dom-interfaces.html#htmlallcollection-0"><span class="secno">2.8.2.1 </span>HTMLAllCollection</a></li>
+ <li><a href="common-dom-interfaces.html#htmlformcontrolscollection-0"><span class="secno">2.8.2.2 </span>HTMLFormControlsCollection</a></li>
+ <li><a href="common-dom-interfaces.html#htmloptionscollection-0"><span class="secno">2.8.2.3 </span>HTMLOptionsCollection</a></li></ol></li>
+ <li><a href="common-dom-interfaces.html#domstringmap-0"><span class="secno">2.8.3 </span>DOMStringMap</a></li>
+ <li><a href="common-dom-interfaces.html#transferable-objects"><span class="secno">2.8.4 </span>Transferable objects</a></li>
<li><a href="common-dom-interfaces.html#safe-passing-of-structured-data"><span class="secno">2.8.5 </span>Safe passing of structured data</a></li>
- <li><a href="common-dom-interfaces.html#domstringmap-0"><span class="secno">2.8.6 </span>DOMStringMap</a></li>
- <li><a href="common-dom-interfaces.html#dom-feature-strings"><span class="secno">2.8.7 </span>DOM feature strings</a></li>
- <li><a href="common-dom-interfaces.html#exceptions"><span class="secno">2.8.8 </span>Exceptions</a></li>
- <li><a href="common-dom-interfaces.html#garbage-collection"><span class="secno">2.8.9 </span>Garbage collection</a></li></ol></li>
+ <li><a href="common-dom-interfaces.html#dom-feature-strings"><span class="secno">2.8.6 </span>DOM feature strings</a></li>
+ <li><a href="common-dom-interfaces.html#garbage-collection"><span class="secno">2.8.7 </span>Garbage collection</a></li></ol></li>
<li><a href="namespaces.html#namespaces"><span class="secno">2.9 </span>Namespaces</a></li></ol></li>
<li><a href="dom.html#dom"><span class="secno">3 </span>Semantics, structure, and APIs of HTML documents</a>
<ol><li><a href="dom.html#documents"><span class="secno">3.1 </span>Documents</a>
@@ -564,8 +566,7 @@
<li><a href="dom.html#security-document"><span class="secno">3.1.2 </span>Security</a></li>
<li><a href="dom.html#resource-metadata-management"><span class="secno">3.1.3 </span>Resource metadata management</a></li>
<li><a href="dom.html#dom-tree-accessors"><span class="secno">3.1.4 </span>DOM tree accessors</a></li>
- <li><a href="dom.html#creating-documents"><span class="secno">3.1.5 </span>Creating documents</a></li>
- <li><a href="dom.html#loading-xml-documents"><span class="secno">3.1.6 </span>Loading XML documents</a></li></ol></li>
+ <li><a href="dom.html#loading-xml-documents"><span class="secno">3.1.5 </span>Loading XML documents</a></li></ol></li>
<li><a href="elements.html#elements"><span class="secno">3.2 </span>Elements</a>
<ol><li><a href="elements.html#semantics-0"><span class="secno">3.2.1 </span>Semantics</a></li>
<li><a href="elements.html#elements-in-the-dom"><span class="secno">3.2.2 </span>Elements in the DOM</a></li>
@@ -595,16 +596,15 @@
<li><a href="content-models.html#requirements-relating-to-bidirectional-algorithm-formatting-characters"><span class="secno">3.2.6 </span>Requirements relating to bidirectional-algorithm formatting
characters</a></li>
<li><a href="content-models.html#wai-aria"><span class="secno">3.2.7 </span>WAI-ARIA</a></li></ol></li>
- <li><a href="apis-in-html-documents.html#apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</a></li>
- <li><a href="apis-in-html-documents.html#interactions-with-xpath-and-xslt"><span class="secno">3.4 </span>Interactions with XPath and XSLT</a></li>
- <li><a href="apis-in-html-documents.html#dynamic-markup-insertion"><span class="secno">3.5 </span>Dynamic markup insertion</a>
- <ol><li><a href="apis-in-html-documents.html#opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</a></li>
- <li><a href="apis-in-html-documents.html#closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</a></li>
- <li><a href="apis-in-html-documents.html#document.write"><span class="secno">3.5.3 </span><code title="dom-document-write">document.write()</code></a></li>
- <li><a href="apis-in-html-documents.html#document.writeln"><span class="secno">3.5.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li>
- <li><a href="apis-in-html-documents.html#innerhtml"><span class="secno">3.5.5 </span><code title="dom-innerHTML">innerHTML</code></a></li>
- <li><a href="apis-in-html-documents.html#outerhtml"><span class="secno">3.5.6 </span><code title="dom-outerHTML">outerHTML</code></a></li>
- <li><a href="apis-in-html-documents.html#insertadjacenthtml"><span class="secno">3.5.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</code></a></li></ol></li></ol></li>
+ <li><a href="content-models.html#interactions-with-xpath-and-xslt"><span class="secno">3.3 </span>Interactions with XPath and XSLT</a></li>
+ <li><a href="content-models.html#dynamic-markup-insertion"><span class="secno">3.4 </span>Dynamic markup insertion</a>
+ <ol><li><a href="content-models.html#opening-the-input-stream"><span class="secno">3.4.1 </span>Opening the input stream</a></li>
+ <li><a href="content-models.html#closing-the-input-stream"><span class="secno">3.4.2 </span>Closing the input stream</a></li>
+ <li><a href="content-models.html#document.write"><span class="secno">3.4.3 </span><code title="dom-document-write">document.write()</code></a></li>
+ <li><a href="content-models.html#document.writeln"><span class="secno">3.4.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li>
+ <li><a href="content-models.html#innerhtml"><span class="secno">3.4.5 </span><code title="dom-innerHTML">innerHTML</code></a></li>
+ <li><a href="content-models.html#outerhtml"><span class="secno">3.4.6 </span><code title="dom-outerHTML">outerHTML</code></a></li>
+ <li><a href="content-models.html#insertadjacenthtml"><span class="secno">3.4.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</code></a></li></ol></li></ol></li>
<li><a href="semantics.html#semantics"><span class="secno">4 </span>The elements of HTML</a>
<ol><li><a href="semantics.html#the-root-element"><span class="secno">4.1 </span>The root element</a>
<ol><li><a href="semantics.html#the-html-element"><span class="secno">4.1.1 </span>The <code>html</code> element</a></li></ol></li>
@@ -725,7 +725,7 @@
<li><a href="the-iframe-element.html#playing-the-media-resource"><span class="secno">4.8.10.8 </span>Playing the media resource</a></li>
<li><a href="the-iframe-element.html#seeking"><span class="secno">4.8.10.9 </span>Seeking</a></li>
<li><a href="the-iframe-element.html#media-resources-with-multiple-media-tracks"><span class="secno">4.8.10.10 </span>Media resources with multiple media tracks</a>
- <ol><li><a href="the-iframe-element.html#tracklist-objects"><span class="secno">4.8.10.10.1 </span><code>TrackList</code> objects</a></li>
+ <ol><li><a href="the-iframe-element.html#audiotracklist-and-videotracklist-objects"><span class="secno">4.8.10.10.1 </span><code>AudioTrackList</code> and <code>VideoTrackList</code> objects</a></li>
<li><a href="the-iframe-element.html#selecting-specific-audio-and-video-tracks-declaratively"><span class="secno">4.8.10.10.2 </span>Selecting specific audio and video tracks declaratively</a></li></ol></li>
<li><a href="the-iframe-element.html#synchronising-multiple-media-elements"><span class="secno">4.8.10.11 </span>Synchronising multiple media elements</a>
<ol><li><a href="the-iframe-element.html#introduction-0"><span class="secno">4.8.10.11.1 </span>Introduction</a></li>
@@ -736,7 +736,8 @@
<li><a href="the-iframe-element.html#sourcing-in-band-text-tracks"><span class="secno">4.8.10.12.2 </span>Sourcing in-band text tracks</a></li>
<li><a href="the-iframe-element.html#sourcing-out-of-band-text-tracks"><span class="secno">4.8.10.12.3 </span>Sourcing out-of-band text tracks</a></li>
<li><a href="the-iframe-element.html#text-track-api"><span class="secno">4.8.10.12.4 </span>Text track API</a></li>
- <li><a href="the-iframe-element.html#cue-events"><span class="secno">4.8.10.12.5 </span>Event definitions</a></li></ol></li>
+ <li><a href="the-iframe-element.html#text-tracks-describing-chapters"><span class="secno">4.8.10.12.5 </span>Text tracks describing chapters</a></li>
+ <li><a href="the-iframe-element.html#cue-events"><span class="secno">4.8.10.12.6 </span>Event definitions</a></li></ol></li>
<li><a href="the-iframe-element.html#user-interface"><span class="secno">4.8.10.13 </span>User interface</a></li>
<li><a href="the-iframe-element.html#time-ranges"><span class="secno">4.8.10.14 </span>Time ranges</a></li>
<li><a href="the-iframe-element.html#mediaevents"><span class="secno">4.8.10.15 </span>Event summary</a></li>
@@ -878,27 +879,25 @@
<li><a href="links.html#links"><span class="secno">4.12 </span>Links</a>
<ol><li><a href="links.html#introduction-3"><span class="secno">4.12.1 </span>Introduction</a></li>
<li><a href="links.html#links-created-by-a-and-area-elements"><span class="secno">4.12.2 </span>Links created by <code>a</code> and <code>area</code> elements</a></li>
- <li><a href="links.html#following-hyperlinks"><span class="secno">4.12.3 </span>Following hyperlinks</a></li>
+ <li><a href="links.html#following-hyperlinks-0"><span class="secno">4.12.3 </span>Following hyperlinks</a></li>
<li><a href="links.html#linkTypes"><span class="secno">4.12.4 </span>Link types</a>
<ol><li><a href="links.html#rel-alternate"><span class="secno">4.12.4.1 </span>Link type "<code>alternate</code>"</a></li>
<li><a href="links.html#link-type-author"><span class="secno">4.12.4.2 </span>Link type "<code>author</code>"</a></li>
<li><a href="links.html#link-type-bookmark"><span class="secno">4.12.4.3 </span>Link type "<code>bookmark</code>"</a></li>
- <li><a href="links.html#link-type-external"><span class="secno">4.12.4.4 </span>Link type "<code>external</code>"</a></li>
- <li><a href="links.html#link-type-help"><span class="secno">4.12.4.5 </span>Link type "<code>help</code>"</a></li>
- <li><a href="links.html#rel-icon"><span class="secno">4.12.4.6 </span>Link type "<code>icon</code>"</a></li>
- <li><a href="links.html#link-type-license"><span class="secno">4.12.4.7 </span>Link type "<code>license</code>"</a></li>
- <li><a href="links.html#link-type-nofollow"><span class="secno">4.12.4.8 </span>Link type "<code>nofollow</code>"</a></li>
- <li><a href="links.html#link-type-noreferrer"><span class="secno">4.12.4.9 </span>Link type "<code>noreferrer</code>"</a></li>
- <li><a href="links.html#link-type-pingback"><span class="secno">4.12.4.10 </span>Link type "<code>pingback</code>"</a></li>
- <li><a href="links.html#link-type-prefetch"><span class="secno">4.12.4.11 </span>Link type "<code>prefetch</code>"</a></li>
- <li><a href="links.html#link-type-search"><span class="secno">4.12.4.12 </span>Link type "<code>search</code>"</a></li>
- <li><a href="links.html#link-type-sidebar"><span class="secno">4.12.4.13 </span>Link type "<code>sidebar</code>"</a></li>
- <li><a href="links.html#link-type-stylesheet"><span class="secno">4.12.4.14 </span>Link type "<code>stylesheet</code>"</a></li>
- <li><a href="links.html#link-type-tag"><span class="secno">4.12.4.15 </span>Link type "<code>tag</code>"</a></li>
- <li><a href="links.html#sequential-link-types"><span class="secno">4.12.4.16 </span>Sequential link types</a>
- <ol><li><a href="links.html#link-type-next"><span class="secno">4.12.4.16.1 </span>Link type "<code>next</code>"</a></li>
- <li><a href="links.html#link-type-prev"><span class="secno">4.12.4.16.2 </span>Link type "<code>prev</code>"</a></li></ol></li>
- <li><a href="links.html#other-link-types"><span class="secno">4.12.4.17 </span>Other link types</a></li></ol></li></ol></li>
+ <li><a href="links.html#link-type-help"><span class="secno">4.12.4.4 </span>Link type "<code>help</code>"</a></li>
+ <li><a href="links.html#rel-icon"><span class="secno">4.12.4.5 </span>Link type "<code>icon</code>"</a></li>
+ <li><a href="links.html#link-type-license"><span class="secno">4.12.4.6 </span>Link type "<code>license</code>"</a></li>
+ <li><a href="links.html#link-type-nofollow"><span class="secno">4.12.4.7 </span>Link type "<code>nofollow</code>"</a></li>
+ <li><a href="links.html#link-type-noreferrer"><span class="secno">4.12.4.8 </span>Link type "<code>noreferrer</code>"</a></li>
+ <li><a href="links.html#link-type-pingback"><span class="secno">4.12.4.9 </span>Link type "<code>pingback</code>"</a></li>
+ <li><a href="links.html#link-type-prefetch"><span class="secno">4.12.4.10 </span>Link type "<code>prefetch</code>"</a></li>
+ <li><a href="links.html#link-type-search"><span class="secno">4.12.4.11 </span>Link type "<code>search</code>"</a></li>
+ <li><a href="links.html#link-type-stylesheet"><span class="secno">4.12.4.12 </span>Link type "<code>stylesheet</code>"</a></li>
+ <li><a href="links.html#link-type-tag"><span class="secno">4.12.4.13 </span>Link type "<code>tag</code>"</a></li>
+ <li><a href="links.html#sequential-link-types"><span class="secno">4.12.4.14 </span>Sequential link types</a>
+ <ol><li><a href="links.html#link-type-next"><span class="secno">4.12.4.14.1 </span>Link type "<code>next</code>"</a></li>
+ <li><a href="links.html#link-type-prev"><span class="secno">4.12.4.14.2 </span>Link type "<code>prev</code>"</a></li></ol></li>
+ <li><a href="links.html#other-link-types"><span class="secno">4.12.4.15 </span>Other link types</a></li></ol></li></ol></li>
<li><a href="links.html#common-idioms-without-dedicated-elements"><span class="secno">4.13 </span>Common idioms without dedicated elements</a>
<ol><li><a href="links.html#the-main-part-of-the-content"><span class="secno">4.13.1 </span>The main part of the content</a></li>
<li><a href="links.html#rel-up"><span class="secno">4.13.2 </span>Bread crumb navigation</a></li>
@@ -1172,53 +1171,56 @@
<li><a href="the-xhtml-syntax.html#parsing-xhtml-fragments"><span class="secno">9.4 </span>Parsing XHTML fragments</a></li></ol></li>
<li><a href="rendering.html#rendering"><span class="secno">10 </span>Rendering</a>
<ol><li><a href="rendering.html#introduction-8"><span class="secno">10.1 </span>Introduction</a></li>
- <li><a href="rendering.html#the-css-user-agent-style-sheet-and-presentational-hints"><span class="secno">10.2 </span>The CSS user agent style sheet and presentational hints</a>
- <ol><li><a href="rendering.html#introduction-9"><span class="secno">10.2.1 </span>Introduction</a></li>
- <li><a href="rendering.html#display-types"><span class="secno">10.2.2 </span>Display types</a></li>
- <li><a href="rendering.html#margins-and-padding"><span class="secno">10.2.3 </span>Margins and padding</a></li>
- <li><a href="rendering.html#alignment"><span class="secno">10.2.4 </span>Alignment</a></li>
- <li><a href="rendering.html#fonts-and-colors"><span class="secno">10.2.5 </span>Fonts and colors</a></li>
- <li><a href="rendering.html#punctuation-and-decorations"><span class="secno">10.2.6 </span>Punctuation and decorations</a></li>
- <li><a href="rendering.html#resetting-rules-for-inherited-properties"><span class="secno">10.2.7 </span>Resetting rules for inherited properties</a></li>
- <li><a href="rendering.html#the-hr-element-0"><span class="secno">10.2.8 </span>The <code>hr</code> element</a></li>
- <li><a href="rendering.html#the-fieldset-element-0"><span class="secno">10.2.9 </span>The <code>fieldset</code> element</a></li></ol></li>
- <li><a href="rendering.html#replaced-elements"><span class="secno">10.3 </span>Replaced elements</a>
- <ol><li><a href="rendering.html#embedded-content-2"><span class="secno">10.3.1 </span>Embedded content</a></li>
- <li><a href="rendering.html#timed-text-tracks-0"><span class="secno">10.3.2 </span>Timed text tracks</a>
- <ol><li><a href="rendering.html#webvtt-cue-text-rendering-rules"><span class="secno">10.3.2.1 </span>WebVTT cue text rendering rules</a></li>
- <li><a href="rendering.html#applying-css-properties-to-webvtt-node-objects"><span class="secno">10.3.2.2 </span>Applying CSS properties to <span title="WebVTT Node Object">WebVTT Node Objects</span></a></li>
- <li><a href="rendering.html#css-extensions"><span class="secno">10.3.2.3 </span>CSS extensions</a>
- <ol><li><a href="rendering.html#the-::cue-pseudo-element"><span class="secno">10.3.2.3.1 </span>The '::cue' pseudo-element</a></li>
- <li><a href="rendering.html#the-:past-and-:future-pseudo-classes"><span class="secno">10.3.2.3.2 </span>The ':past' and ':future' pseudo-classes</a></li></ol></li></ol></li>
- <li><a href="rendering.html#images"><span class="secno">10.3.3 </span>Images</a></li>
- <li><a href="rendering.html#attributes-for-embedded-content-and-images"><span class="secno">10.3.4 </span>Attributes for embedded content and images</a></li>
- <li><a href="rendering.html#image-maps-0"><span class="secno">10.3.5 </span>Image maps</a></li>
- <li><a href="rendering.html#toolbars-0"><span class="secno">10.3.6 </span>Toolbars</a></li></ol></li>
- <li><a href="rendering.html#bindings"><span class="secno">10.4 </span>Bindings</a>
- <ol><li><a href="rendering.html#introduction-10"><span class="secno">10.4.1 </span>Introduction</a></li>
- <li><a href="rendering.html#the-button-element-0"><span class="secno">10.4.2 </span>The <code>button</code> element</a></li>
- <li><a href="rendering.html#the-details-element-0"><span class="secno">10.4.3 </span>The <code>details</code> element</a></li>
- <li><a href="rendering.html#the-input-element-as-a-text-entry-widget"><span class="secno">10.4.4 </span>The <code>input</code> element as a text entry widget</a></li>
- <li><a href="rendering.html#the-input-element-as-domain-specific-widgets"><span class="secno">10.4.5 </span>The <code>input</code> element as domain-specific widgets</a></li>
- <li><a href="rendering.html#the-input-element-as-a-range-control"><span class="secno">10.4.6 </span>The <code>input</code> element as a range control</a></li>
- <li><a href="rendering.html#the-input-element-as-a-color-well"><span class="secno">10.4.7 </span>The <code>input</code> element as a color well</a></li>
- <li><a href="rendering.html#the-input-element-as-a-checkbox-and-radio-button-widgets"><span class="secno">10.4.8 </span>The <code>input</code> element as a checkbox and radio button widgets</a></li>
- <li><a href="rendering.html#the-input-element-as-a-file-upload-control"><span class="secno">10.4.9 </span>The <code>input</code> element as a file upload control</a></li>
- <li><a href="rendering.html#the-input-element-as-a-button"><span class="secno">10.4.10 </span>The <code>input</code> element as a button</a></li>
- <li><a href="rendering.html#the-marquee-element-0"><span class="secno">10.4.11 </span>The <code>marquee</code> element</a></li>
- <li><a href="rendering.html#the-meter-element-0"><span class="secno">10.4.12 </span>The <code>meter</code> element</a></li>
- <li><a href="rendering.html#the-progress-element-0"><span class="secno">10.4.13 </span>The <code>progress</code> element</a></li>
- <li><a href="rendering.html#the-select-element-0"><span class="secno">10.4.14 </span>The <code>select</code> element</a></li>
- <li><a href="rendering.html#the-textarea-element-0"><span class="secno">10.4.15 </span>The <code>textarea</code> element</a></li>
- <li><a href="rendering.html#the-keygen-element-0"><span class="secno">10.4.16 </span>The <code>keygen</code> element</a></li>
- <li><a href="rendering.html#the-time-element-0"><span class="secno">10.4.17 </span>The <code>time</code> element</a></li></ol></li>
- <li><a href="rendering.html#frames-and-framesets"><span class="secno">10.5 </span>Frames and framesets</a></li>
- <li><a href="rendering.html#interactive-media"><span class="secno">10.6 </span>Interactive media</a>
- <ol><li><a href="rendering.html#links-forms-and-navigation"><span class="secno">10.6.1 </span>Links, forms, and navigation</a></li>
- <li><a href="rendering.html#the-title-attribute-0"><span class="secno">10.6.2 </span>The <code title="attr-title">title</code> attribute</a></li>
- <li><a href="rendering.html#editing-hosts"><span class="secno">10.6.3 </span>Editing hosts</a></li>
- <li><a href="rendering.html#text-rendered-in-native-user-interfaces"><span class="secno">10.6.4 </span>Text rendered in native user interfaces</a></li></ol></li>
- <li><a href="rendering.html#print-media"><span class="secno">10.7 </span>Print media</a></li></ol></li>
+ <li><a href="rendering.html#the-css-user-agent-style-sheet-and-presentational-hints"><span class="secno">10.2 </span>The CSS user agent style sheet and presentational hints</a></li>
+ <li><a href="rendering.html#non-replaced-elements"><span class="secno">10.3 </span>Non-replaced elements</a>
+ <ol><li><a href="rendering.html#hidden-elements"><span class="secno">10.3.1 </span>Hidden elements</a></li>
+ <li><a href="rendering.html#the-page"><span class="secno">10.3.2 </span>The page</a></li>
+ <li><a href="rendering.html#flow-content-1"><span class="secno">10.3.3 </span>Flow content</a></li>
+ <li><a href="rendering.html#phrasing-content-1"><span class="secno">10.3.4 </span>Phrasing content</a></li>
+ <li><a href="rendering.html#bidirectional-text"><span class="secno">10.3.5 </span>Bidirectional text</a></li>
+ <li><a href="rendering.html#sections-and-headings"><span class="secno">10.3.6 </span>Sections and headings</a></li>
+ <li><a href="rendering.html#lists"><span class="secno">10.3.7 </span>Lists</a></li>
+ <li><a href="rendering.html#tables"><span class="secno">10.3.8 </span>Tables</a></li>
+ <li><a href="rendering.html#form-controls"><span class="secno">10.3.9 </span>Form controls</a></li>
+ <li><a href="rendering.html#the-hr-element-0"><span class="secno">10.3.10 </span>The <code>hr</code> element</a></li>
+ <li><a href="rendering.html#the-fieldset-element-0"><span class="secno">10.3.11 </span>The <code>fieldset</code> element</a></li></ol></li>
+ <li><a href="rendering.html#replaced-elements"><span class="secno">10.4 </span>Replaced elements</a>
+ <ol><li><a href="rendering.html#embedded-content-2"><span class="secno">10.4.1 </span>Embedded content</a></li>
+ <li><a href="rendering.html#timed-text-tracks-0"><span class="secno">10.4.2 </span>Timed text tracks</a>
+ <ol><li><a href="rendering.html#webvtt-cue-text-rendering-rules"><span class="secno">10.4.2.1 </span>WebVTT cue text rendering rules</a></li>
+ <li><a href="rendering.html#applying-css-properties-to-webvtt-node-objects"><span class="secno">10.4.2.2 </span>Applying CSS properties to <span title="WebVTT Node Object">WebVTT Node Objects</span></a></li>
+ <li><a href="rendering.html#css-extensions"><span class="secno">10.4.2.3 </span>CSS extensions</a>
+ <ol><li><a href="rendering.html#the-::cue-pseudo-element"><span class="secno">10.4.2.3.1 </span>The '::cue' pseudo-element</a></li>
+ <li><a href="rendering.html#the-:past-and-:future-pseudo-classes"><span class="secno">10.4.2.3.2 </span>The ':past' and ':future' pseudo-classes</a></li></ol></li></ol></li>
+ <li><a href="rendering.html#images"><span class="secno">10.4.3 </span>Images</a></li>
+ <li><a href="rendering.html#attributes-for-embedded-content-and-images"><span class="secno">10.4.4 </span>Attributes for embedded content and images</a></li>
+ <li><a href="rendering.html#image-maps-0"><span class="secno">10.4.5 </span>Image maps</a></li>
+ <li><a href="rendering.html#toolbars-0"><span class="secno">10.4.6 </span>Toolbars</a></li></ol></li>
+ <li><a href="rendering.html#bindings"><span class="secno">10.5 </span>Bindings</a>
+ <ol><li><a href="rendering.html#introduction-9"><span class="secno">10.5.1 </span>Introduction</a></li>
+ <li><a href="rendering.html#the-button-element-0"><span class="secno">10.5.2 </span>The <code>button</code> element</a></li>
+ <li><a href="rendering.html#the-details-element-0"><span class="secno">10.5.3 </span>The <code>details</code> element</a></li>
+ <li><a href="rendering.html#the-input-element-as-a-text-entry-widget"><span class="secno">10.5.4 </span>The <code>input</code> element as a text entry widget</a></li>
+ <li><a href="rendering.html#the-input-element-as-domain-specific-widgets"><span class="secno">10.5.5 </span>The <code>input</code> element as domain-specific widgets</a></li>
+ <li><a href="rendering.html#the-input-element-as-a-range-control"><span class="secno">10.5.6 </span>The <code>input</code> element as a range control</a></li>
+ <li><a href="rendering.html#the-input-element-as-a-color-well"><span class="secno">10.5.7 </span>The <code>input</code> element as a color well</a></li>
+ <li><a href="rendering.html#the-input-element-as-a-checkbox-and-radio-button-widgets"><span class="secno">10.5.8 </span>The <code>input</code> element as a checkbox and radio button widgets</a></li>
+ <li><a href="rendering.html#the-input-element-as-a-file-upload-control"><span class="secno">10.5.9 </span>The <code>input</code> element as a file upload control</a></li>
+ <li><a href="rendering.html#the-input-element-as-a-button"><span class="secno">10.5.10 </span>The <code>input</code> element as a button</a></li>
+ <li><a href="rendering.html#the-marquee-element-0"><span class="secno">10.5.11 </span>The <code>marquee</code> element</a></li>
+ <li><a href="rendering.html#the-meter-element-0"><span class="secno">10.5.12 </span>The <code>meter</code> element</a></li>
+ <li><a href="rendering.html#the-progress-element-0"><span class="secno">10.5.13 </span>The <code>progress</code> element</a></li>
+ <li><a href="rendering.html#the-select-element-0"><span class="secno">10.5.14 </span>The <code>select</code> element</a></li>
+ <li><a href="rendering.html#the-textarea-element-0"><span class="secno">10.5.15 </span>The <code>textarea</code> element</a></li>
+ <li><a href="rendering.html#the-keygen-element-0"><span class="secno">10.5.16 </span>The <code>keygen</code> element</a></li>
+ <li><a href="rendering.html#the-time-element-0"><span class="secno">10.5.17 </span>The <code>time</code> element</a></li></ol></li>
+ <li><a href="rendering.html#frames-and-framesets"><span class="secno">10.6 </span>Frames and framesets</a></li>
+ <li><a href="rendering.html#interactive-media"><span class="secno">10.7 </span>Interactive media</a>
+ <ol><li><a href="rendering.html#links-forms-and-navigation"><span class="secno">10.7.1 </span>Links, forms, and navigation</a></li>
+ <li><a href="rendering.html#the-title-attribute-0"><span class="secno">10.7.2 </span>The <code title="attr-title">title</code> attribute</a></li>
+ <li><a href="rendering.html#editing-hosts"><span class="secno">10.7.3 </span>Editing hosts</a></li>
+ <li><a href="rendering.html#text-rendered-in-native-user-interfaces"><span class="secno">10.7.4 </span>Text rendered in native user interfaces</a></li></ol></li>
+ <li><a href="rendering.html#print-media"><span class="secno">10.8 </span>Print media</a></li></ol></li>
<li><a href="obsolete.html#obsolete"><span class="secno">11 </span>Obsolete features</a>
<ol><li><a href="obsolete.html#obsolete-but-conforming-features"><span class="secno">11.1 </span>Obsolete but conforming features</a>
<ol><li><a href="obsolete.html#warnings-for-obsolete-but-conforming-features"><span class="secno">11.1.1 </span>Warnings for obsolete but conforming features</a></li></ol></li>
@@ -1232,7 +1234,8 @@
<ol><li><a href="iana.html#text-html"><span class="secno">12.1 </span><code>text/html</code></a></li>
<li><a href="iana.html#text-html-sandboxed"><span class="secno">12.2 </span><code>text/html-sandboxed</code></a></li>
<li><a href="iana.html#application-xhtml-xml"><span class="secno">12.3 </span><code>application/xhtml+xml</code></a></li>
- <li><a href="iana.html#text-cache-manifest"><span class="secno">12.4 </span><code>text/cache-manifest</code></a></li></ol></li>
+ <li><a href="iana.html#application-x-www-form-urlencoded"><span class="secno">12.4 </span><code>application/x-www-form-urlencoded</code></a></li>
+ <li><a href="iana.html#text-cache-manifest"><span class="secno">12.5 </span><code>text/cache-manifest</code></a></li></ol></li>
<li><a class="no-num" href="index.html#index">Index</a>
<ol><li><a class="no-num" href="index.html#elements-1">Elements</a></li>
<li><a class="no-num" href="index.html#element-content-categories">Element content categories</a></li>
Index: number-state.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/number-state.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- number-state.html 17 Jun 2011 08:49:07 -0000 1.13
+++ number-state.html 24 Aug 2011 07:56:04 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -345,7 +348,12 @@
user's selection as a floating point number</a>. User agents
should allow the user to set the <a href="association-of-controls-and-forms.html#concept-fe-value" title="concept-fe-value">value</a> to the empty string.</p>
- </div><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value">value</a></code> attribute, if
+ </div><p class="note">This specification does not define what user
+ interface user agents are to use; user agent vendors are encouraged
+ to consider what would best serve their users' needs. For example, a
+ user agent in Persian or Arabic markets might support Persian and
+ Arabic numeric input (converting it to the format required for
+ submission as described above). </p><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value">value</a></code> attribute, if
specified and not empty, must have a value that is a <a href="common-microsyntaxes.html#valid-floating-point-number">valid
floating point number</a>.</p><div class="impl">
@@ -691,8 +699,8 @@
<code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate">formnovalidate</a></code>,
<code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget">formtarget</a></code>,
<code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height">height</a></code>,
- <code class="no-backref" title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength">maxlength</a></code>,
<code class="no-backref" title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max">max</a></code>,
+ <code class="no-backref" title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength">maxlength</a></code>,
<code class="no-backref" title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min">min</a></code>,
<code class="no-backref" title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple">multiple</a></code>,
<code class="no-backref" title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern">pattern</a></code>,
@@ -1180,7 +1188,10 @@
or alternatively a button from which the user can submit the
form. The element is a <a href="forms.html#concept-button" title="concept-button">button</a>,
specifically a <a href="forms.html#concept-submit-button" title="concept-submit-button">submit
- button</a>.</p><hr/><p>The image is given by the <dfn id="attr-input-src" title="attr-input-src"><code>src</code></dfn> attribute. The <code title="attr-input-src"><a href="#attr-input-src">src</a></code> attribute must be present, and
+ button</a>.</p><p class="note">The coordinate is sent to the server <a href="association-of-controls-and-forms.html#constructing-the-form-data-set" title="constructing the form data set">during form submission</a>
+ by sending two entries for the element, derived from the name of the
+ control but with "<code title="">.x</code>" and "<code title="">.y</code>" appended to the name with the <var title="">x</var> and <var title="">y</var> components of the
+ coordinate respectively.</p><hr/><p>The image is given by the <dfn id="attr-input-src" title="attr-input-src"><code>src</code></dfn> attribute. The <code title="attr-input-src"><a href="#attr-input-src">src</a></code> attribute must be present, and
must contain a <a href="urls.html#valid-non-empty-url-potentially-surrounded-by-spaces">valid non-empty URL potentially surrounded by
spaces</a> referencing a non-interactive, optionally animated,
image resource that is neither paged nor scripted.</p><div class="impl">
@@ -1361,7 +1372,18 @@
</div><p class="note">Many aspects of this state's behavior are similar to
the behavior of the <code><a href="embedded-content-1.html#the-img-element">img</a></code> element. Readers are encouraged
to read that section, where many of the same requirements are
- described in more detail.</p><h6 id="reset-button-state"><span class="secno">4.10.7.1.21 </span><dfn title="attr-input-type-reset">Reset Button</dfn> state</h6><div class="impl">
+ described in more detail.</p><div class="example">
+
+ <p>Take the following form:</p>
+
+ <pre><form action="process.cgi">
+ <input type=image src=map.png name=where>
+</form></pre>
+
+ <p>If the user clicked on the image at coordinate (127,40) then the
+ URL used to submit the form would be "<code title="">process.cgi?where.x=127&where.y=40</code>".</p>
+
+ </div><h6 id="reset-button-state"><span class="secno">4.10.7.1.21 </span><dfn title="attr-input-type-reset">Reset Button</dfn> state</h6><div class="impl">
<p>When an <code><a href="the-input-element.html#the-input-element">input</a></code> element's <code title="attr-input-type"><a href="the-input-element.html#attr-input-type">type</a></code> attribute is in the <a href="#reset-button-state" title="attr-input-type-reset">Reset Button</a> state, the rules
in this section apply.</p>
Index: sections.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/sections.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- sections.html 17 Jun 2011 08:49:07 -0000 1.13
+++ sections.html 24 Aug 2011 07:56:04 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -1432,6 +1435,10 @@
</section>
</body></pre>
+ <p>This final example would need explicit style rules to be
+ rendered well in legacy browsers. Legacy browsers without CSS
+ support would render all the headings as top-level headings.</p>
+
</div><h5 id="outlines"><span class="secno">4.4.11.1 </span>Creating an outline</h5><div class="impl">
Index: namespaces.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/namespaces.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- namespaces.html 17 Jun 2011 08:49:07 -0000 1.11
+++ namespaces.html 24 Aug 2011 07:56:04 -0000 1.12
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
Index: introduction.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/introduction.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- introduction.html 17 Jun 2011 08:49:06 -0000 1.13
+++ introduction.html 24 Aug 2011 07:56:04 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -325,7 +328,8 @@
<ol class="toc"><li><a href="introduction.html#introduction"><span class="secno">1 </span>Introduction</a>
<ol><li><a href="introduction.html#background"><span class="secno">1.1 </span>Background</a></li><li><a href="introduction.html#audience"><span class="secno">1.2 </span>Audience</a></li><li><a href="introduction.html#scope"><span class="secno">1.3 </span>Scope</a></li><li><a href="introduction.html#history-1"><span class="secno">1.4 </span>History</a></li><li><a href="introduction.html#design-notes"><span class="secno">1.5 </span>Design notes</a>
<ol><li><a href="introduction.html#serializability-of-script-execution"><span class="secno">1.5.1 </span>Serializability of script execution</a></li><li><a href="introduction.html#compliance-with-other-specifications"><span class="secno">1.5.2 </span>Compliance with other specifications</a></li></ol></li><li><a href="introduction.html#html-vs-xhtml"><span class="secno">1.6 </span>HTML vs XHTML</a></li><li><a href="introduction.html#structure-of-this-specification"><span class="secno">1.7 </span>Structure of this specification</a>
- <ol><li><a href="introduction.html#how-to-read-this-specification"><span class="secno">1.7.1 </span>How to read this specification</a></li><li><a href="introduction.html#typographic-conventions"><span class="secno">1.7.2 </span>Typographic conventions</a></li></ol></li><li><a href="introduction.html#a-quick-introduction-to-html"><span class="secno">1.8 </span>A quick introduction to HTML</a></li><li><a href="introduction.html#conformance-requirements-for-authors"><span class="secno">1.9 </span>Conformance requirements for authors</a>
+ <ol><li><a href="introduction.html#how-to-read-this-specification"><span class="secno">1.7.1 </span>How to read this specification</a></li><li><a href="introduction.html#typographic-conventions"><span class="secno">1.7.2 </span>Typographic conventions</a></li></ol></li><li><a href="introduction.html#a-quick-introduction-to-html"><span class="secno">1.8 </span>A quick introduction to HTML</a>
+ <ol><li><a href="introduction.html#writing-secure-applications-with-html"><span class="secno">1.8.1 </span>Writing secure applications with HTML</a></li><li><a href="introduction.html#common-pitfalls-to-avoid-when-using-the-scripting-apis"><span class="secno">1.8.2 </span>Common pitfalls to avoid when using the scripting APIs</a></li></ol></li><li><a href="introduction.html#conformance-requirements-for-authors"><span class="secno">1.9 </span>Conformance requirements for authors</a>
<ol><li><a href="introduction.html#presentational-markup"><span class="secno">1.9.1 </span>Presentational markup</a></li><li><a href="introduction.html#syntax-errors"><span class="secno">1.9.2 </span>Syntax errors</a></li><li><a href="introduction.html#restrictions-on-content-models-and-on-attribute-values"><span class="secno">1.9.3 </span>Restrictions on content models and on attribute values</a></li></ol></li><li><a href="introduction.html#recommended-reading"><span class="secno">1.10 </span>Recommended reading</a></li></ol></li></ol></div><h2 id="introduction"><span class="secno">1 </span>Introduction</h2><h3 id="background"><span class="secno">1.1 </span>Background</h3><p><i>This section is non-normative.</i></p><p>The World Wide Web's markup language has always been HTML. HTML
was primarily designed as a language for semantically describing
scientific documents, although its general design and adaptations
@@ -368,17 +372,17 @@
hosted first at CERN, and then at the IETF.</p><p>With the creation of the W3C, HTML's development changed venue
again. A first abortive attempt at extending HTML in 1995 known as
HTML 3.0 then made way to a more pragmatic approach known as HTML
- 3.2, which was completed in 1997. HTML4 followed, reaching
- completion in 1998.</p><p>At this time, the W3C membership decided to stop evolving HTML
- and instead begin work on an XML-based equivalent, called
- XHTML. This effort started with a reformulation of HTML4 in XML,
- known as XHTML 1.0, which added no new features except the new
- serialization, and which was completed in 2000. After XHTML 1.0, the
- W3C's focus turned to making it easier for other working groups to
- extend XHTML, under the banner of XHTML Modularization. In parallel
- with this, the W3C also worked on a new language that was not
- compatible with the earlier HTML and XHTML languages, calling it
- XHTML2.</p><p>Around the time that HTML's evolution was stopped in 1998, parts
+ 3.2, which was completed in 1997. HTML4 quicky followed later that
+ same year.</p><p>The following year, the W3C membership decided to stop evolving
+ HTML and instead begin work on an XML-based equivalent, called
+ XHTML. This effort
+ started with a reformulation of HTML4 in XML, known as XHTML 1.0,
+ which added no new features except the new serialization, and which
+ was completed in 2000. After XHTML 1.0, the W3C's focus turned to
+ making it easier for other working groups to extend XHTML, under the
+ banner of XHTML Modularization. In parallel with this, the W3C also
+ worked on a new language that was not compatible with the earlier
+ HTML and XHTML languages, calling it XHTML2.</p><p>Around the time that HTML's evolution was stopped in 1998, parts
of the API for HTML developed by browser vendors were specified and
published under the name DOM Level 1 (in 1998) and DOM Level 2 Core
and DOM Level 2 HTML (starting in 2000 and culminating in
@@ -461,8 +465,7 @@
noted.</p><h3 id="html-vs-xhtml"><span class="secno">1.6 </span>HTML vs XHTML</h3><p><i>This section is non-normative.</i></p><p>This specification defines an abstract language for describing
documents and applications, and some APIs for interacting with
in-memory representations of resources that use this language.</p><p>The in-memory representation is known as "DOM HTML", or "the DOM"
- for short. This specification defines version 5 of DOM HTML, known
- as "DOM5 HTML".</p><p>There are various concrete syntaxes that can be used to transmit
+ for short.</p><p>There are various concrete syntaxes that can be used to transmit
resources that use this abstract language, two of which are defined
in this specification.</p><p>The first such concrete syntax is the HTML syntax. This is the
format suggested for most authors. It is compatible with most legacy
@@ -551,7 +554,39 @@
First, it should be read cover-to-cover, multiple times. Then, it
should be read backwards at least once. Then it should be read by
picking random sections from the contents list and following all the
- cross-references.</p><h4 id="typographic-conventions"><span class="secno">1.7.2 </span>Typographic conventions</h4><p>This is a definition, requirement, or explanation.</p><p class="note">This is a note.</p><p class="example">This is an example.</p><p class="XXX">This is an open issue.</p><p class="warning">This is a warning.</p><pre class="idl extract">interface <dfn title="">Example</dfn> {
+ cross-references.</p><p>As described in the conformance requirements section below, this
+ specification describes conformance criteria for a variety of
+ conformance classes. In particular, there are conformance
+ requirements that apply to <em>producers</em>, for example authors
+ and the documents they create, and there are conformance
+ requirements that apply to <em>consumers</em>, for example Web
+ browsers. They can be distinguished by what they are requiring: a
+ requirement on a producer states what is allowed, while a
+ requirement on a consumer states how software is to act.</p><div class="example">
+
+ <p>For example, "the <code title="">foo</code> attribute's value
+ must be a <a href="common-microsyntaxes.html#valid-integer">valid integer</a>" is a requirement on
+ producers, as it lays out the allowed values; in contrast, the
+ requirement "the <code title="">foo</code> attribute's value must
+ be parsed using the <a href="common-microsyntaxes.html#rules-for-parsing-integers">rules for parsing integers</a>" is a
+ requirement on consumers, as it describes how to process the
+ content.</p>
+
+ </div><p><strong>Requirements on producers have no bearing whatsoever on
+ consumers.</strong></p><div class="example">
+
+ <p>Continuing the above example, a requirement stating that a
+ particular attribute's value is constrained to being a <a href="common-microsyntaxes.html#valid-integer">valid
+ integer</a> emphatically does <em>not</em> imply anything about
+ the requirements on consumers. It might be that the consumers are
+ in fact required to treat the attribute as an opaque string,
+ completely unaffected by whether the value conforms to the
+ requirements or not. It might be (as in the previous example) that
+ the consumers are required to parse the value using specific rules
+ that define how invalid (non-numeric in this case) values are to be
+ processed.</p>
+
+ </div><h4 id="typographic-conventions"><span class="secno">1.7.2 </span>Typographic conventions</h4><p>This is a definition, requirement, or explanation.</p><p class="note">This is a note.</p><p class="example">This is an example.</p><p class="XXX">This is an open issue.</p><p class="warning">This is a warning.</p><pre class="idl extract">interface <dfn title="">Example</dfn> {
// this is an IDL definition
};</pre><dl class="domintro"><dt><var title="">variable</var> = <var title="">object</var> . <code title="">method</code>( [ <var title="">optionalArgument</var> ] )</dt>
@@ -585,10 +620,9 @@
nested.</p><p>Elements can have attributes, which control how the elements
work. In the example below, there is a <a href="links.html#hyperlink">hyperlink</a>,
formed using the <code><a href="text-level-semantics.html#the-a-element">a</a></code> element and its <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code> attribute:</p><pre><a href="demo.html">simple</a></pre><p><a href="syntax.html#syntax-attributes" title="syntax-attributes">Attributes</a> are placed
- inside the start tag, and consist of a <a href="syntax.html#syntax-attribute-name" title="syntax-attribute-name">name</a> and a <a href="syntax.html#syntax-attribute-value" title="syntax-attribute-value">value</a>, separated by an "<code title="">=</code>" character. The attribute value can remain <a href="syntax.html#unquoted">unquoted</a> if it doesn't contain spaces or any of
- <code title="">"</code> <code title="">'</code> <code title="">`</code> <code title="">=</code> <code title=""><</code>
- or <code title="">></code>. Otherwise, it has to be quoted using
- either single or double quotes. The value, along with the "<code title="">=</code>" character, can be omitted altogether if the value
+ inside the start tag, and consist of a <a href="syntax.html#syntax-attribute-name" title="syntax-attribute-name">name</a> and a <a href="syntax.html#syntax-attribute-value" title="syntax-attribute-value">value</a>, separated by an "<code title="">=</code>" character. The attribute value can remain <a href="syntax.html#unquoted">unquoted</a> if it doesn't contain <a href="common-microsyntaxes.html#space-character" title="space character">space characters</a> or any of <code title="">"</code> <code title="">'</code> <code title="">`</code>
+ <code title="">=</code> <code title=""><</code> or <code title="">></code>. Otherwise, it has to be quoted using either
+ single or double quotes. The value, along with the "<code title="">=</code>" character, can be omitted altogether if the value
is the empty string.</p><pre><!-- empty attributes -->
<input name=address disabled>
<input name=address disabled="">
@@ -658,7 +692,166 @@
specification might also be of use, but the novice author is
cautioned that this specification, by necessity, defines the
language with a level of detail that might be difficult to
- understand at first.</p><h3 id="conformance-requirements-for-authors"><span class="secno">1.9 </span>Conformance requirements for authors</h3><p><i>This section is non-normative.</i></p><p>Unlike previous versions of the HTML specification, this
+ understand at first.</p><h4 id="writing-secure-applications-with-html"><span class="secno">1.8.1 </span>Writing secure applications with HTML</h4><p><i>This section is non-normative.</i></p><p>When HTML is used to create interactive sites, care needs to be
+ taken to avoid introducing vulnerabilities through which attackers
+ can compromise the integrity of the site itself or of the site's
+ users.</p><p>A comprehensive study of this matter is beyond the scope of this
+ document, and authors are strongly encouraged to study the matter in
+ more detail. However, this section attempts to provide a quick
+ introduction to some common pitfalls in HTML application
+ development.</p><p>The security model of the Web is based on the concept of
+ "origins", and correspondingly many of the potential attacks on the
+ Web involve cross-origin actions. <a href="references.html#refsORIGIN">[ORIGIN]</a></p><dl><dt>Not validating user input</dt>
+ <dt>Cross-site scripting (XSS)</dt>
+ <dt>SQL injection</dt>
+
+ <dd>
+
+ <p>When accepting untrusted input, e.g. user-generated content
+ such as text comments, values in URL parameters, messages from
+ third-party sites, etc, it is imperative that the data be
+ validated before use, and properly escaped when displayed. Failing
+ to do this can allow an hostile user to perform a variety of
+ attacks, ranging from the potentially benign, such as providing
+ bogus user information like a negative age, to the serious, such
+ as running scripts every time a user looks at a page that includes
+ the information, potentially propagating the attack in the
+ process, to the catastrophic, such as deleting all data in the
+ server.</p>
+
+ <p>When writing filters to validate user input, it is imperative
+ that filters always be whitelist-based, allowing known-safe
+ constructs and disallowing all other input. Blacklist-based
+ filters that disallow known-bad inputs and allow everything else
+ are not secure, as not everything that is bad is yet known (for
+ example, because it might be invented in the future).</p>
+
+ <div class="example">
+
+ <p>For example, suppose a page looked at its URL's query string
+ to determine what to display, and the site then redirected the
+ user to that page to display a message, as in:</p>
+
+ <pre><ul>
+ <li><a href="message.cgi?say=Hello">Say Hello</a>
+ <li><a href="message.cgi?say=Welcome">Say Welcome</a>
+ <li><a href="message.cgi?say=Kittens">Say Kittens</a>
+</ul></pre>
+
+ <p>If the message was just displayed to the user without
+ escaping, a hostile attacker could then craft a URL that
+ contained a script element:</p>
+
+ <pre>http://example.com/message.cgi?say=%3Cscript%3Ealert%28%27Oh%20no%21%27%29%3C/script%3E</pre>
+
+ <p>If the attacker then convinced a victim user to visit this
+ page, a script of the attacker's choosing would run on the page.
+ Such a script could do any number of hostile actions, limited
+ only by what the site offers: if the site is an e-commerce shop,
+ for instance, such a script could cause the user to unknowingly
+ make arbitrarily many unwanted purchases.</p>
+
+ <p>This is called a cross-site scripting attack.</p>
+
+ </div>
+
+ </dd>
+
+
+ <dt>Cross-site request forgery (CSRF)</dt>
+
+ <dd>
+
+ <p>If a site allows a user to make form submissions with
+ user-specific side-effects, for example posting messages on a
+ forum under the user's name, making purchases, or applying for a
+ passport, it is important to verify that the request was made by
+ the user intentionally, rather than by another site tricking the
+ user into making the request unknowingly.</p>
+
+ <p>This problem exists because HTML forms can be submitted to
+ other origins.</p>
+
+ <p>Sites can prevent such attacks by populating forms with
+ user-specific hidden tokens, or by checking <code title="http-origin">Origin</code> headers on all requests.</p>
+
+ </dd>
+
+
+
+ <dt>Clickjacking</dt>
+
+ <dd>
+
+ <p>A page that provides users with an interface to perform actions
+ that the user might not wish to perform needs to be designed so as
+ to avoid the possibility that users can be tricked into activating
+ the interface.</p>
+
+ <p>One way that a user could be so tricked is if a hostile site
+ places the victim site in a small <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> and then
+ convinces the user to click, for instance by having the user play
+ a reaction game. Once the user is playing the game, the hostile
+ site can quickly position the iframe under the mouse cursor just
+ as the user is about to click, thus tricking the user into
+ clicking the victim site's interface.</p>
+
+ <p>To avoid this, sites that do not expect to be used in frames
+ are encouraged to only enable their interface if they detect that
+ they are not in a frame (e.g. by comparing the <code title="dom-window"><a href="browsers.html#dom-window">window</a></code> object to the value of the <code title="dom-top"><a href="browsers.html#dom-top">top</a></code> attribute).</p>
+
+ </dd>
+
+ </dl><h4 id="common-pitfalls-to-avoid-when-using-the-scripting-apis"><span class="secno">1.8.2 </span>Common pitfalls to avoid when using the scripting APIs</h4><p><i>This section is non-normative.</i></p><p>Scripts in HTML have "run-to-completion" semantics, meaning that
+ the browser will generally run the script uninterrupted before doing
+ anything else, such as firing further events or continuing to parse
+ the document.</p><p>On the other hand, parsing of HTML files happens asynchronously
+ and incrementally, meaning that the parser can pause at any point to
+ let scripts run. This is generally a good thing, but it does mean
+ that authors need to be careful to avoid hooking event handlers
+ after the events could have possibly fired.</p><p>There are two techniques for doing this reliably: use <a href="webappapis.html#event-handler-content-attributes">event
+ handler content attributes</a>, or create the element and add the
+ event handlers in the same script. The latter is safe because, as
+ mentioned earlier, scripts are run to completion before further
+ events can fire.</p><div class="example">
+
+ <p>One way this could manifest itself is with <code><a href="embedded-content-1.html#the-img-element">img</a></code>
+ elements and the <code title="event-load">load</code> event. The
+ event could fire as soon as the element has been parsed, especially
+ if the image has already been cached (which is common).</p>
+
+ <p>Here, the author uses the <code title="handler-onload"><a href="webappapis.html#handler-onload">onload</a></code> handler on an <code><a href="embedded-content-1.html#the-img-element">img</a></code>
+ element to catch the <code title="event-load">load</code> event:</p>
+
+ <pre><img src="games.png" alt="Games" onload="gamesLogoHasLoaded(event)"></pre>
+
+ <p>If the element is being added by script, then so long as the
+ event handlers are added in the same script, the event will still
+ not be missed:</p>
+
+ <pre><script>
+ var img = new Image();
+ img.src = 'games.png';
+ img.alt = 'Games';
+ img.onload = gamesLogoHasLoaded;
+ // img.addEventListener('load', gamesLogoHasLoaded, false); // would work also
+</script></pre>
+
+ <p>However, if the author first created the <code><a href="embedded-content-1.html#the-img-element">img</a></code>
+ element and then in a separate script added the event listeners,
+ there's a chance that the <code title="event-load">load</code>
+ event would be fired in between, leading it to be missed:</p>
+
+ <pre class="bad"><!-- Do not use this style, it has a race condition! -->
+ <img id="games" src="games.png" alt="Games">
+ <!-- the 'load' event might fire here while the parser is taking a
+ break, in which case you will not see it! -->
+ <script>
+ var img = document.getElementById('games');
+ img.onload = gamesLogoHasLoaded; // might never fire!
+ </script></pre>
+
+ </div><h3 id="conformance-requirements-for-authors"><span class="secno">1.9 </span>Conformance requirements for authors</h3><p><i>This section is non-normative.</i></p><p>Unlike previous versions of the HTML specification, this
specification defines in some detail the required processing for
invalid documents as well as valid documents.</p><p>However, even though the processing of invalid content is in most
cases well-defined, conformance requirements for documents are still
@@ -702,7 +895,7 @@
</dd>
- <dt>Higher document sizes</dt>
+ <dt>Larger document sizes</dt>
<dd>
@@ -884,8 +1077,8 @@
<div class="example">
<p>Another example of this is the DOCTYPE, which is required to
- trigger <a href="dom.html#no-quirks-mode">no-quirks mode</a>, because the behavior of
- legacy user agents in <a href="dom.html#quirks-mode">quirks mode</a> is often largely
+ trigger <a href="infrastructure.html#no-quirks-mode">no-quirks mode</a>, because the behavior of
+ legacy user agents in <a href="infrastructure.html#quirks-mode">quirks mode</a> is often largely
undocumented.</p>
</div>
Index: commands.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/commands.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- commands.html 17 Jun 2011 08:49:05 -0000 1.12
+++ commands.html 24 Aug 2011 07:56:03 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -397,7 +400,7 @@
</dd>
- <dt><var title="">element</var> . <code title="dom-command-ro-label"><a href="#dom-command-ro-label">label</a></code></dt>
+ <dt><var title="">element</var> . <code title="dom-command-ro-commandLabel"><a href="#dom-command-ro-commandlabel">commandLabel</a></code></dt>
<dd>
@@ -413,7 +416,7 @@
</dd>
- <dt><var title="">element</var> . <code title="dom-command-ro-icon"><a href="#dom-command-ro-icon">icon</a></code></dt>
+ <dt><var title="">element</var> . <code title="dom-command-ro-commandIcon"><a href="#dom-command-ro-commandicon">commandIcon</a></code></dt>
<dd>
@@ -429,21 +432,15 @@
</dd>
- <dt><var title="">element</var> . <code title="dom-hidden"><a href="editing.html#dom-hidden">hidden</a></code></dt>
+ <dt><var title="">element</var> . <code title="dom-command-ro-commandHidden"><a href="#dom-command-ro-commandhidden">commandHidden</a></code></dt>
<dd>
- <p>Exposes the state of the element's <code title="attr-hidden"><a href="editing.html#the-hidden-attribute">hidden</a></code> attribute, which is generally
- equivalent to the <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden
- State</a> facet of the command. For <code><a href="forms.html#the-label-element">label</a></code> and
- <code><a href="forms.html#the-legend-element">legend</a></code> elements (used in conjunction with the <code title="attr-accesskey"><a href="editing.html#the-accesskey-attribute">accesskey</a></code> attribute), the <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a> facet is
- derived from another element (the one that the <a href="editing.html#assigned-access-key">assigned
- access key</a> will trigger), and cannot be directly accessed
- from the element.</p>
+ <p>Exposes the <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a> facet of the command.</p>
</dd>
- <dt><var title="">element</var> . <code title="dom-command-ro-disabled"><a href="#dom-command-ro-disabled">disabled</a></code></dt>
+ <dt><var title="">element</var> . <code title="dom-command-ro-commandDisabled"><a href="#dom-command-ro-commanddisabled">commandDisabled</a></code></dt>
<dd>
@@ -451,7 +448,7 @@
</dd>
- <dt><var title="">element</var> . <code title="dom-command-ro-checked"><a href="#dom-command-ro-checked">checked</a></code></dt>
+ <dt><var title="">element</var> . <code title="dom-command-ro-commandChecked"><a href="#dom-command-ro-commandchecked">commandChecked</a></code></dt>
<dd>
@@ -475,46 +472,46 @@
element is "command", "radio", or "checkbox" respectively. If the
element does not define a command, it must return null.</p>
- <p>The <dfn id="dom-command-ro-label" title="dom-command-ro-label"><code>label</code></dfn>
+ <p>The <dfn id="dom-command-ro-commandlabel" title="dom-command-ro-commandLabel"><code>commandLabel</code></dfn>
attribute must return the command's <a href="#command-facet-label" title="command-facet-Label">Label</a>, or null if the element
- does not define a command or does not specify a <a href="#command-facet-label" title="command-facet-Label">Label</a>. This attribute will be
- shadowed by the <code title="">label</code> IDL attribute on
- various elements.</p>
+ does not define a command or does not specify a <a href="#command-facet-label" title="command-facet-Label">Label</a>.</p>
- <p>The <dfn id="dom-command-ro-icon" title="dom-command-ro-icon"><code>icon</code></dfn>
+ <p>The <dfn id="dom-command-ro-commandicon" title="dom-command-ro-commandIcon"><code>commandIcon</code></dfn>
attribute must return the <a href="urls.html#absolute-url">absolute URL</a> of the command's
<a href="#command-facet-icon" title="command-facet-Icon">Icon</a>. If the element does
not specify an icon, or if the element does not define a command,
- then the attribute must return null. This attribute will be shadowed
- by the <code title="dom-command-icon"><a href="interactive-elements.html#dom-command-icon">icon</a></code> IDL attribute on
- <code><a href="interactive-elements.html#the-command-element">command</a></code> elements.</p>
+ then the attribute must return null.</p>
- <p>The <dfn id="dom-command-ro-disabled" title="dom-command-ro-disabled"><code>disabled</code></dfn>
+ <p>The <dfn id="dom-command-ro-commandhidden" title="dom-command-ro-commandHidden"><code>commandHidden</code></dfn>
+ attribute must return true if the command's <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a> is that the
+ command is hidden, and false if the command is not hidden. If the
+ element does not define a command, the attribute must return
+ null.</p>
+
+ <p>The <dfn id="dom-command-ro-commanddisabled" title="dom-command-ro-commandDisabled"><code>commandDisabled</code></dfn>
attribute must return true if the command's <a href="#command-facet-disabledstate" title="command-facet-DisabledState">Disabled State</a> is that
- the command is disabled, and false if the command is not
- disabled. This attribute is not affected by the command's <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a>. If the
+ the command is disabled, and false if the command is not disabled.
+ This attribute is not affected by the command's <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a>. If the
element does not define a command, the attribute must return
- false. This attribute will be shadowed by the <code title="">disabled</code> IDL attribute on various elements.</p>
+ null.</p>
- <p>The <dfn id="dom-command-ro-checked" title="dom-command-ro-checked"><code>checked</code></dfn> attribute
- must return true if the command's <a href="#command-facet-checkedstate" title="command-facet-CheckedState">Checked State</a> is that the
+ <p>The <dfn id="dom-command-ro-commandchecked" title="dom-command-ro-commandChecked"><code>commandChecked</code></dfn>
+ attribute must return true if the command's <a href="#command-facet-checkedstate" title="command-facet-CheckedState">Checked State</a> is that the
command is checked, and false if it is that the command is not
checked. If the element does not define a command, the attribute
- must return false. This attribute will be shadowed by the <code title="">checked</code> IDL attribute on <code><a href="the-input-element.html#the-input-element">input</a></code> and
- <code><a href="interactive-elements.html#the-command-element">command</a></code> elements.</p>
+ must return null.</p>
<p class="note">The <a href="#command-facet-id" title="command-facet-ID">ID</a> facet
- is exposed by the <code title="dom-id"><a href="elements.html#dom-id">id</a></code> IDL attribute,
- the <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> facet is exposed by
- the <code title="dom-title"><a href="elements.html#dom-title">title</a></code> IDL attribute, the <a href="#command-facet-accesskey" title="command-facet-AccessKey">AccessKey</a> facet is exposed by
+ is exposed by the <code title="dom-id"><a href="elements.html#dom-id">id</a></code> IDL attribute, the
+ <a href="#command-facet-hint" title="command-facet-Hint">Hint</a> facet is exposed by the
+ <code title="dom-title"><a href="elements.html#dom-title">title</a></code> IDL attribute, and the <a href="#command-facet-accesskey" title="command-facet-AccessKey">AccessKey</a> facet is exposed by
the <code title="dom-accessKeyLabel"><a href="editing.html#dom-accesskeylabel">accessKeyLabel</a></code> IDL
- attribute, and the <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden
- State</a> facet is exposed by the <code title="dom-hidden"><a href="editing.html#dom-hidden">hidden</a></code> IDL attribute.</p>
+ attribute.</p>
</div><hr/><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-commands"><a href="#dom-document-commands">commands</a></code></dt>
<dd>
- <p>Returns an <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> of the elements in the
+ <p>Returns an <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> of the elements in the
<code><a href="infrastructure.html#document">Document</a></code> that define commands and have IDs.</p>
</dd>
@@ -522,12 +519,14 @@
<p>The <dfn id="dom-document-commands" title="dom-document-commands"><code>commands</code></dfn> attribute
of the document's <code><a href="dom.html#htmldocument">HTMLDocument</a></code> interface must return an
- <code><a href="common-dom-interfaces.html#htmlcollection">HTMLCollection</a></code> rooted at the <code><a href="infrastructure.html#document">Document</a></code>
+ <code><a href="infrastructure.html#htmlcollection">HTMLCollection</a></code> rooted at the <code><a href="infrastructure.html#document">Document</a></code>
node, whose filter matches only elements that <a href="#concept-command" title="concept-command">define commands</a> and have <a href="#command-facet-id" title="command-facet-ID">IDs</a>.</p>
</div><hr/><p>User agents may expose the <a href="#concept-command" title="concept-command">commands</a> whose <a href="#command-facet-hiddenstate" title="command-facet-HiddenState">Hidden State</a> facet is false
- (visible), e.g. in the user agent's menu bar. User agents are
- encouraged to do this especially for commands that have <a href="#command-facet-accesskey" title="command-facet-AccessKey">Access Keys</a>, as a way to
+ (visible) and whose elements are <a href="infrastructure.html#in-a-document">in a
+ <code>Document</code></a>. For example, such commands could be
+ listed in the user agent's menu bar. User agents are encouraged to
+ do this especially for commands that have <a href="#command-facet-accesskey" title="command-facet-AccessKey">Access Keys</a>, as a way to
advertise those keys to the user.</p><div class="impl">
<h5 id="using-the-a-element-to-define-a-command"><span class="secno">4.11.5.1 </span><dfn title="a-command">Using the <code>a</code> element to define a command</dfn></h5>
@@ -552,9 +551,10 @@
<p>The <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> of the command
is the <a href="urls.html#absolute-url">absolute URL</a> obtained from <a href="urls.html#resolve-a-url" title="resolve a url">resolving</a> the value of the <code title="attr-img-src"><a href="embedded-content-1.html#attr-img-src">src</a></code> attribute of the first
- <code><a href="embedded-content-1.html#the-img-element">img</a></code> element descendant of the element, relative to that
- element, if there is such an element and resolving its attribute is
- successful. Otherwise, there is no <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> for the command.</p>
+ <code><a href="embedded-content-1.html#the-img-element">img</a></code> element descendant of the element in <a href="infrastructure.html#tree-order">tree
+ order</a>, relative to that element, if there is such an element
+ and resolving its attribute is successful. Otherwise, there is no
+ <a href="#command-facet-icon" title="command-facet-Icon">Icon</a> for the command.</p>
<p>The <a href="#command-facet-accesskey" title="command-facet-AccessKey">AccessKey</a> of the
command is the element's <a href="editing.html#assigned-access-key">assigned access key</a>, if
Index: acknowledgements.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/acknowledgements.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- acknowledgements.html 17 Jun 2011 08:49:03 -0000 1.14
+++ acknowledgements.html 24 Aug 2011 07:56:03 -0000 1.15
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -601,6 +604,7 @@
Jim Jewett,
Jim Ley,
Jim Meehan,
+ Jirka Kosek,
Jjgod Jiang,
João Eiras,
Joe Clark,
@@ -643,8 +647,10 @@
Kai Hendry,
Kartikaya Gupta,
Kathy Walton,
+ Kelly Ford,
Kelly Norton,
Kevin Benson,
+ Kevin Cole,
Kornél Pál,
Kornel Lesinski,
Kris Northfield,
@@ -654,6 +660,7 @@
Kyle Hofmann,
Kyle Huey,
Léonard Bouchet,
+ Léonie Watson,
Lachlan Hunt,
Larry Masinter,
Larry Page,
@@ -667,6 +674,7 @@
Lee Kowalkowski,
Leif Halvard Silli,
Lenny Domnitser,
+ Leonard Rosenthol,
Leons Petrazickis,
Lobotom Dysmon,
Logan,
@@ -766,6 +774,7 @@
Philip Jägenstedt,
Philip Taylor,
Philip TAYLOR,
+ Philippe De Ryck,
Prateek Rungta,
Pravir Gupta,
Rachid Finge,
@@ -786,6 +795,7 @@
Riona Macnamara,
Rob Ennals,
Rob Jellinghaus,
+ Rob S,
Robert Blaut,
Robert Collins,
Robert O'Callahan,
Index: syntax.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/syntax.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- syntax.html 17 Jun 2011 08:49:07 -0000 1.13
+++ syntax.html 24 Aug 2011 07:56:05 -0000 1.14
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -722,11 +725,10 @@
</td></tr><tr><td> <code title="">xmlns</code> </td><td> <a href="namespaces.html#xmlns-namespace">XMLNS namespace</a> </td><td> <code title="">xmlns</code>
</td></tr><tr><td> <code title="">xlink</code> </td><td> <a href="namespaces.html#xmlns-namespace">XMLNS namespace</a> </td><td> <code title="">xmlns:xlink</code>
</td></tr></tbody></table><p>No other namespaced attribute can be expressed in <a href="#syntax">the
- HTML syntax</a>.</p><h5 id="optional-tags"><span class="secno">8.1.2.4 </span>Optional tags</h5><p>Certain tags can be <dfn id="syntax-tag-omission" title="syntax-tag-omission">omitted</dfn>.</p><p class="note">Omitting an element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> does not mean the element
- is not present; it is implied, but it is still there. An HTML
- document always has a root <code><a href="semantics.html#the-html-element">html</a></code> element, even if the
- string <code title=""><html></code> doesn't appear anywhere in
- the markup.</p><p>An <code><a href="semantics.html#the-html-element">html</a></code> element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> may be omitted if the
+ HTML syntax</a>.</p><h5 id="optional-tags"><span class="secno">8.1.2.4 </span>Optional tags</h5><p>Certain tags can be <dfn id="syntax-tag-omission" title="syntax-tag-omission">omitted</dfn>.</p><p class="note">Omitting an element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> in the situations
+ described below does not mean the element is not present; it is
+ implied, but it is still there. For example, an HTML document always
+ has a root <code><a href="semantics.html#the-html-element">html</a></code> element, even if the string <code title=""><html></code> doesn't appear anywhere in the markup.</p><p>An <code><a href="semantics.html#the-html-element">html</a></code> element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> may be omitted if the
first thing inside the <code><a href="semantics.html#the-html-element">html</a></code> element is not a <a href="#syntax-comments" title="syntax-comments">comment</a>.</p><p>An <code><a href="semantics.html#the-html-element">html</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
tag</a> may be omitted if the <code><a href="semantics.html#the-html-element">html</a></code> element is not
immediately followed by a <a href="#syntax-comments" title="syntax-comments">comment</a>.</p><p>A <code><a href="semantics.html#the-head-element">head</a></code> element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> may be omitted if the
Index: webappapis.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/webappapis.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- webappapis.html 17 Jun 2011 08:49:08 -0000 1.14
+++ webappapis.html 24 Aug 2011 07:56:05 -0000 1.15
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -487,7 +490,7 @@
<p>A character encoding, set when the script is created, used to
encode URLs. <span id="sce-not-copy" title="">If the character
- encoding is set from another source, e.g. a <a href="dom.html#document-s-character-encoding">document's
+ encoding is set from another source, e.g. a <a href="infrastructure.html#document-s-character-encoding">document's
character encoding</a>, then the <a href="#script-s-url-character-encoding">script's URL character
encoding</a> must follow the source, so that if the source's
changes, so does the script's.</span></p>
@@ -601,7 +604,7 @@
</li><li><p>The global object is the <code><a href="browsers.html#window">Window</a></code> object of
<var title="">document</var>.</p></li>
- <li><p>The URL character encoding is the <a href="dom.html#document-s-character-encoding" title="document's character encoding">character encoding</a> of <var title="">document</var>. (<a href="#sce-not-copy">This is a
+ <li><p>The URL character encoding is the <a href="infrastructure.html#document-s-character-encoding" title="document's character encoding">character encoding</a> of <var title="">document</var>. (<a href="#sce-not-copy">This is a
reference, not a copy</a>.)</p></li>
<li><p>The base URL is the <a href="urls.html#document-base-url" title="document base URL">base
@@ -614,7 +617,7 @@
<p>User agents may impose resource limitations on scripts, for
example CPU quotas, memory limits, total execution time limits, or
bandwidth limitations. When a script exceeds a limit, the user agent
- may either throw a <code><a href="common-dom-interfaces.html#quota_exceeded_err">QUOTA_EXCEEDED_ERR</a></code> exception, abort
+ may either throw a <code><a href="infrastructure.html#quota_exceeded_err">QUOTA_EXCEEDED_ERR</a></code> exception, abort
the script without an exception, prompt the user, or throttle script
execution.</p>
@@ -651,12 +654,14 @@
<dd>
- <p>The function must be invoked with three arguments. The three
- arguments passed to the function are all <code>DOMString</code>s;
- the first must give the message that the UA is considering
- reporting, the second must give the <a href="urls.html#absolute-url">absolute URL</a> of
- the resource in which the error occurred, and the third must give
- the line number in that resource on which the error occurred.</p>
+ <p>The function must be invoked with three arguments. The first
+ two arguments passed to the function must be of type
+ <code>DOMString</code>, and the third must be of type
+ <code>unsigned long</code>. The first must give the message that
+ the UA is considering reporting, the second must give the
+ <a href="urls.html#absolute-url">absolute URL</a> of the resource in which the error
+ occurred, and the third must give the line number in that resource
+ on which the error occurred.</p>
<p>If the function returns false, then the error is <i title="concept-error-handled"><a href="#concept-error-handled">handled</a></i>. Otherwise, the error is
<i title="concept-error-nothandled"><a href="#concept-error-nothandled">not handled</a></i>.</p>
@@ -785,11 +790,27 @@
was queued; if the task was queued by or for a <a href="#concept-script" title="concept-script">script</a> then the document is the
<a href="#script-s-document">script's document</a>.</p>
- <p>A user agent is required to have one <dfn id="storage-mutex">storage
- mutex</dfn>. This mutex is used to control access to shared state
- like cookies. At any one point, the <a href="#storage-mutex">storage mutex</a> is
- either free, or owned by a particular <a href="#event-loop">event loop</a> or
- instance of the <a href="fetching-resources.html#fetch" title="fetch">fetching</a> algorithm.</p>
+ <p>A user agent may have one <dfn id="storage-mutex">storage mutex</dfn>. This mutex is
+ used to control access to shared state like cookies. At any one
+ point, the <a href="#storage-mutex">storage mutex</a> is either free, or owned by a
+ particular <a href="#event-loop">event loop</a> or instance of the <a href="fetching-resources.html#fetch" title="fetch">fetching</a> algorithm.</p>
+
+ <p>If a user agent does not implement a <a href="#storage-mutex">storage mutex</a>,
+ it is exempt from implementing the requirements that require it to
+ acquire or release it.</p>
+
+ <p class="note">User agent implementors have to make a choice
+ between two evils. On the one hand, not implementing the storage
+ mutex means that there is a risk of data corruption: a site could,
+ for instance, try to read a cookie, increment its value, then write
+ it back out, using the new value of the cookie as a unique
+ identifier for the session; if the site does this twice in two
+ different browser windows at the same time, it might end up using
+ the same "unique" identifier for both sessions, with potentially
+ disastrous effects. On the other hand, implementing the storage
+ mutex has potentially serious performance implications: whenever a
+ site uses Web Storage or cookies, all other sites that try to use
+ Web Storage or cookies are blocked until the first site finishes.</p>
<p>Whenever a <a href="#concept-script" title="concept-script">script</a> calls into
a <a href="infrastructure.html#plugin">plugin</a>, and whenever a <a href="infrastructure.html#plugin">plugin</a> calls into
@@ -1148,7 +1169,7 @@
<dl class="switch"><dt>If the attribute is the <code title="handler-window-onerror"><a href="#handler-window-onerror">onerror</a></code> attribute of the
<code><a href="browsers.html#window">Window</a></code> object</dt>
- <dd>Let the function have three arguments, named <code title="">event</code>, <code title="">source</code>, and <code title="">fileno</code>.</dd>
+ <dd>Let the function have three arguments, named <code title="">event</code>, <code title="">source</code>, and <code title="">lineno</code>.</dd>
<dt>Otherwise</dt>
@@ -1260,7 +1281,7 @@
scripting language being used. It is represented in IDL as
follows:</p><pre class="idl">[Callback=FunctionOnly, NoInterfaceObject]
interface <dfn id="function">Function</dfn> {
- any <a href="#dom-function-call" title="dom-function-call">call</a>(in any... arguments);
+ any <a href="#dom-function-call" title="dom-function-call">call</a>(any... arguments);
};</pre><p>The <dfn id="dom-function-call" title="dom-function-call"><code>call(...)</code></dfn>
method is the object's callback.</p><p class="note">In JavaScript, any <code title="">Function</code>
object implements this interface.</p><p>If the <code><a href="#function">Function</a></code> object is a JavaScript <code title="">Function</code>, then when it is invoked by the user agent,
@@ -1280,18 +1301,12 @@
canceled or not: <span class="impl">as described above,</span> if
the return value is false, the event is canceled (except for <code class="event-mouseover">mouseover</code> events, where the return
value has to be true to cancel the event). With <code title="event-beforeunload">beforeunload</code> events, the value is
- instead used to determine the message to show the user.</p><div class="impl">
-
- <h5 id="event-handlers-on-elements-document-objects-and-window-objects"><span class="secno">6.1.6.2 </span>Event handlers on elements, <code><a href="infrastructure.html#document">Document</a></code> objects, and <code><a href="browsers.html#window">Window</a></code> objects</h5>
-
- <p>The following are the <a href="#event-handlers">event handlers</a> (and their
+ instead used to determine the message to show the user.</p><h5 id="event-handlers-on-elements-document-objects-and-window-objects"><span class="secno">6.1.6.2 </span>Event handlers on elements, <code><a href="infrastructure.html#document">Document</a></code> objects, and <code><a href="browsers.html#window">Window</a></code> objects</h5><p>The following are the <a href="#event-handlers">event handlers</a> (and their
corresponding <a href="#event-handler-event-type" title="event handler event type">event handler
- event types</a>) that must be supported by all <a href="infrastructure.html#html-elements">HTML
+ event types</a>) <span class="impl">that must be</span> supported by all <a href="infrastructure.html#html-elements">HTML
elements</a>, as both content attributes and IDL attributes, and
on <code><a href="infrastructure.html#document">Document</a></code> and <code><a href="browsers.html#window">Window</a></code> objects, as IDL
- attributes.</p>
-
- <table><thead><tr><th><a href="#event-handlers" title="event handlers">Event handler</a> </th><th><a href="#event-handler-event-type">Event handler event type</a>
+ attributes.</p><table><thead><tr><th><a href="#event-handlers" title="event handlers">Event handler</a> </th><th><a href="#event-handler-event-type">Event handler event type</a>
</th></tr></thead><tbody><tr><td><dfn id="handler-onabort" title="handler-onabort"><code>onabort</code></dfn> </td><td> <code title="event-abort">abort</code>
</td></tr><tr><td><dfn id="handler-oncanplay" title="handler-oncanplay"><code>oncanplay</code></dfn> </td><td> <code title="event-media-canplay"><a href="the-iframe-element.html#event-media-canplay">canplay</a></code>
</td></tr><tr><td><dfn id="handler-oncanplaythrough" title="handler-oncanplaythrough"><code>oncanplaythrough</code></dfn> </td><td> <code title="event-media-canplaythrough"><a href="the-iframe-element.html#event-media-canplaythrough">canplaythrough</a></code>
@@ -1348,12 +1363,10 @@
</td></tr></tbody></table><hr/><p>The following are the <a href="#event-handlers">event handlers</a> (and their
corresponding <a href="#event-handler-event-type" title="event handler event type">event handler
- event types</a>) that must be supported by all <a href="infrastructure.html#html-elements">HTML
+ event types</a>) <span class="impl">that must be</span> supported by all <a href="infrastructure.html#html-elements">HTML
elements</a> other than <code><a href="sections.html#the-body-element">body</a></code>, as both content
attributes and IDL attributes, and on <code><a href="infrastructure.html#document">Document</a></code> objects,
- as IDL attributes:</p>
-
- <table><thead><tr><th><a href="#event-handlers" title="event handlers">Event handler</a> </th><th><a href="#event-handler-event-type">Event handler event type</a>
+ as IDL attributes:</p><table><thead><tr><th><a href="#event-handlers" title="event handlers">Event handler</a> </th><th><a href="#event-handler-event-type">Event handler event type</a>
</th></tr></thead><tbody><tr><td><dfn id="handler-onblur" title="handler-onblur"><code>onblur</code></dfn> </td><td> <code title="event-blur">blur</code>
</td></tr><tr><td><dfn id="handler-onerror" title="handler-onerror"><code>onerror</code></dfn> </td><td> <code title="event-error">error</code>
</td></tr><tr><td><dfn id="handler-onfocus" title="handler-onfocus"><code>onfocus</code></dfn> </td><td> <code title="event-focus">focus</code>
@@ -1361,12 +1374,10 @@
</td></tr><tr><td><dfn id="handler-onscroll" title="handler-onscroll"><code>onscroll</code></dfn> </td><td> <code title="event-scroll">scroll</code>
</td></tr></tbody></table><hr/><p>The following are the <a href="#event-handlers">event handlers</a> (and their
corresponding <a href="#event-handler-event-type" title="event handler event type">event handler
- event types</a>) that must be supported by <code><a href="browsers.html#window">Window</a></code>
+ event types</a>) <span class="impl">that must be</span> supported by <code><a href="browsers.html#window">Window</a></code>
objects, as IDL attributes on the <code><a href="browsers.html#window">Window</a></code> object, and
with corresponding content attributes and IDL attributes exposed on
- the <code><a href="sections.html#the-body-element">body</a></code> and <code><a href="obsolete.html#frameset">frameset</a></code> elements:</p>
-
- <table><thead><tr><th><a href="#event-handlers" title="event handlers">Event handler</a> </th><th><a href="#event-handler-event-type">Event handler event type</a>
+ the <code><a href="sections.html#the-body-element">body</a></code> and <code><a href="obsolete.html#frameset">frameset</a></code> elements:</p><table><thead><tr><th><a href="#event-handlers" title="event handlers">Event handler</a> </th><th><a href="#event-handler-event-type">Event handler event type</a>
</th></tr></thead><tbody><tr><td><dfn id="handler-window-onafterprint" title="handler-window-onafterprint"><code>onafterprint</code></dfn> </td><td> <code title="event-afterprint">afterprint</code>
</td></tr><tr><td><dfn id="handler-window-onbeforeprint" title="handler-window-onbeforeprint"><code>onbeforeprint</code></dfn> </td><td> <code title="event-beforeprint">beforeprint</code>
</td></tr><tr><td><dfn id="handler-window-onbeforeunload" title="handler-window-onbeforeunload"><code>onbeforeunload</code></dfn> </td><td> <code title="event-beforeunload">beforeunload</code>
@@ -1388,9 +1399,7 @@
</td></tr><tr><td><dfn id="handler-window-onundo" title="handler-window-onundo"><code>onundo</code></dfn> </td><td> <code title="event-undo">undo</code>
</td></tr><tr><td><dfn id="handler-window-onunload" title="handler-window-onunload"><code>onunload</code></dfn> </td><td> <code title="event-unload">unload</code>
</td></tr></tbody></table><p class="note">The <code title="handler-window-onerror"><a href="#handler-window-onerror">onerror</a></code>
- handler is also used for <a href="#runtime-script-errors">reporting script errors</a>.</p>
-
- </div><div class="impl">
+ handler is also used for <a href="#runtime-script-errors">reporting script errors</a>.</p><div class="impl">
<h5 id="event-firing"><span class="secno">6.1.6.3 </span>Event firing</h5>
@@ -1447,10 +1456,10 @@
the parent of the <code><a href="infrastructure.html#document">Document</a></code> in the dispatch chain.</li>
</ol></div><h3 id="atob"><span class="secno">6.2 </span>Base64 utility methods</h3><p>The <code title="dom-windowbase64-atob"><a href="#dom-windowbase64-atob">atob()</a></code> and <code title="dom-windowbase64-btoa"><a href="#dom-windowbase64-btoa">btoa()</a></code> methods allow authors to
- transform content to and from the base64 encoding.</p><pre class="idl">[Supplemental, NoInterfaceObject]
+ transform content to and from the base64 encoding.</p><pre class="idl">[NoInterfaceObject]
interface <dfn id="windowbase64">WindowBase64</dfn> {
- DOMString <a href="#dom-windowbase64-btoa" title="dom-windowbase64-btoa">btoa</a>(in DOMString btoa);
- DOMString <a href="#dom-windowbase64-atob" title="dom-windowbase64-atob">atob</a>(in DOMString atob);
+ DOMString <a href="#dom-windowbase64-btoa" title="dom-windowbase64-btoa">btoa</a>(DOMString btoa);
+ DOMString <a href="#dom-windowbase64-atob" title="dom-windowbase64-atob">atob</a>(DOMString atob);
};
<a href="browsers.html#window">Window</a> implements <a href="#windowbase64">WindowBase64</a>;</pre><p class="note">In these APIs, for mnemonic purposes, the "b" can be
considered to stand for "binary", and the "a" for "ASCII". In
@@ -1464,7 +1473,7 @@
representing a binary byte with values 0x00 to 0xFF respectively,
and converts it to its base64 representation, which it returns.</p>
- <p>Throws an <code><a href="common-dom-interfaces.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if the
+ <p>Throws an <code><a href="infrastructure.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if the
input string contains any out-of-range characters.</p>
</dd>
@@ -1479,7 +1488,7 @@
each representing a binary byte with values 0x00 to 0xFF
respectively, corresponding to that binary data.</p>
- <p>Throws an <code><a href="common-dom-interfaces.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if the
+ <p>Throws an <code><a href="infrastructure.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if the
input string is not valid base64 data.</p>
</dd>
@@ -1491,7 +1500,7 @@
interface (part of Web Workers).</p>
<p>The <dfn id="dom-windowbase64-btoa" title="dom-windowbase64-btoa"><code>btoa()</code></dfn>
- method must throw an <code><a href="common-dom-interfaces.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if
+ method must throw an <code><a href="infrastructure.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception if
the method's first argument contains any character whose code point
is greater than U+00FF. Otherwise, the user agent must convert that
argument to a sequence of octets whose <var title="">n</var>th octet
@@ -1516,14 +1525,14 @@
<li><p>If the length of <var title="">input</var> divides by 4
leaving a remainder of 1, throw an
- <code><a href="common-dom-interfaces.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception and abort these
steps.</p>
</li><li>
<p>If <var title="">input</var> contains a character that is not
in the following list of characters and character ranges, throw an
- <code><a href="common-dom-interfaces.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception and abort these
+ <code><a href="infrastructure.html#invalid_character_err">INVALID_CHARACTER_ERR</a></code> exception and abort these
steps:</p>
<ul class="brief"><li>U+002B PLUS SIGN (+)
Index: common-microsyntaxes.html
===================================================================
RCS file: /sources/public/html5/markup/html5-spec/common-microsyntaxes.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- common-microsyntaxes.html 17 Jun 2011 08:49:05 -0000 1.12
+++ common-microsyntaxes.html 24 Aug 2011 07:56:03 -0000 1.13
@@ -19,6 +19,7 @@
dd table + p { margin-top: 1em; }
p + * > li, dd li { margin: 1em 0; }
dt, dfn { font-weight: bold; font-style: normal; }
+ i, em { font-style: italic; }
dt dfn { font-style: italic; }
pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
@@ -40,9 +41,10 @@
.dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
.toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
- img.extra { float: right; }
- pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
+ img.extra, p.overview { float: right; }
+ pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; position: relative; }
pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
+ pre.idl::before { content: "IDL"; font: bold small sans-serif; padding: 0.5em; background: white; position: absolute; top: 0; margin: -1px 0 0 -4em; width: 1.5em; border: thin solid; border-radius: 0 0 0 0.5em }
pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
pre.css:first-line { color: #AAAA50; }
dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; }
@@ -104,6 +106,7 @@
.note { color: green; background: transparent; font-family: sans-serif; }
.warning { color: red; background: transparent; }
.note, .warning { font-weight: bolder; font-style: italic; }
+ .note em, .warning em, .note i, .warning i { font-style: normal; }
p.note, div.note { padding: 0.5em 2em; }
span.note { padding: 0 2em; }
.note p:first-child, .warning p:first-child { margin-top: 0; }
@@ -325,7 +328,7 @@
<a href="urls.html" class="next">2.6 URLs</a>
<ol class="toc"><li><ol><li><a href="common-microsyntaxes.html#common-microsyntaxes"><span class="secno">2.5 </span>Common microsyntaxes</a>
<ol><li><a href="common-microsyntaxes.html#common-parser-idioms"><span class="secno">2.5.1 </span>Common parser idioms</a></li><li><a href="common-microsyntaxes.html#boolean-attributes"><span class="secno">2.5.2 </span>Boolean attributes</a></li><li><a href="common-microsyntaxes.html#keywords-and-enumerated-attributes"><span class="secno">2.5.3 </span>Keywords and enumerated attributes</a></li><li><a href="common-microsyntaxes.html#numbers"><span class="secno">2.5.4 </span>Numbers</a>
- <ol><li><a href="common-microsyntaxes.html#non-negative-integers"><span class="secno">2.5.4.1 </span>Non-negative integers</a></li><li><a href="common-microsyntaxes.html#signed-integers"><span class="secno">2.5.4.2 </span>Signed integers</a></li><li><a href="common-microsyntaxes.html#real-numbers"><span class="secno">2.5.4.3 </span>Real numbers</a></li><li><a href="common-microsyntaxes.html#percentages-and-dimensions"><span class="secno">2.5.4.4 </span>Percentages and lengths</a></li><li><a href="common-microsyntaxes.html#lists-of-integers"><span class="secno">2.5.4.5 </span>Lists of integers</a></li><li><a href="common-microsyntaxes.html#lists-of-dimensions"><span class="secno">2.5.4.6 </span>Lists of dimensions</a></li></ol></li><li><a href="common-microsyntaxes.html#dates-and-times"><span class="secno">2.5.5 </span>Dates and times</a>
+ <ol><li><a href="common-microsyntaxes.html#non-negative-integers"><span class="secno">2.5.4.1 </span>Non-negative integers</a></li><li><a href="common-microsyntaxes.html#signed-integers"><span class="secno">2.5.4.2 </span>Signed integers</a></li><li><a href="common-microsyntaxes.html#floating-point-numbers"><span class="secno">2.5.4.3 </span>Floating-point numbers</a></li><li><a href="common-microsyntaxes.html#percentages-and-dimensions"><span class="secno">2.5.4.4 </span>Percentages and lengths</a></li><li><a href="common-microsyntaxes.html#lists-of-integers"><span class="secno">2.5.4.5 </span>Lists of integers</a></li><li><a href="common-microsyntaxes.html#lists-of-dimensions"><span class="secno">2.5.4.6 </span>Lists of dimensions</a></li></ol></li><li><a href="common-microsyntaxes.html#dates-and-times"><span class="secno">2.5.5 </span>Dates and times</a>
<ol><li><a href="common-microsyntaxes.html#months"><span class="secno">2.5.5.1 </span>Months</a></li><li><a href="common-microsyntaxes.html#dates"><span class="secno">2.5.5.2 </span>Dates</a></li><li><a href="common-microsyntaxes.html#times"><span class="secno">2.5.5.3 </span>Times</a></li><li><a href="common-microsyntaxes.html#local-dates-and-times"><span class="secno">2.5.5.4 </span>Local dates and times</a></li><li><a href="common-microsyntaxes.html#global-dates-and-times"><span class="secno">2.5.5.5 </span>Global dates and times</a></li><li><a href="common-microsyntaxes.html#weeks"><span class="secno">2.5.5.6 </span>Weeks</a></li><li><a href="common-microsyntaxes.html#vaguer-moments-in-time"><span class="secno">2.5.5.7 </span>Vaguer moments in time</a></li></ol></li><li><a href="common-microsyntaxes.html#colors"><span class="secno">2.5.6 </span>Colors</a></li><li><a href="common-microsyntaxes.html#space-separated-tokens"><span class="secno">2.5.7 </span>Space-separated tokens</a></li><li><a href=common-microsyntaxes.html#comma-separated-tokens"><span class="secno">2.5.8 </span>Comma-separated tokens</a></li><li><a href="common-microsyntaxes.html#syntax-references"><span class="secno">2.5.9 </span>References</a></li><li><a href="common-microsyntaxes.html#mq"><span class="secno">2.5.10 </span>Media queries</a></li></ol></li></ol></li></ol></div><h3 id="common-microsyntaxes"><span class="secno">2.5 </span>Common microsyntaxes</h3><p>There are various places in HTML that accept particular data
types, such as dates or numbers. This section describes what the
conformance criteria for content in those formats is, and how to
@@ -344,17 +347,13 @@
<h4 id="common-parser-idioms"><span class="secno">2.5.1 </span>Common parser idioms</h4>
- <p>The <dfn id="space-character" title="space character">space characters</dfn>, for the
+ </div><p>The <dfn id="space-character" title="space character">space characters</dfn>, for the
purposes of this specification, are U+0020 SPACE, U+0009 CHARACTER
TABULATION (tab), U+000A LINE FEED (LF), U+000C FORM FEED (FF), and
- U+000D CARRIAGE RETURN (CR).</p>
-
- <p>The <dfn id="white_space" title="White_Space">White_Space characters</dfn> are
+ U+000D CARRIAGE RETURN (CR).</p><p>The <dfn id="white_space" title="White_Space">White_Space characters</dfn> are
those that have the Unicode property "White_Space" in the Unicode
- <code title="">PropList.txt</code> data file. <a href="references.html#refsUNICODE">[UNICODE]</a></p>
-
- <p class="note">This should not be confused with the "White_Space"
- value (abbreviated "WS") of the "Bidi_Class" property in the <code title="">Unicode.txt</code> data file.</p>
+ <code title="">PropList.txt</code> data file. <a href="references.html#refsUNICODE">[UNICODE]</a></p><p class="note">This should not be confused with the "White_Space"
+ value (abbreviated "WS") of the "Bidi_Class" property in the <code title="">Unicode.txt</code> data file.</p><div class="impl">
<p>The <dfn id="alphanumeric-ascii-characters">alphanumeric ASCII characters</dfn> are those in the
ranges U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE (9), U+0041 LATIN
@@ -400,6 +399,34 @@
<p>The <dfn id="code-point-length">code-point length</dfn> of a string is the number of
Unicode code points in that string.</p>
+ <p>When a user agent has to <dfn id="strictly-split-a-string">strictly split a string</dfn> on a
+ particular delimiter character <var title="">delimiter</var>, it
+ must use the following algorithm:</p>
+
+ <ol><li><p>Let <var title="">input</var> be the string being
+ parsed.</p></li>
+
+ <li><p>Let <var title="">position</var> be a pointer into <var title="">input</var>, initially pointing at the start of the
+ string.</p></li>
+
+ <li><p>Let <var title="">tokens</var> be a list of tokens,
+ initially empty.</p></li>
+
+ <li><p>While <var title="">position</var> is not past the end of
+ <var title="">input</var>:</p>
+
+ <ol><li><p><a href="#collect-a-sequence-of-characters">Collect a sequence of characters</a> that are not
+ the <var title="">delimiter</var> character.</p></li>
+
+ <li><p>Add the string collected in the previous step to <var title="">tokens</var>.</p></li>
+
+ </ol></li>
+
+ <li><p>Return <var title="">tokens</var>.</p></li>
+
+ </ol><p class="note">For the special cases of splitting a string <a href="#split-a-string-on-spaces" title="split a string on spaces">on spaces</a> and <a href="#split-a-string-on-spaces" title="split a string on spaces">on commas</a>, this algorithm
+ does not apply (those algorithms also perform <a href="#strip-leading-and-trailing-whitespace" title="strip leading and trailing whitespace">whitespace trimming</a>).</p>
+
</div><h4 id="boolean-attributes"><span class="secno">2.5.2 </span>Boolean attributes</h4><p>A number of attributes are <dfn id="boolean-attribute" title="boolean attribute">boolean
attributes</dfn>. The presence of a boolean attribute on an element
represents the true value, and the absence of the attribute
@@ -549,7 +576,7 @@
<li><p>If <var title="">sign</var> is "positive", return <var title="">value</var>, otherwise return the result of subtracting
<var title="">value</var> from zero.</p></li>
- </ol></div><h5 id="real-numbers"><span class="secno">2.5.4.3 </span>Real numbers</h5><p>A string is a <dfn id="valid-floating-point-number">valid floating point number</dfn> if it
+ </ol></div><h5 id="floating-point-numbers"><span class="secno">2.5.4.3 </span>Floating-point numbers</h5><p>A string is a <dfn id="valid-floating-point-number">valid floating point number</dfn> if it
consists of:</p><ol class="brief"><li>Optionally, a U+002D HYPHEN-MINUS character (-).</li>
<li>A series of one or more characters in the range U+0030 DIGIT
@@ -2134,7 +2161,7 @@
U+002C COMMA characters (,). Let <var title="">s</var> be the resulting sequence (which might be the
empty string).</p></li>
- <li><p>Remove any leading or trailing sequence of <a href="#space-character" title="space character">space characters</a> from <var title="">s</var>.</p></li>
+ <li><p><a href="#strip-leading-and-trailing-whitespace">Strip leading and trailing whitespace</a> from <var title="">s</var>.</p></li>
<li><p>Add <var title="">s</var> to <var title="">tokens</var>.</p></li>
Received on Wednesday, 24 August 2011 07:57:21 UTC