Skip to content

Commit

Permalink
[act] (1) Introduce the concept of 'sectioning root', of which we hav…
Browse files Browse the repository at this point in the history 
…e four: <blockquote>, <td>, <datagrid>, <figure>; stop <blockquote> from being a sectioning element

git-svn-id: http://svn.whatwg.org/webapps@1255 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Feb 27, 2008
1 parent 517f38d commit 80305f8
Show file tree
Hide file tree
Showing 2 changed files with 181 additions and 185 deletions.
221 changes: 110 additions & 111 deletions index
View file
Expand Up @@ -24,7 +24,7 @@

<h1 id=html-5>HTML 5</h1>

<h2 class="no-num no-toc" id=working>Working Draft &mdash; 26 February
<h2 class="no-num no-toc" id=working>Working Draft &mdash; 27 February
2008</h2>

<p>You can take part in this work. <a
Expand Down Expand Up @@ -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>
Expand All @@ -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
Expand Down Expand Up @@ -8409,74 +8409,7 @@ XXX attributes to give the date authored, date published
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>
Expand Down Expand Up @@ -8547,7 +8480,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
...</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>
Expand Down Expand Up @@ -8587,7 +8520,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
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>
Expand Down Expand Up @@ -8680,7 +8613,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
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>
Expand Down Expand Up @@ -8740,7 +8673,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
&lt;/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>
Expand Down Expand Up @@ -8824,7 +8757,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
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>
Expand All @@ -8837,15 +8770,17 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
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>
Expand All @@ -8868,28 +8803,21 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>

<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
Expand Down Expand Up @@ -8941,7 +8869,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
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
Expand Down Expand Up @@ -9077,7 +9005,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
}</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
Expand Down Expand Up @@ -9305,7 +9233,7 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
</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
Expand Down Expand Up @@ -9606,6 +9534,73 @@ Address: &lt;input name="address"&gt;&lt;/p&gt;</pre>
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
Expand Down Expand Up @@ -12644,6 +12639,8 @@ brighter. A &lt;b>rat&lt;/b> scurries past the corner wall.&lt;/p></pre>

<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.
Expand Down Expand Up @@ -19919,7 +19916,7 @@ notes on what would need to be defined for dashed lines:
<dl class=element>
<dt>Categories

<dd>None.
<dd><a href="#sectioning1">Sectioning root</a>.

<dt>Contexts in which this element may be used:

Expand Down Expand Up @@ -21617,6 +21614,8 @@ https://www.google.com/base/settings

<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.
Expand Down

0 comments on commit 80305f8

Please sign in to comment.