[html5] r1255 - /
whatwg at whatwg.org
whatwg at whatwg.org
Tue Feb 26 16:24:15 PST 2008
Author: ianh
Date: 2008-02-26 16:24:14 -0800 (Tue, 26 Feb 2008)
New Revision: 1255
Modified:
index
source
Log:
[act] (1) Introduce the concept of 'sectioning root', of which we have four: <blockquote>, <td>, <datagrid>, <figure>; stop <blockquote> from being a sectioning element
Modified: index
===================================================================
--- index 2008-02-26 20:42:59 UTC (rev 1254)
+++ index 2008-02-27 00:24:14 UTC (rev 1255)
@@ -24,7 +24,7 @@
<h1 id=html-5>HTML 5</h1>
- <h2 class="no-num no-toc" id=working>Working Draft — 26 February
+ <h2 class="no-num no-toc" id=working>Working Draft — 27 February
2008</h2>
<p>You can take part in this work. <a
@@ -440,36 +440,33 @@
<li><a href="#the-article"><span class=secno>3.8.4 </span>The
<code>article</code> element</a>
- <li><a href="#the-blockquote"><span class=secno>3.8.5 </span>The
- <code>blockquote</code> element</a>
-
- <li><a href="#the-aside"><span class=secno>3.8.6 </span>The
+ <li><a href="#the-aside"><span class=secno>3.8.5 </span>The
<code>aside</code> element</a>
- <li><a href="#the-h1"><span class=secno>3.8.7 </span>The
+ <li><a href="#the-h1"><span class=secno>3.8.6 </span>The
<code>h1</code>, <code>h2</code>, <code>h3</code>, <code>h4</code>,
<code>h5</code>, and <code>h6</code> elements</a>
- <li><a href="#the-header"><span class=secno>3.8.8 </span>The
+ <li><a href="#the-header"><span class=secno>3.8.7 </span>The
<code>header</code> element</a>
- <li><a href="#the-footer"><span class=secno>3.8.9 </span>The
+ <li><a href="#the-footer"><span class=secno>3.8.8 </span>The
<code>footer</code> element</a>
- <li><a href="#the-address"><span class=secno>3.8.10 </span>The
+ <li><a href="#the-address"><span class=secno>3.8.9 </span>The
<code>address</code> element</a>
- <li><a href="#headings"><span class=secno>3.8.11 </span>Headings and
+ <li><a href="#headings"><span class=secno>3.8.10 </span>Headings and
sections</a>
<ul class=toc>
- <li><a href="#outlines"><span class=secno>3.8.11.1. </span>Creating
+ <li><a href="#outlines"><span class=secno>3.8.10.1. </span>Creating
an outline</a>
- <li><a href="#associatedSection"><span class=secno>3.8.11.2.
+ <li><a href="#associatedSection"><span class=secno>3.8.10.2.
</span>Determining which heading and section applies to a
particular node</a>
- <li><a href="#distinguishing"><span class=secno>3.8.11.3.
+ <li><a href="#distinguishing"><span class=secno>3.8.10.3.
</span>Distinguishing site-wide headers from page headers</a>
</ul>
</ul>
@@ -487,6 +484,9 @@
<li><a href="#the-dialog"><span class=secno>3.9.4 </span>The
<code>dialog</code> element</a>
+
+ <li><a href="#the-blockquote"><span class=secno>3.9.5 </span>The
+ <code>blockquote</code> element</a>
</ul>
<li><a href="#preformatted"><span class=secno>3.10 </span>Preformatted
@@ -8409,74 +8409,7 @@
href="#address">address</a></code> element) does not apply to nested
<code><a href="#article">article</a></code> elements.
- <h4 id=the-blockquote><span class=secno>3.8.5 </span>The <dfn
- id=blockquote><code>blockquote</code></dfn> element</h4>
-
- <dl class=element>
- <dt>Categories
-
- <dd><a href="#prose1">Prose content</a>.
-
- <dd><a href="#sectioning0">Sectioning content</a>.
-
- <dt>Contexts in which this element may be used:
-
- <dd>Where <a href="#prose1">prose content</a> is expected.
-
- <dt>Content model:
-
- <dd><a href="#prose1">Prose content</a>.
-
- <dt>Element-specific attributes:
-
- <dd><code title=attr-blockquote-cite><a href="#cite">cite</a></code>
-
- <dt>DOM interface:
-
- <dd>
- <pre
- class=idl>interface <dfn id=htmlquoteelement>HTMLQuoteElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
- attribute DOMString <a href="#cite0" title=dom-quote-cite>cite</a>;
-};</pre>
-
- <p class=note>The <code><a
- href="#htmlquoteelement">HTMLQuoteElement</a></code> interface is also
- used by the <code><a href="#q">q</a></code> element.</p>
- </dl>
-
- <p>The <code><a href="#blockquote">blockquote</a></code> element represents
- a section that is quoted from another source.
-
- <p>Content inside a <code><a href="#blockquote">blockquote</a></code> must
- be quoted from another source, whose URI, if it has one, should be cited
- in the <dfn id=cite title=attr-blockquote-cite><code>cite</code></dfn>
- attribute.
-
- <p>If the <code title=attr-blockquote-cite><a href="#cite">cite</a></code>
- attribute is present, it must be a URI (or IRI). User agents should allow
- users to follow such citation links.
-
- <p>If a <code><a href="#blockquote">blockquote</a></code> element is <a
- href="#preceded">preceded or followed</a> by a single <a
- href="#paragraph">paragraph</a> that contains a single <code><a
- href="#cite2">cite</a></code> element and that is itself not <a
- href="#preceded">preceded or followed</a> by another <code><a
- href="#blockquote">blockquote</a></code> element and does not itself have
- a <code><a href="#q">q</a></code> element descendant, then, the title of
- the work given by that <code><a href="#cite2">cite</a></code> element
- gives the source of the quotation contained in the <code><a
- href="#blockquote">blockquote</a></code> element.
-
- <p>The <dfn id=cite0 title=dom-quote-cite><code>cite</code></dfn> DOM
- attribute <code>reflects</code> the element's <code title="">cite</code>
- content attribte.
-
- <p class=note>The best way to represent a conversation is not with the
- <code><a href="#cite2">cite</a></code> and <code><a
- href="#blockquote">blockquote</a></code> elements, but with the <code><a
- href="#dialog">dialog</a></code> element.
-
- <h4 id=the-aside><span class=secno>3.8.6 </span>The <dfn
+ <h4 id=the-aside><span class=secno>3.8.5 </span>The <dfn
id=aside><code>aside</code></dfn> element</h4>
<dl class=element>
@@ -8547,7 +8480,7 @@
...</pre>
</div>
- <h4 id=the-h1><span class=secno>3.8.7 </span>The <dfn
+ <h4 id=the-h1><span class=secno>3.8.6 </span>The <dfn
id=h1><code>h1</code></dfn>, <dfn id=h2><code>h2</code></dfn>, <dfn
id=h3><code>h3</code></dfn>, <dfn id=h4><code>h4</code></dfn>, <dfn
id=h5><code>h5</code></dfn>, and <dfn id=h6><code>h6</code></dfn> elements</h4>
@@ -8587,7 +8520,7 @@
the highest rank, the <code><a href="#h6">h6</a></code> element has the
lowest rank, and two elements with the same name have equal rank.
- <h4 id=the-header><span class=secno>3.8.8 </span>The <dfn
+ <h4 id=the-header><span class=secno>3.8.7 </span>The <dfn
id=header><code>header</code></dfn> element</h4>
<dl class=element>
@@ -8680,7 +8613,7 @@
href="#header">header</a></code> element is the same as for an <code><a
href="#h1">h1</a></code> element (the highest rank).
- <h4 id=the-footer><span class=secno>3.8.9 </span>The <dfn
+ <h4 id=the-footer><span class=secno>3.8.8 </span>The <dfn
id=footer><code>footer</code></dfn> element</h4>
<dl class=element>
@@ -8740,7 +8673,7 @@
</body></pre>
</div>
- <h4 id=the-address><span class=secno>3.8.10 </span>The <dfn
+ <h4 id=the-address><span class=secno>3.8.9 </span>The <dfn
id=address><code>address</code></dfn> element</h4>
<dl class=element>
@@ -8824,7 +8757,7 @@
element, does not apply to its ancestor elements, e.g. the page's <code><a
href="#body0">body</a></code>.
- <h4 id=headings><span class=secno>3.8.11 </span><dfn id=headings0>Headings
+ <h4 id=headings><span class=secno>3.8.10 </span><dfn id=headings0>Headings
and sections</dfn></h4>
<p>The <code><a href="#h1">h1</a></code>-<code><a href="#h6">h6</a></code>
@@ -8837,16 +8770,18 @@
href="#rank">rank</a> start new (implied) sections, headers of lower <a
href="#rank">rank</a> start subsections that are part of the previous one.
- <p><a href="#sectioning0">Sectioning content</a> elements other than
- <code><a href="#blockquote">blockquote</a></code> are always considered
- subsections of their nearest ancestor element of <a
+ <p><a href="#sectioning0">Sectioning content</a> elements are always
+ considered subsections of their nearest ancestor element of <a
href="#sectioning0">sectioning content</a>, regardless of what implied
- sections other headings may have created. However, <code><a
- href="#blockquote">blockquote</a></code> elements <em>are</em> associated
- with implied sections. Effectively, <code><a
- href="#blockquote">blockquote</a></code> elements act like sections on the
- inside, and act opaquely on the outside.
+ sections other headings may have created.
+ <p>Certain elements are said to be <dfn id=sectioning1 title="sectioning
+ root">sectioning roots</dfn>, including <code><a
+ href="#blockquote">blockquote</a></code> and <code><a
+ href="#td">td</a></code> elements. These elements can have their own
+ outlines, but the sections and headers inside these elements do not
+ contribute to the outlines of their ancestors.
+
<div class=example>
<p>For the following fragment:</p>
@@ -8868,28 +8803,21 @@
<ol>
<li> Foo (heading of explicit <code><a href="#body0">body</a></code>
- section)
+ section, containing the "Grunt" paragraph)
<ol>
- <li> Bar (heading starting implied section)
- <ol>
- <li> Bla (heading of explicit <code><a
- href="#blockquote">blockquote</a></code> section)
- </ol>
- Baz (paragraph)
+ <li> Bar (heading starting implied section, containing a block quote
+ and the "Baz" paragraph)
<li> Quux (heading starting implied section)
<li> Thud (heading of explicit <code><a
href="#section">section</a></code> section)
</ol>
- Grunt (paragraph)
</ol>
- <p>Notice how the <code><a href="#blockquote">blockquote</a></code> nests
- inside an implicit section while the <code><a
- href="#section">section</a></code> does not (and in fact, ends the
- earlier implicit section so that a later paragraph is back at the top
- level).</p>
+ <p>Notice how the <code><a href="#section">section</a></code> ends the
+ earlier implicit section so that a later paragraph ("Grunt") is back at
+ the top level.</p>
</div>
<p>Sections may contain headers of any <a href="#rank">rank</a>, but
@@ -8941,7 +8869,7 @@
produce the same outline in compliant user agents.</p>
</div>
- <h5 id=outlines><span class=secno>3.8.11.1. </span>Creating an outline</h5>
+ <h5 id=outlines><span class=secno>3.8.10.1. </span>Creating an outline</h5>
<p class=big-issue>This section will be rewritten at some point. The
algorithm likely won't change, but its description will be dramatically
@@ -9077,7 +9005,7 @@
}</pre>
</div>
- <h5 id=associatedSection><span class=secno>3.8.11.2. </span>Determining
+ <h5 id=associatedSection><span class=secno>3.8.10.2. </span>Determining
which heading and section applies to a particular node</h5>
<p class=big-issue>This section will be rewritten at some point. The
@@ -9305,7 +9233,7 @@
</table>
</div>
- <h5 id=distinguishing><span class=secno>3.8.11.3. </span>Distinguishing
+ <h5 id=distinguishing><span class=secno>3.8.10.3. </span>Distinguishing
site-wide headers from page headers</h5>
<p>Given the <a href="#outlines">hypothetical section tree</a>, but
@@ -9606,6 +9534,73 @@
and <code><a href="#blockquote">blockquote</a></code> elements for other
ways to cite or quote.
+ <h4 id=the-blockquote><span class=secno>3.9.5 </span>The <dfn
+ id=blockquote><code>blockquote</code></dfn> element</h4>
+
+ <dl class=element>
+ <dt>Categories
+
+ <dd><a href="#prose1">Prose content</a>.
+
+ <dd><a href="#sectioning1">Sectioning root</a>.
+
+ <dt>Contexts in which this element may be used:
+
+ <dd>Where <a href="#prose1">prose content</a> is expected.
+
+ <dt>Content model:
+
+ <dd><a href="#prose1">Prose content</a>.
+
+ <dt>Element-specific attributes:
+
+ <dd><code title=attr-blockquote-cite><a href="#cite">cite</a></code>
+
+ <dt>DOM interface:
+
+ <dd>
+ <pre
+ class=idl>interface <dfn id=htmlquoteelement>HTMLQuoteElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+ attribute DOMString <a href="#cite0" title=dom-quote-cite>cite</a>;
+};</pre>
+
+ <p class=note>The <code><a
+ href="#htmlquoteelement">HTMLQuoteElement</a></code> interface is also
+ used by the <code><a href="#q">q</a></code> element.</p>
+ </dl>
+
+ <p>The <code><a href="#blockquote">blockquote</a></code> element represents
+ a section that is quoted from another source.
+
+ <p>Content inside a <code><a href="#blockquote">blockquote</a></code> must
+ be quoted from another source, whose URI, if it has one, should be cited
+ in the <dfn id=cite title=attr-blockquote-cite><code>cite</code></dfn>
+ attribute.
+
+ <p>If the <code title=attr-blockquote-cite><a href="#cite">cite</a></code>
+ attribute is present, it must be a URI (or IRI). User agents should allow
+ users to follow such citation links.
+
+ <p>If a <code><a href="#blockquote">blockquote</a></code> element is <a
+ href="#preceded">preceded or followed</a> by a single <a
+ href="#paragraph">paragraph</a> that contains a single <code><a
+ href="#cite2">cite</a></code> element and that is itself not <a
+ href="#preceded">preceded or followed</a> by another <code><a
+ href="#blockquote">blockquote</a></code> element and does not itself have
+ a <code><a href="#q">q</a></code> element descendant, then, the title of
+ the work given by that <code><a href="#cite2">cite</a></code> element
+ gives the source of the quotation contained in the <code><a
+ href="#blockquote">blockquote</a></code> element.
+
+ <p>The <dfn id=cite0 title=dom-quote-cite><code>cite</code></dfn> DOM
+ attribute <code>reflects</code> the element's <code title="">cite</code>
+ content attribte.
+
+ <p class=note>The best way to represent a conversation is not with the
+ <code><a href="#cite2">cite</a></code> and <code><a
+ href="#blockquote">blockquote</a></code> elements, but with the <code><a
+ href="#dialog">dialog</a></code> element.
+
<h3 id=preformatted><span class=secno>3.10 </span>Preformatted text</h3>
<h4 id=the-pre><span class=secno>3.10.1 </span>The <dfn
@@ -12644,6 +12639,8 @@
<dd><a href="#prose1">Prose content</a>.
+ <dd><a href="#sectioning1">Sectioning root</a>.
+
<dt>Contexts in which this element may be used:
<dd>Where <a href="#prose1">prose content</a> is expected.
@@ -19919,7 +19916,7 @@
<dl class=element>
<dt>Categories
- <dd>None.
+ <dd><a href="#sectioning1">Sectioning root</a>.
<dt>Contexts in which this element may be used:
@@ -21617,6 +21614,8 @@
<dd><span>Interactive element</span>.
+ <dd><a href="#sectioning1">Sectioning root</a>.
+
<dt>Contexts in which this element may be used:
<dd>Where <a href="#prose1">prose content</a> is expected.
Modified: source
===================================================================
--- source 2008-02-26 20:42:59 UTC (rev 1254)
+++ source 2008-02-27 00:24:14 UTC (rev 1255)
@@ -6787,58 +6787,7 @@
nested <code>article</code> elements.</p>
- <h4>The <dfn><code>blockquote</code></dfn> element</h4>
- <dl class="element">
- <dt>Categories</dt>
- <dd><span>Prose content</span>.</dd>
- <dd><span>Sectioning content</span>.</dd>
- <dt>Contexts in which this element may be used:</dt>
- <dd>Where <span>prose content</span> is expected.</dd>
- <dt>Content model:</dt>
- <dd><span>Prose content</span>.</dd>
- <dt>Element-specific attributes:</dt>
- <dd><code title="attr-blockquote-cite">cite</code></dd>
- <dt>DOM interface:</dt>
- <dd>
-<pre class="idl">interface <dfn>HTMLQuoteElement</dfn> : <span>HTMLElement</span> {
- attribute DOMString <span title="dom-quote-cite">cite</span>;
-};</pre>
- <p class="note">The <code>HTMLQuoteElement</code> interface is
- also used by the <code>q</code> element.</p>
- </dd>
- </dl>
-
- <p>The <code>blockquote</code> element represents a section that is
- quoted from another source.</p>
-
- <p>Content inside a <code>blockquote</code> must be quoted from
- another source, whose URI, if it has one, should be cited in the
- <dfn title="attr-blockquote-cite"><code>cite</code></dfn>
- attribute.</p>
-
- <p>If the <code title="attr-blockquote-cite">cite</code> attribute
- is present, it must be a URI (or IRI). User agents should allow
- users to follow such citation links.</p>
-
- <p>If a <code>blockquote</code> element is <span>preceded or
- followed</span> by a single <span>paragraph</span> that contains a
- single <code>cite</code> element and that is itself not
- <span>preceded or followed</span> by another <code>blockquote</code>
- element and does not itself have a <code>q</code> element
- descendant, then, the title of the work given by that
- <code>cite</code> element gives the source of the quotation
- contained in the <code>blockquote</code> element.</p>
-
- <p>The <dfn title="dom-quote-cite"><code>cite</code></dfn> DOM
- attribute <code>reflects</code> the element's <code
- title="">cite</code> content attribte.
-
- <p class="note">The best way to represent a conversation is not with
- the <code>cite</code> and <code>blockquote</code> elements, but with
- the <code>dialog</code> element.</p>
-
-
<h4>The <dfn><code>aside</code></dfn> element</h4>
<dl class="element">
@@ -7144,17 +7093,18 @@
start new (implied) sections, headers of lower <span>rank</span>
start subsections that are part of the previous one.</p>
- <p><span>Sectioning content</span> elements other than
- <code>blockquote</code> are always considered subsections of their
- nearest ancestor element of <span>sectioning content</span>,
- regardless of what implied sections other headings may have created.
- However, <code>blockquote</code> elements <em>are</em> associated
- with implied sections. Effectively, <code>blockquote</code> elements
- act like sections on the inside, and act opaquely on the
- outside.</p>
+ <p><span>Sectioning content</span> elements are always considered
+ subsections of their nearest ancestor element of <span>sectioning
+ content</span>, regardless of what implied sections other headings
+ may have created.</p>
- <div class="example">
+ <p>Certain elements are said to be <dfn title="sectioning
+ root">sectioning roots</dfn>, including <code>blockquote</code> and
+ <code>td</code> elements. 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>
+ <div class="example">
<p>For the following fragment:</p>
<pre><body>
<h1>Foo</h1>
@@ -7172,16 +7122,10 @@
<p>...the structure would be:</p>
<ol>
<li>
- Foo (heading of explicit <code>body</code> section)
+ Foo (heading of explicit <code>body</code> section, containing the "Grunt" paragraph)
<ol>
<li>
- Bar (heading starting implied section)
- <ol>
- <li>
- Bla (heading of explicit <code>blockquote</code> section)
- </li>
- </ol>
- Baz (paragraph)
+ Bar (heading starting implied section, containing a block quote and the "Baz" paragraph)
</li>
<li>
Quux (heading starting implied section)
@@ -7190,13 +7134,11 @@
Thud (heading of explicit <code>section</code> section)
</li>
</ol>
- Grunt (paragraph)
</li>
</ol>
- <p>Notice how the <code>blockquote</code> nests inside an implicit
- section while the <code>section</code> does not (and in fact, ends
- the earlier implicit section so that a later paragraph is back at
- the top level).</p>
+ <p>Notice how the <code>section</code> ends the earlier implicit
+ section so that a later paragraph ("Grunt") is back at the top
+ level.</p>
</div>
<p>Sections may contain headers of any <span>rank</span>, but
@@ -7829,6 +7771,59 @@
to cite or quote.</p>
+ <h4>The <dfn><code>blockquote</code></dfn> element</h4>
+
+ <dl class="element">
+ <dt>Categories</dt>
+ <dd><span>Prose content</span>.</dd>
+ <dd><span>Sectioning root</span>.</dd>
+ <dt>Contexts in which this element may be used:</dt>
+ <dd>Where <span>prose content</span> is expected.</dd>
+ <dt>Content model:</dt>
+ <dd><span>Prose content</span>.</dd>
+ <dt>Element-specific attributes:</dt>
+ <dd><code title="attr-blockquote-cite">cite</code></dd>
+ <dt>DOM interface:</dt>
+ <dd>
+<pre class="idl">interface <dfn>HTMLQuoteElement</dfn> : <span>HTMLElement</span> {
+ attribute DOMString <span title="dom-quote-cite">cite</span>;
+};</pre>
+ <p class="note">The <code>HTMLQuoteElement</code> interface is
+ also used by the <code>q</code> element.</p>
+ </dd>
+ </dl>
+
+ <p>The <code>blockquote</code> element represents a section that is
+ quoted from another source.</p>
+
+ <p>Content inside a <code>blockquote</code> must be quoted from
+ another source, whose URI, if it has one, should be cited in the
+ <dfn title="attr-blockquote-cite"><code>cite</code></dfn>
+ attribute.</p>
+
+ <p>If the <code title="attr-blockquote-cite">cite</code> attribute
+ is present, it must be a URI (or IRI). User agents should allow
+ users to follow such citation links.</p>
+
+ <p>If a <code>blockquote</code> element is <span>preceded or
+ followed</span> by a single <span>paragraph</span> that contains a
+ single <code>cite</code> element and that is itself not
+ <span>preceded or followed</span> by another <code>blockquote</code>
+ element and does not itself have a <code>q</code> element
+ descendant, then, the title of the work given by that
+ <code>cite</code> element gives the source of the quotation
+ contained in the <code>blockquote</code> element.</p>
+
+ <p>The <dfn title="dom-quote-cite"><code>cite</code></dfn> DOM
+ attribute <code>reflects</code> the element's <code
+ title="">cite</code> content attribte.
+
+ <p class="note">The best way to represent a conversation is not with
+ the <code>cite</code> and <code>blockquote</code> elements, but with
+ the <code>dialog</code> element.</p>
+
+
+
<h3>Preformatted text</h3>
<h4>The <dfn><code>pre</code></dfn> element</h4>
@@ -10566,6 +10561,7 @@
<dl class="element">
<dt>Categories</dt>
<dd><span>Prose content</span>.</dd>
+ <dd><span>Sectioning root</span>.</dd>
<dt>Contexts in which this element may be used:</dt>
<dd>Where <span>prose content</span> is expected.</dd>
<dt>Content model:</dt>
@@ -17401,7 +17397,7 @@
<dl class="element">
<dt>Categories</dt>
- <dd>None.</dd>
+ <dd><span>Sectioning root</span>.</dd>
<dt>Contexts in which this element may be used:</dt>
<dd>As a child of a <code>tr</code> element.</dd>
<dt>Content model:</dt>
@@ -19301,6 +19297,7 @@
<dt>Categories</dt>
<dd><span>Prose element</span>.</dd>
<dd><span>Interactive element</span>.</dd>
+ <dd><span>Sectioning root</span>.</dd>
<dt>Contexts in which this element may be used:</dt>
<dd>Where <span>prose content</span> is expected.</dd>
<dt>Content model:</dt>
More information about the Commit-Watchers
mailing list