[html5] r3527 - [] (0) Text explaining what the element definitions mean and stating that some p [...]
whatwg at whatwg.org
whatwg at whatwg.org
Mon Aug 3 00:00:40 PDT 2009
Author: ianh
Date: 2009-08-03 00:00:38 -0700 (Mon, 03 Aug 2009)
New Revision: 3527
Modified:
index
source
Log:
[] (0) Text explaining what the element definitions mean and stating that some parts of those definitions are normative.
Modified: index
===================================================================
--- index 2009-08-03 03:24:43 UTC (rev 3526)
+++ index 2009-08-03 07:00:38 UTC (rev 3527)
@@ -263,30 +263,31 @@
<li><a href=#the-dir-attribute><span class=secno>3.3.3.5 </span>The <code>dir</code> attribute</a></li>
<li><a href=#classes><span class=secno>3.3.3.6 </span>The <code>class</code> attribute</a></li>
<li><a href=#the-style-attribute><span class=secno>3.3.3.7 </span>The <code>style</code> attribute</a></li>
- <li><a href=#embedding-custom-non-visible-data><span class=secno>3.3.3.8 </span>Embedding custom non-visible data</a></ol></ol></li>
- <li><a href=#content-models><span class=secno>3.4 </span>Content models</a>
- <ol>
- <li><a href=#kinds-of-content><span class=secno>3.4.1 </span>Kinds of content</a>
+ <li><a href=#embedding-custom-non-visible-data><span class=secno>3.3.3.8 </span>Embedding custom non-visible data</a></ol></li>
+ <li><a href=#element-definitions><span class=secno>3.3.4 </span>Element definitions</a></li>
+ <li><a href=#content-models><span class=secno>3.3.5 </span>Content models</a>
<ol>
- <li><a href=#metadata-content><span class=secno>3.4.1.1 </span>Metadata content</a></li>
- <li><a href=#flow-content><span class=secno>3.4.1.2 </span>Flow content</a></li>
- <li><a href=#sectioning-content><span class=secno>3.4.1.3 </span>Sectioning content</a></li>
- <li><a href=#heading-content><span class=secno>3.4.1.4 </span>Heading content</a></li>
- <li><a href=#phrasing-content><span class=secno>3.4.1.5 </span>Phrasing content</a></li>
- <li><a href=#embedded-content><span class=secno>3.4.1.6 </span>Embedded content</a></li>
- <li><a href=#interactive-content><span class=secno>3.4.1.7 </span>Interactive content</a></ol></li>
- <li><a href=#transparent-content-models><span class=secno>3.4.2 </span>Transparent content models</a></ol></li>
- <li><a href=#paragraphs><span class=secno>3.5 </span>Paragraphs</a></li>
- <li><a href=#apis-in-html-documents><span class=secno>3.6 </span>APIs in HTML documents</a></li>
- <li><a href=#interactions-with-xpath-and-xslt><span class=secno>3.7 </span>Interactions with XPath and XSLT</a></li>
- <li><a href=#dynamic-markup-insertion><span class=secno>3.8 </span>Dynamic markup insertion</a>
+ <li><a href=#kinds-of-content><span class=secno>3.3.5.1 </span>Kinds of content</a>
+ <ol>
+ <li><a href=#metadata-content><span class=secno>3.3.5.1.1 </span>Metadata content</a></li>
+ <li><a href=#flow-content><span class=secno>3.3.5.1.2 </span>Flow content</a></li>
+ <li><a href=#sectioning-content><span class=secno>3.3.5.1.3 </span>Sectioning content</a></li>
+ <li><a href=#heading-content><span class=secno>3.3.5.1.4 </span>Heading content</a></li>
+ <li><a href=#phrasing-content><span class=secno>3.3.5.1.5 </span>Phrasing content</a></li>
+ <li><a href=#embedded-content><span class=secno>3.3.5.1.6 </span>Embedded content</a></li>
+ <li><a href=#interactive-content><span class=secno>3.3.5.1.7 </span>Interactive content</a></ol></li>
+ <li><a href=#transparent-content-models><span class=secno>3.3.5.2 </span>Transparent content models</a></li>
+ <li><a href=#paragraphs><span class=secno>3.3.5.3 </span>Paragraphs</a></ol></ol></li>
+ <li><a href=#apis-in-html-documents><span class=secno>3.4 </span>APIs in HTML documents</a></li>
+ <li><a href=#interactions-with-xpath-and-xslt><span class=secno>3.5 </span>Interactions with XPath and XSLT</a></li>
+ <li><a href=#dynamic-markup-insertion><span class=secno>3.6 </span>Dynamic markup insertion</a>
<ol>
- <li><a href=#controlling-the-input-stream><span class=secno>3.8.1 </span>Controlling the input stream</a></li>
- <li><a href=#document.write()><span class=secno>3.8.2 </span><code title=dom-document-write>document.write()</code></a></li>
- <li><a href=#document.writeln()><span class=secno>3.8.3 </span><code title=dom-document-writeln>document.writeln()</code></a></li>
- <li><a href=#innerhtml><span class=secno>3.8.4 </span><code title=dom-innerHTML>innerHTML</code></a></li>
- <li><a href=#outerhtml><span class=secno>3.8.5 </span><code title=dom-outerHTML>outerHTML</code></a></li>
- <li><a href=#insertadjacenthtml()><span class=secno>3.8.6 </span><code title=dom-insertAdjacentHTML>insertAdjacentHTML()</code></a></ol></ol></li>
+ <li><a href=#controlling-the-input-stream><span class=secno>3.6.1 </span>Controlling the input stream</a></li>
+ <li><a href=#document.write()><span class=secno>3.6.2 </span><code title=dom-document-write>document.write()</code></a></li>
+ <li><a href=#document.writeln()><span class=secno>3.6.3 </span><code title=dom-document-writeln>document.writeln()</code></a></li>
+ <li><a href=#innerhtml><span class=secno>3.6.4 </span><code title=dom-innerHTML>innerHTML</code></a></li>
+ <li><a href=#outerhtml><span class=secno>3.6.5 </span><code title=dom-outerHTML>outerHTML</code></a></li>
+ <li><a href=#insertadjacenthtml()><span class=secno>3.6.6 </span><code title=dom-insertAdjacentHTML>insertAdjacentHTML()</code></a></ol></ol></li>
<li><a href=#semantics><span class=secno>4 </span>The elements of HTML</a>
<ol>
<li><a href=#the-root-element><span class=secno>4.1 </span>The root element</a>
@@ -8152,8 +8153,52 @@
- <h3 id=content-models><span class=secno>3.4 </span>Content models</h3>
+ <h4 id=element-definitions><span class=secno>3.3.4 </span>Element definitions</h4>
+ <p>Each element in this specification has a definition that includes
+ the following information:</p>
+
+ <dl><dt>Categories</dt>
+
+ <dd>A list of <a href=#content-categories title="content categories">categories</a> to
+ which the element belongs. These are used when defining the
+ <a href=#content-models>content models</a> for each element.</dd>
+
+
+ <dt>Contexts in which this element may be used</dt>
+
+ <dd>A <em>non-normative</em> description of where the element can
+ be used. This information is redundant with the content models of
+ elements that allow this one as a child, and is provided only as a
+ convenience.</dd>
+
+
+ <dt>Content model</dt>
+
+ <dd>A normative description of what content must be included as
+ children and descendants of the element.</dd>
+
+
+ <dt>Content attributes</dt>
+
+ <dd>A normative list of attributes that may be specified on the
+ element.</dd>
+
+
+ <dt>DOM interface</dt>
+
+ <dd>A normative definition of a DOM interface that such elements
+ must implement.</dd>
+
+ </dl><p>This is then followed by a description of what the element
+ <a href=#represents>represents</a>, along with any additional normative
+ conformance criteria that may apply to authors<span class=impl title=""> and implementations</span>. Examples are sometimes
+ also included.</p>
+
+
+
+ <h4 id=content-models><span class=secno>3.3.5 </span><dfn>Content models</dfn></h4>
+
<p>All the elements in this specification have a defined content
model, which describes what nodes are allowed inside the elements,
and thus what the structure of an HTML document or fragment must
@@ -8217,11 +8262,12 @@
</div>
- <h4 id=kinds-of-content><span class=secno>3.4.1 </span>Kinds of content</h4>
+ <h5 id=kinds-of-content><span class=secno>3.3.5.1 </span>Kinds of content</h5>
- <p>Each element in HTML falls into zero or more categories that
- group elements with similar characteristics together. The following
- broad categories are used in this specification:</p>
+ <p>Each element in HTML falls into zero or more <dfn id=content-categories title="content
+ categories">categories</dfn> that group elements with similar
+ characteristics together. The following broad categories are used in
+ this specification:</p>
<ul class=brief><li><a href=#metadata-content-0>Metadata content</a></li>
<li><a href=#flow-content-0>Flow content</a></li>
@@ -8230,8 +8276,11 @@
<li><a href=#phrasing-content-0>Phrasing content</a></li>
<li><a href=#embedded-content-2>Embedded content</a></li>
<li><a href=#interactive-content-0>Interactive content</a></li>
- </ul><p>These categories are related as follows:
+ </ul><p class=note>Some elements also fall into other categories, which
+ are defined in other parts of this specification.</p>
+ <p>These categories are related as follows:</p>
+
<p><object data=images/content-venn.svg height=288 width=512><img alt="Sectioning content, heading content, phrasing content, and
embedded content are all types of flow content. Embedded content is
also a type of phrasing content." src=images/content-venn.png></object></p>
@@ -8247,7 +8296,7 @@
particular category.</p>
- <h5 id=metadata-content><span class=secno>3.4.1.1 </span>Metadata content</h5>
+ <h6 id=metadata-content><span class=secno>3.3.5.1.1 </span>Metadata content</h6>
<p><dfn id=metadata-content-0>Metadata content</dfn> is content that sets up the
presentation or behavior of the rest of the content, or that sets
@@ -8295,7 +8344,7 @@
</div>
- <h5 id=flow-content><span class=secno>3.4.1.2 </span>Flow content</h5>
+ <h6 id=flow-content><span class=secno>3.3.5.1.2 </span>Flow content</h6>
<p>Most elements that are used in the body of documents and
applications are categorized as <dfn id=flow-content-0>flow content</dfn>.</p>
@@ -8399,7 +8448,7 @@
pages be filled in but on some pages is not relevant.</p>
- <h5 id=sectioning-content><span class=secno>3.4.1.3 </span>Sectioning content</h5>
+ <h6 id=sectioning-content><span class=secno>3.3.5.1.3 </span>Sectioning content</h6>
<p><dfn id=sectioning-content-0>Sectioning content</dfn> is content that defines the scope
of <a href=#heading-content-0 title="heading content">headings</a> and <a href=#the-footer-element title=footer>footers</a>.</p>
@@ -8417,7 +8466,7 @@
<a href=#outline>outline</a>.</p>
- <h5 id=heading-content><span class=secno>3.4.1.4 </span>Heading content</h5>
+ <h6 id=heading-content><span class=secno>3.3.5.1.4 </span>Heading content</h6>
<p><dfn id=heading-content-0>Heading content</dfn> defines the header of a section
(whether explicitly marked up using <a href=#sectioning-content-0>sectioning content</a>
@@ -8430,7 +8479,7 @@
<li><code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h5</a></code></li>
<li><code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code></li>
<li><code><a href=#the-hgroup-element>hgroup</a></code></li>
- </ul><h5 id=phrasing-content><span class=secno>3.4.1.5 </span>Phrasing content</h5>
+ </ul><h6 id=phrasing-content><span class=secno>3.3.5.1.5 </span>Phrasing content</h6>
<p><dfn id=phrasing-content-0>Phrasing content</dfn> is the text of the document, as well
as elements that mark up that text at the intra-paragraph
@@ -8509,7 +8558,7 @@
character">space characters</a>).</p>
- <h5 id=embedded-content><span class=secno>3.4.1.6 </span>Embedded content</h5>
+ <h6 id=embedded-content><span class=secno>3.3.5.1.6 </span>Embedded content</h6>
<p><dfn id=embedded-content-2>Embedded content</dfn> is content that imports another
resource into the document, or content from another vocabulary that
@@ -8535,7 +8584,7 @@
element definitions state what the fallback is, if any.</p>
- <h5 id=interactive-content><span class=secno>3.4.1.7 </span>Interactive content</h5>
+ <h6 id=interactive-content><span class=secno>3.3.5.1.7 </span>Interactive content</h6>
<!--
TESTS:
@@ -8657,7 +8706,7 @@
</div>
- <h4 id=transparent-content-models><span class=secno>3.4.2 </span>Transparent content models</h4>
+ <h5 id=transparent-content-models><span class=secno>3.3.5.2 </span>Transparent content models</h5>
<p>Some elements are described as <dfn id=transparent>transparent</dfn>; they have
"transparent" in the description of their content model.</p>
@@ -8673,7 +8722,7 @@
accepting any <a href=#flow-content-0>flow content</a>.</p>
- <h3 id=paragraphs><span class=secno>3.5 </span>Paragraphs</h3>
+ <h5 id=paragraphs><span class=secno>3.3.5.3 </span>Paragraphs</h5>
<p class=note>The term <a href=#paragraph>paragraph</a> as defined in this
section is distinct from (though related to) the <code><a href=#the-p-element>p</a></code>
@@ -8852,7 +8901,7 @@
- <h3 id=apis-in-html-documents><span class=secno>3.6 </span>APIs in HTML documents</h3>
+ <h3 id=apis-in-html-documents><span class=secno>3.4 </span>APIs in HTML documents</h3>
<p>For <a href=#html-documents>HTML documents</a>, and for <a href=#html-elements>HTML
elements</a> in <a href=#html-documents>HTML documents</a>, certain APIs defined
@@ -8966,7 +9015,7 @@
</dl><div class=impl>
- <h3 id=interactions-with-xpath-and-xslt><span class=secno>3.7 </span>Interactions with XPath and XSLT</h3>
+ <h3 id=interactions-with-xpath-and-xslt><span class=secno>3.5 </span>Interactions with XPath and XSLT</h3>
<p id=xpath-1.0-processors>Implementations of XPath 1.0 that
operate on HTML documents parsed or created in the manners described
@@ -9014,7 +9063,7 @@
- <h3 id=dynamic-markup-insertion><span class=secno>3.8 </span><dfn>Dynamic markup insertion</dfn></h3>
+ <h3 id=dynamic-markup-insertion><span class=secno>3.6 </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
@@ -9024,7 +9073,7 @@
- <h4 id=controlling-the-input-stream><span class=secno>3.8.1 </span>Controlling the input stream</h4>
+ <h4 id=controlling-the-input-stream><span class=secno>3.6.1 </span>Controlling 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
@@ -9232,7 +9281,7 @@
- <h4 id=document.write()><span class=secno>3.8.2 </span><code title=dom-document-write><a href=#dom-document-write>document.write()</a></code></h4>
+ <h4 id=document.write()><span class=secno>3.6.2 </span><code title=dom-document-write><a href=#dom-document-write>document.write()</a></code></h4>
<dl class=domintro><dt><var title="">document</var> . <code title=dom-document-write><a href=#dom-document-write>write</a></code>(<var title="">text</var>...)</dt>
@@ -9318,7 +9367,7 @@
</ol></div>
- <h4 id=document.writeln()><span class=secno>3.8.3 </span><code title=dom-document-writeln><a href=#dom-document-writeln>document.writeln()</a></code></h4>
+ <h4 id=document.writeln()><span class=secno>3.6.3 </span><code title=dom-document-writeln><a href=#dom-document-writeln>document.writeln()</a></code></h4>
<dl class=domintro><dt><var title="">document</var> . <code title=dom-document-writeln><a href=#dom-document-writeln>writeln</a></code>(<var title="">text</var>...)</dt>
@@ -9345,7 +9394,7 @@
- <h4 id=innerhtml><span class=secno>3.8.4 </span><code title=dom-innerHTML><a href=#dom-innerhtml>innerHTML</a></code></h4>
+ <h4 id=innerhtml><span class=secno>3.6.4 </span><code title=dom-innerHTML><a href=#dom-innerhtml>innerHTML</a></code></h4>
<p>The <dfn id=dom-innerhtml title=dom-innerHTML><code>innerHTML</code></dfn> DOM
attribute represents the markup of the node's contents.</p>
@@ -9505,7 +9554,7 @@
- <h4 id=outerhtml><span class=secno>3.8.5 </span><code title=dom-outerHTML><a href=#dom-outerhtml>outerHTML</a></code></h4>
+ <h4 id=outerhtml><span class=secno>3.6.5 </span><code title=dom-outerHTML><a href=#dom-outerhtml>outerHTML</a></code></h4>
<p>The <dfn id=dom-outerhtml title=dom-outerHTML><code>outerHTML</code></dfn> DOM
attribute represents the markup of the element and its contents.</p>
@@ -9612,7 +9661,7 @@
- <h4 id=insertadjacenthtml()><span class=secno>3.8.6 </span><code title=dom-insertAdjacentHTML><a href=#dom-insertadjacenthtml>insertAdjacentHTML()</a></code></h4>
+ <h4 id=insertadjacenthtml()><span class=secno>3.6.6 </span><code title=dom-insertAdjacentHTML><a href=#dom-insertadjacenthtml>insertAdjacentHTML()</a></code></h4>
<dl class=domintro><dt><var title="">element</var> . <code title=dom-insertAdjacentHTML><a href=#dom-insertadjacenthtml>insertAdjacentHTML</a></code>(<var title="">position</var>, <var title="">text</var>)</dt>
@@ -33831,7 +33880,6 @@
<li><p>If the method invoked was the <code title=dom-input-stepDown><a href=#dom-input-stepdown>stepDown()</a></code> method, negate <var title="">delta</var>.</li>
<li><p>Let <var title="">value</var> be the result of adding <var title="">delta</var> to <var title="">value</var>.</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=#invalid_access_err>INVALID_ACCESS_ERR</a></code> exception.</li>
Modified: source
===================================================================
--- source 2009-08-03 03:24:43 UTC (rev 3526)
+++ source 2009-08-03 07:00:38 UTC (rev 3527)
@@ -8322,8 +8322,57 @@
- <h3>Content models</h3>
+ <h4>Element definitions</h4>
+ <p>Each element in this specification has a definition that includes
+ the following information:</p>
+
+ <dl>
+
+ <dt>Categories</dt>
+
+ <dd>A list of <span title="content categories">categories</span> to
+ which the element belongs. These are used when defining the
+ <span>content models</span> for each element.</dd>
+
+
+ <dt>Contexts in which this element may be used</dt>
+
+ <dd>A <em>non-normative</em> description of where the element can
+ be used. This information is redundant with the content models of
+ elements that allow this one as a child, and is provided only as a
+ convenience.</dd>
+
+
+ <dt>Content model</dt>
+
+ <dd>A normative description of what content must be included as
+ children and descendants of the element.</dd>
+
+
+ <dt>Content attributes</dt>
+
+ <dd>A normative list of attributes that may be specified on the
+ element.</dd>
+
+
+ <dt>DOM interface</dt>
+
+ <dd>A normative definition of a DOM interface that such elements
+ must implement.</dd>
+
+ </dl>
+
+ <p>This is then followed by a description of what the element
+ <span>represents</span>, along with any additional normative
+ conformance criteria that may apply to authors<span title=""
+ class="impl"> and implementations</span>. Examples are sometimes
+ also included.</p>
+
+
+
+ <h4><dfn>Content models</dfn></h4>
+
<p>All the elements in this specification have a defined content
model, which describes what nodes are allowed inside the elements,
and thus what the structure of an HTML document or fragment must
@@ -8394,11 +8443,12 @@
</div>
- <h4>Kinds of content</h4>
+ <h5>Kinds of content</h5>
- <p>Each element in HTML falls into zero or more categories that
- group elements with similar characteristics together. The following
- broad categories are used in this specification:</p>
+ <p>Each element in HTML falls into zero or more <dfn title="content
+ categories">categories</dfn> that group elements with similar
+ characteristics together. The following broad categories are used in
+ this specification:</p>
<ul class="brief">
<li><span>Metadata content</span></li>
@@ -8410,8 +8460,11 @@
<li><span>Interactive content</span></li>
</ul>
- <p>These categories are related as follows:
+ <p class="note">Some elements also fall into other categories, which
+ are defined in other parts of this specification.</p>
+ <p>These categories are related as follows:</p>
+
<p><object width="512" height="288"
data="images/content-venn.svg"><img src="images/content-venn.png"
alt="Sectioning content, heading content, phrasing content, and
@@ -8430,7 +8483,7 @@
particular category.</p>
- <h5>Metadata content</h5>
+ <h6>Metadata content</h6>
<p><dfn>Metadata content</dfn> is content that sets up the
presentation or behavior of the rest of the content, or that sets
@@ -8481,7 +8534,7 @@
</div>
- <h5>Flow content</h5>
+ <h6>Flow content</h6>
<p>Most elements that are used in the body of documents and
applications are categorized as <dfn>flow content</dfn>.</p>
@@ -8588,7 +8641,7 @@
pages be filled in but on some pages is not relevant.</p>
- <h5>Sectioning content</h5>
+ <h6>Sectioning content</h6>
<p><dfn>Sectioning content</dfn> is content that defines the scope
of <span title="heading content">headings</span> and <span
@@ -8611,7 +8664,7 @@
<span>outline</span>.</p>
- <h5>Heading content</h5>
+ <h6>Heading content</h6>
<p><dfn>Heading content</dfn> defines the header of a section
(whether explicitly marked up using <span>sectioning content</span>
@@ -8628,7 +8681,7 @@
</ul>
- <h5>Phrasing content</h5>
+ <h6>Phrasing content</h6>
<p><dfn>Phrasing content</dfn> is the text of the document, as well
as elements that mark up that text at the intra-paragraph
@@ -8712,7 +8765,7 @@
character">space characters</span>).</p>
- <h5>Embedded content</h5>
+ <h6>Embedded content</h6>
<p><dfn>Embedded content</dfn> is content that imports another
resource into the document, or content from another vocabulary that
@@ -8741,7 +8794,7 @@
element definitions state what the fallback is, if any.</p>
- <h5>Interactive content</h5>
+ <h6>Interactive content</h6>
<!--
TESTS:
@@ -8882,7 +8935,7 @@
</div>
- <h4>Transparent content models</h4>
+ <h5>Transparent content models</h5>
<p>Some elements are described as <dfn>transparent</dfn>; they have
"transparent" in the description of their content model.</p>
@@ -8898,7 +8951,7 @@
accepting any <span>flow content</span>.</p>
- <h3>Paragraphs</h3>
+ <h5>Paragraphs</h5>
<p class="note">The term <span>paragraph</span> as defined in this
section is distinct from (though related to) the <code>p</code>
@@ -37690,7 +37743,6 @@
<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 <span
title="concept-input-min">minimum</span>, and the <var
title="">value</var> is less than that <span
More information about the Commit-Watchers
mailing list