- From: Lachlan Hunt via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 02 Feb 2009 02:48:51 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-author
In directory hutz:/tmp/cvs-serv24191
Modified Files:
Overview.html Overview.src.html
Log Message:
Added sectioning root and transparent content models
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/html-author/Overview.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -d -r1.30 -r1.31
--- Overview.html 1 Feb 2009 22:54:11 -0000 1.30
+++ Overview.html 2 Feb 2009 02:48:49 -0000 1.31
@@ -16,7 +16,7 @@
.element .summary .kinds-of-content { margin: 0; padding: 0; width: 100%; border-spacing: .5em .2em; }
.element .summary th, .element .summary td { padding: .2em 0; text-align: left; vertical-align: top; }
.element .summary th { width: 20%; }
-
+ .element .summary table ul { margin: 0; padding: 0; }
.element .properties { display: table; width: 100%; border-collapse: collapse; }
.element .attributes, .element .dom { display: table-cell; width: 50%; }
.element .dom { border-left: 3px solid #9F9; }
@@ -53,11 +53,11 @@
<!--begin-logo--><p><a href=http://www.w3.org/><img alt=W3C src=http://www.w3.org/Icons/w3c_home></a></p><!--end-logo-->
<h1>HTML 5 Reference</h1>
<h2 class="no-num no-toc">A Web Developer’s Guide to HTML 5</h2>
- <h2 class="no-num no-toc">W3C Editor’s Draft 1 February 2009</h2>
+ <h2 class="no-num no-toc">W3C Editor’s Draft 2 February 2009</h2>
<dl>
<dt>This version:</dt>
- <dd><a href=[VERSION]>http://www.w3.org/TR/2009/ED-html5-author-20090201</a></dd>
+ <dd><a href=[VERSION]>http://www.w3.org/TR/2009/ED-html5-author-20090202</a></dd>
<dt>Latest version:</dt>
<dd><a href=http://www.w3.org/TR/>http://www.w3.org/TR/</a></dd>
<dt>Previous version:</dt>
@@ -135,12 +135,13 @@
<ol class=toc>
<li><a href=#metadata-content><span class=secno>4.1.1 </span>Metadata Content</a></li>
<li><a href=#flow-content><span class=secno>4.1.2 </span>Flow content</a></li>
- <li><a href=#sectioning-content><span class=secno>4.1.3 </span>Sectioning content</a></li>
- <li><a href=#heading-content><span class=secno>4.1.4 </span>Heading content</a></li>
- <li><a href=#phrasing-content><span class=secno>4.1.5 </span>Phrasing content</a></li>
- <li><a href=#embedded-content><span class=secno>4.1.6 </span>Embedded content</a></li>
- <li><a href=#interactive-content><span class=secno>4.1.7 </span>Interactive content</a></li>
- <li><a href=#sections><span class=secno>4.1.8 </span>Sections</a></li></ol></li>
+ <li><a href=#sectioning-root><span class=secno>4.1.3 </span>Sectioning root</a></li>
+ <li><a href=#sectioning-content><span class=secno>4.1.4 </span>Sectioning content</a></li>
+ <li><a href=#heading-content><span class=secno>4.1.5 </span>Heading content</a></li>
+ <li><a href=#phrasing-content><span class=secno>4.1.6 </span>Phrasing content</a></li>
+ <li><a href=#embedded-content><span class=secno>4.1.7 </span>Embedded content</a></li>
+ <li><a href=#interactive-content><span class=secno>4.1.8 </span>Interactive content</a></li>
+ <li><a href=#transparent-content-models><span class=secno>4.1.9 </span>Transparent Content Models</a></li></ol></li>
<li><a href=#the-elements><span class=secno>4.2 </span>The Elements</a>
<ol class=toc>
<li><a href=#the-html-element><span class=secno>4.2.1 </span>The <code>html</code> element</a></li>
@@ -429,11 +430,13 @@
<ul>
<li><a href=#metadata-content>Metadata content</a></li>
<li><a href=#flow-content>Flow content</a></li>
+ <li><a href=#sectioning-root>Sectioning root</a></li>
<li><a href=#sectioning-content>Sectioning content</a></li>
<li><a href=#heading-content>Heading content</a></li>
<li><a href=#phrasing-content>Phrasing content</a></li>
<li><a href=#embedded-content>Embedded content</a></li>
<li><a href=#interactive-content>Interactive content</a></li>
+ <li><a href=#transparent-content-models>Transparent</a></li>
</ul>
<p>Some elements have unique requirements and do not fit into any particular
@@ -466,19 +469,28 @@
<p class=note>Elements categorised as heading content, phrasing content or
embedded content are also considered to be flow content.</p>
- <h4 id=sectioning-content><span class=secno>4.1.3 </span><dfn>Sectioning content</dfn></h4>
+ <h4 id=sectioning-root><span class=secno>4.1.3 </span><dfn>Sectioning root</dfn></h4>
+ <p class=issue>[This description needs improving.]</p>
+ <p>These elements can have their own outlines, but the sections and
+ headers inside these elements do not contribute to the outlines of
+ their ancestors.</p>
+
+ <p>Some common sectioning root elements include, among others,
+ <code><a href=#the-body-element>body</a></code>, <code><a href=#the-blockquote-element>blockquote</a></code> and <code><a href=#the-figure-element>figure</a></code>.</p>
+
+ <h4 id=sectioning-content><span class=secno>4.1.4 </span><dfn>Sectioning content</dfn></h4>
<p>Sectioning content is used for structuring a document into sections,
each of which generally has its own heading. These elements provide a
scope within which associated headers, footers and contact information
apply.</p>
- <p>Some common sectioning elements include, among others, <code><a href=#the-body-element>body</a></code>,
- <code><a href=#the-section-element>section</a></code> and <code><a href=#the-article-element>article</a></code>.</p>
+ <p>Some common sectioning elements include, among others,
+ <code><a href=#the-section-element>section</a></code>, <code><a href=#the-article-element>article</a></code> and <code><a href=#the-nav-element>nav</a></code>.</p>
<p class=note>Most sectioning elements, with the exception of the body
element, are also classified as flow content.</p>
- <h4 id=heading-content><span class=secno>4.1.4 </span><dfn>Heading content</dfn></h4>
+ <h4 id=heading-content><span class=secno>4.1.5 </span><dfn>Heading content</dfn></h4>
<p>Heading content includes the elements for marking up headers. Headings,
in conjunction with the sectioning elements, are used to describe the the
@@ -490,7 +502,7 @@
<p class=note>Elements categorised as heading content are considered to be
flow content.</p>
- <h4 id=phrasing-content><span class=secno>4.1.5 </span><dfn>Phrasing content</dfn></h4>
+ <h4 id=phrasing-content><span class=secno>4.1.6 </span><dfn>Phrasing content</dfn></h4>
<p>Phrasing content includes text and text-level markup. This is similar to
the concept of inline level elements in HTML 4.01. Most elements that
are categorised as phrasing content can only contain other phrasing
@@ -502,7 +514,7 @@
<p class=note>Elements categorised as phrasing content are considered to
be flow content.</p>
- <h4 id=embedded-content><span class=secno>4.1.6 </span><dfn>Embedded content</dfn></h4>
+ <h4 id=embedded-content><span class=secno>4.1.7 </span><dfn>Embedded content</dfn></h4>
<p>Embedded content includes elements that load external resources into the
document. Such external resources include, for example, images, videos
and Flash-based content. Some embedded content elements include
@@ -512,7 +524,7 @@
<p class=note>Elements categorised as embedded content are considered to
be phrasing content, and thus also considered to be flow content.</p>
- <h4 id=interactive-content><span class=secno>4.1.7 </span><dfn>Interactive content</dfn></h4>
+ <h4 id=interactive-content><span class=secno>4.1.8 </span><dfn>Interactive content</dfn></h4>
<p>Interactive elements are those that allow the user to interact with or
activate in some way. Depending on the user's browser and device, this
could be performed using any kind of input device, such as, for example,
@@ -522,18 +534,15 @@
<code><a href=#the-a-element>a</a></code>, <code><a href=#the-video-element>video</a></code> when used with the
<code>controls</code> attribute, and most form controls using
<code><a href=#the-input-element>input</a></code>.</p>
-
-
- <h4 id=sections><span class=secno>4.1.8 </span>Sections</h4>
- <p><dfn id=sectioning-elements>Sectioning elements</dfn> are elements that divide the page into,
- for lack of a better word, sections. This section describes HTML's
- sectioning elements and elements that support them.</p>
-
- <p>Some elements are scoped to their nearest ancestor sectioning element.
- For example, <code><a href=#the-address-element>address</a></code> elements apply just to their section.
- For such elements <var title="">x</var>, the elements that apply to a
- sectioning element <var title="">e</var> are all the <var title="">x</var>
- elements whose nearest sectioning
+
+ <h4 id=transparent-content-models><span class=secno>4.1.9 </span><dfn>Transparent</dfn> Content Models</h4>
+
+ <p>Some elements have transparent content models, meaning that their
+ allowed content depends upon the parent element. They may contain
+ any content that their parent element may contain, in addition to
+ any other allowances or exceptions described for the element.</p>
+ <p>When the element has no parent, then the content model defaults to
+ <a href=#flow-content>flow content</a>.
<section>
@@ -878,7 +887,7 @@
</tr>
<tr>
<th>Content Model:</th>
- <td><ul><li>When <span title=concept-n-noscript>scripting is disabled</span>, in a <code><a href=#the-head-element>head</a></code> element: in any order, zero or more <code><a href=#the-link-element>link</a></code> elements, zero or more <code><a href=#the-style-element>style</a></code> elements, and zero or more <code><a href=#the-meta-element>meta</a></code> elements.</li><li>When <span title=concept-n-noscript>scripting is disabled</span>, not in a <code><a href=#the-head-element>head</a></code> element: <span>transparent</span>, but there must be no <code><a href=#the-noscript-element>noscript</a></code> element descendants.</li><li>Otherwise: text that conforms to the requirements given in the prose.</li></ul></td>
+ <td><ul><li>When <span title=concept-n-noscript>scripting is disabled</span>, in a <code><a href=#the-head-element>head</a></code> element: in any order, zero or more <code><a href=#the-link-element>link</a></code> elements, zero or more <code><a href=#the-style-element>style</a></code> elements, and zero or more <code><a href=#the-meta-element>meta</a></code> elements.</li><li>When <span title=concept-n-noscript>scripting is disabled</span>, not in a <code><a href=#the-head-element>head</a></code> element: <a href=#transparent-content-models>transparent</a>, but there must be no <code><a href=#the-noscript-element>noscript</a></code> element descendants.</li><li>Otherwise: text that conforms to the requirements given in the prose.</li></ul></td>
</tr>
</tbody></table>
@@ -942,7 +951,7 @@
<table class=kinds-of-content>
<tbody><tr>
<th>Categories:</th>
- <td><ul><li><span>Sectioning root</span>.</li></ul></td>
+ <td><ul><li><a href=#sectioning-root>Sectioning root</a>.</li></ul></td>
</tr>
<tr>
<th>Contained By:</th>
@@ -1444,7 +1453,7 @@
<table class=kinds-of-content>
<tbody><tr>
<th>Categories:</th>
- <td><ul><li><a href=#flow-content>Flow content</a>.</li><li><span>Sectioning root</span>.</li></ul></td>
+ <td><ul><li><a href=#flow-content>Flow content</a>.</li><li><a href=#sectioning-root>Sectioning root</a>.</li></ul></td>
</tr>
<tr>
<th>Contained By:</th>
@@ -1707,7 +1716,7 @@
</tr>
<tr>
<th>Content Model:</th>
- <td><ul><li><span>Transparent</span>, but there must be no <a href=#interactive-content>interactive content</a> descendant.</li></ul></td>
+ <td><ul><li><a href=#transparent-content-models>Transparent</a>, but there must be no <a href=#interactive-content>interactive content</a> descendant.</li></ul></td>
</tr>
</tbody></table>
@@ -2560,7 +2569,7 @@
</tr>
<tr>
<th>Content Model:</th>
- <td><ul><li><span>Transparent</span>.</li></ul></td>
+ <td><ul><li><a href=#transparent-content-models>Transparent</a>.</li></ul></td>
</tr>
</tbody></table>
@@ -2594,7 +2603,7 @@
</tr>
<tr>
<th>Content Model:</th>
- <td><ul><li><span>Transparent</span>.</li></ul></td>
+ <td><ul><li><a href=#transparent-content-models>Transparent</a>.</li></ul></td>
</tr>
</tbody></table>
@@ -2620,7 +2629,7 @@
<table class=kinds-of-content>
<tbody><tr>
<th>Categories:</th>
- <td><ul><li><a href=#flow-content>Flow content</a>.</li><li><span>Sectioning root</span>.</li></ul></td>
+ <td><ul><li><a href=#flow-content>Flow content</a>.</li><li><a href=#sectioning-root>Sectioning root</a>.</li></ul></td>
</tr>
<tr>
<th>Contained By:</th>
@@ -2802,7 +2811,7 @@
</tr>
<tr>
<th>Content Model:</th>
- <td><ul><li>Zero or more <code><a href=#the-param-element>param</a></code> elements, then, <span>transparent</span>.</li></ul></td>
+ <td><ul><li>Zero or more <code><a href=#the-param-element>param</a></code> elements, then, <a href=#transparent-content-models>transparent</a>.</li></ul></td>
</tr>
</tbody></table>
@@ -2894,7 +2903,7 @@
</tr>
<tr>
<th>Content Model:</th>
- <td><ul><li>If the element has a <code title=attr-media-src>src</code> attribute: <span>transparent</span>.</li><li>If the element does not have a <code title=attr-media-src>src</code> attribute: one or more <code><a href=#the-source-element>source</a></code> elements, then, <span>transparent</span>.</li></ul></td>
+ <td><ul><li>If the element has a <code title=attr-media-src>src</code> attribute: <a href=#transparent-content-models>transparent</a>.</li><li>If the element does not have a <code title=attr-media-src>src</code> attribute: one or more <code><a href=#the-source-element>source</a></code> elements, then, <a href=#transparent-content-models>transparent</a>.</li></ul></td>
</tr>
</tbody></table>
@@ -2936,7 +2945,7 @@
</tr>
<tr>
<th>Content Model:</th>
- <td><ul><li>If the element has a <code title=attr-media-src>src</code> attribute: <span>transparent</span>.</li><li>If the element does not have a <code title=attr-media-src>src</code> attribute: one or more <code><a href=#the-source-element>source</a></code> elements, then, <span>transparent</span>.</li></ul></td>
+ <td><ul><li>If the element has a <code title=attr-media-src>src</code> attribute: <a href=#transparent-content-models>transparent</a>.</li><li>If the element does not have a <code title=attr-media-src>src</code> attribute: one or more <code><a href=#the-source-element>source</a></code> elements, then, <a href=#transparent-content-models>transparent</a>.</li></ul></td>
</tr>
</tbody></table>
@@ -3016,7 +3025,7 @@
</tr>
<tr>
<th>Content Model:</th>
- <td><ul><li><span>Transparent</span>.</li></ul></td>
+ <td><ul><li><a href=#transparent-content-models>Transparent</a>.</li></ul></td>
</tr>
</tbody></table>
@@ -3485,7 +3494,7 @@
<table class=kinds-of-content>
<tbody><tr>
<th>Categories:</th>
- <td><ul><li><span>Sectioning root</span>.</li></ul></td>
+ <td><ul><li><a href=#sectioning-root>Sectioning root</a>.</li></ul></td>
</tr>
<tr>
<th>Contained By:</th>
@@ -4184,7 +4193,7 @@
<table class=kinds-of-content>
<tbody><tr>
<th>Categories:</th>
- <td><ul><li><a href=#flow-content>Flow content</a>.</li><li><a href=#interactive-content>Interactive content</a>.</li><li><span>Sectioning root</span>.</li></ul></td>
+ <td><ul><li><a href=#flow-content>Flow content</a>.</li><li><a href=#interactive-content>Interactive content</a>.</li><li><a href=#sectioning-root>Sectioning root</a>.</li></ul></td>
</tr>
<tr>
<th>Contained By:</th>
Index: Overview.src.html
===================================================================
RCS file: /sources/public/html5/html-author/Overview.src.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -d -r1.31 -r1.32
--- Overview.src.html 1 Feb 2009 22:54:11 -0000 1.31
+++ Overview.src.html 2 Feb 2009 02:48:49 -0000 1.32
@@ -18,7 +18,7 @@
.element .summary .kinds-of-content { margin: 0; padding: 0; width: 100%; border-spacing: .5em .2em; }
.element .summary th, .element .summary td { padding: .2em 0; text-align: left; vertical-align: top; }
.element .summary th { width: 20%; }
-
+ .element .summary table ul { margin: 0; padding: 0; }
.element .properties { display: table; width: 100%; border-collapse: collapse; }
.element .attributes, .element .dom { display: table-cell; width: 50%; }
.element .dom { border-left: 3px solid #9F9; }
@@ -296,11 +296,13 @@
<ul>
<li><span>Metadata content</span></li>
<li><span>Flow content</span></li>
+ <li><span>Sectioning root</span></li>
<li><span>Sectioning content</span></li>
<li><span>Heading content</span></li>
<li><span>Phrasing content</span></li>
<li><span>Embedded content</span></li>
<li><span>Interactive content</span></li>
+ <li><span>Transparent</span></li>
</ul>
<p>Some elements have unique requirements and do not fit into any particular
@@ -309,7 +311,7 @@
<p class="issue">[Create and link to some sort of index of elements that
lists each element in each category.]</p>
- <h4><dfn>Metadata Content</dfn></h4>
+ <h2><dfn>Metadata Content</dfn></h2>
<p>Metadata content includes elements for marking up document metadata;
marking up or linking to resources that describe the behaviour or
presentation of the document; or indicate relationships with other
@@ -320,7 +322,7 @@
<code>meta</code>, <code>link</code>, <code>script</code> and
<code>style</code>.</p>
- <h4><dfn>Flow content</dfn></h4>
+ <h2><dfn>Flow content</dfn></h2>
<p>Most elements that are used in the body of documents and applications are
categorised as flow content. Most of the elements used to mark up the
main content in the body of a page are considered to be flow content.
@@ -333,19 +335,28 @@
<p class="note">Elements categorised as heading content, phrasing content or
embedded content are also considered to be flow content.</p>
- <h4><dfn>Sectioning content</dfn></h4>
+ <h2><dfn>Sectioning root</dfn></h2>
+ <p class="issue">[This description needs improving.]</p>
+ <p>These elements can have their own outlines, but the sections and
+ headers inside these elements do not contribute to the outlines of
+ their ancestors.</p>
+
+ <p>Some common sectioning root elements include, among others,
+ <code>body</code>, <code>blockquote</code> and <code>figure</code>.</p>
+
+ <h2><dfn>Sectioning content</dfn></h2>
<p>Sectioning content is used for structuring a document into sections,
each of which generally has its own heading. These elements provide a
scope within which associated headers, footers and contact information
apply.</p>
- <p>Some common sectioning elements include, among others, <code>body</code>,
- <code>section</code> and <code>article</code>.</p>
+ <p>Some common sectioning elements include, among others,
+ <code>section</code>, <code>article</code> and <code>nav</code>.</p>
<p class="note">Most sectioning elements, with the exception of the body
element, are also classified as flow content.</p>
- <h4><dfn>Heading content</dfn></h4>
+ <h2><dfn>Heading content</dfn></h2>
<p>Heading content includes the elements for marking up headers. Headings,
in conjunction with the sectioning elements, are used to describe the the
@@ -357,7 +368,7 @@
<p class="note">Elements categorised as heading content are considered to be
flow content.</p>
- <h4><dfn>Phrasing content</dfn></h4>
+ <h2><dfn>Phrasing content</dfn></h2>
<p>Phrasing content includes text and text-level markup. This is similar to
the concept of inline level elements in HTML 4.01. Most elements that
are categorised as phrasing content can only contain other phrasing
@@ -369,7 +380,7 @@
<p class="note">Elements categorised as phrasing content are considered to
be flow content.</p>
- <h4><dfn>Embedded content</dfn></h4>
+ <h2><dfn>Embedded content</dfn></h2>
<p>Embedded content includes elements that load external resources into the
document. Such external resources include, for example, images, videos
and Flash-based content. Some embedded content elements include
@@ -379,7 +390,7 @@
<p class="note">Elements categorised as embedded content are considered to
be phrasing content, and thus also considered to be flow content.</p>
- <h4><dfn>Interactive content</dfn></h4>
+ <h2><dfn>Interactive content</dfn></h2>
<p>Interactive elements are those that allow the user to interact with or
activate in some way. Depending on the user's browser and device, this
could be performed using any kind of input device, such as, for example,
@@ -389,18 +400,15 @@
<code>a</code>, <code>video</code> when used with the
<code>controls</code> attribute, and most form controls using
<code>input</code>.</p>
-
-
- <h3>Sections</h3>
- <p><dfn>Sectioning elements</dfn> are elements that divide the page into,
- for lack of a better word, sections. This section describes HTML's
- sectioning elements and elements that support them.</p>
-
- <p>Some elements are scoped to their nearest ancestor sectioning element.
- For example, <code>address</code> elements apply just to their section.
- For such elements <var title="">x</var>, the elements that apply to a
- sectioning element <var title="">e</var> are all the <var title="">x</var>
- elements whose nearest sectioning
+
+ <h2><dfn>Transparent</dfn> Content Models</h2>
+
+ <p>Some elements have transparent content models, meaning that their
+ allowed content depends upon the parent element. They may contain
+ any content that their parent element may contain, in addition to
+ any other allowances or exceptions described for the element.</p>
+ <p>When the element has no parent, then the content model defaults to
+ <span>flow content</span>.
</section>
<section>
Received on Monday, 2 February 2009 02:49:02 UTC