[html5] r3041 - [e] (0) Clarify <header>/<hgroup> etc.
whatwg at whatwg.org
whatwg at whatwg.org
Thu Apr 30 11:39:51 PDT 2009
Author: ianh
Date: 2009-04-30 11:39:50 -0700 (Thu, 30 Apr 2009)
New Revision: 3041
Modified:
index
source
Log:
[e] (0) Clarify <header>/<hgroup> etc.
Modified: index
===================================================================
--- index 2009-04-30 18:07:19 UTC (rev 3040)
+++ index 2009-04-30 18:39:50 UTC (rev 3041)
@@ -12335,7 +12335,8 @@
<dd><a href=#global-attributes>Global attributes</a></dd>
<dt>DOM interface:</dt>
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
- </dl><p>These elements define headers for their sections.</p>
+ </dl><p>These elements <a href=#represents title=represents>represent</a> headers
+ for their sections.</p>
<p>The semantics and meaning of these elements are defined in the
section on <a href=#headings-and-sections>headings and sections</a>.</p>
@@ -12361,8 +12362,9 @@
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
</dl><p>The <code><a href=#the-hgroup-element>hgroup</a></code> element <a href=#represents>represents</a> the
header of a section. The element is used to group a set of
- <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>–<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> elements to mark up a page's
- title with its subtitle or tagline.</p>
+ <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>–<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> elements when the header has
+ multiple levels, such as subheadings, alternative titles, or
+ taglines.</p>
<p>For the purposes of document summaries, outlines, and the like,
the text of <code><a href=#the-hgroup-element>hgroup</a></code> elements is defined to be the text
@@ -12416,12 +12418,13 @@
<dd><a href=#global-attributes>Global attributes</a></dd>
<dt>DOM interface:</dt>
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
- </dl><p>The <code><a href=#the-header-element>header</a></code> element <a href=#represents>represents</a> a header
- for the section it <a href=#applyToSection>applies</a> to. A
- header typically contains a heading
- (<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>–<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> or <code><a href=#the-hgroup-element>hgroup</a></code>), a
- table of contents, a search form, relevant logos, and other
- introductory or navigational aids.</p>
+ </dl><p>The <code><a href=#the-header-element>header</a></code> element <a href=#represents>represents</a> a group
+ of introductory or navigational aids for the section it <a href=#applyToSection>applies</a> to. A <code><a href=#the-header-element>header</a></code> element
+ typically contains the section's header (an
+ <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>–<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> element or an
+ <code><a href=#the-hgroup-element>hgroup</a></code> element), but can also contain other content,
+ such as a table of contents, a search form, or any relevant
+ logos.</p>
<p>Contact information for the section to which the
<code><a href=#the-header-element>header</a></code> element <a href=#applyToSection>applies</a>
@@ -12463,9 +12466,44 @@
</div>
+ <p class=note>The <code><a href=#the-header-element>header</a></code> element is not
+ <a href=#sectioning-content-0>sectioning content</a>; it doesn't introduce a new
+ section.</p>
+ <div class=example>
+ <p>In this example, the page has a page heading given by the
+ <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code> element, and two subsections whose headings are
+ given by <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h2</a></code> elements. The content after the
+ <code><a href=#the-header-element>header</a></code> element is still part of the last subsection
+ started in the <code><a href=#the-header-element>header</a></code> element, because the
+ <code><a href=#the-header-element>header</a></code> element doesn't take part in the
+ <a href=#outline>outline</a> algorithm.</p>
+ <pre><body>
+ <header>
+ <h1>Little Green Guys With Guns</h1>
+ <nav>
+ <ul>
+ <li><a href="/games">Games</a> |
+ <li><a href="/forum">Forum</a> |
+ <li><a href="/download">Download</a>
+ </ul>
+ </nav>
+ <h2>Important News</h2> <!-- this starts a second subsection -->
+ <!-- this is part of the subsection entitled "Important News" -->
+ <p>To play today's games you will need to update your client.</p>
+ <h2>Games</h2> <!-- this starts a second subsection -->
+ </header>
+ <p>You have three active games:</p>
+ <!-- this is still part of the subsection entitled "Games" -->
+ ...</pre>
+
+ </div>
+
+
+
+
<h4 id=the-footer-element><span class=secno>4.4.9 </span>The <dfn><code>footer</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
Modified: source
===================================================================
--- source 2009-04-30 18:07:19 UTC (rev 3040)
+++ source 2009-04-30 18:39:50 UTC (rev 3041)
@@ -13180,7 +13180,8 @@
<dd>Uses <code>HTMLElement</code>.</dd>
</dl>
- <p>These elements define headers for their sections.</p>
+ <p>These elements <span title="represents">represent</span> headers
+ for their sections.</p>
<p>The semantics and meaning of these elements are defined in the
section on <span>headings and sections</span>.</p>
@@ -13209,8 +13210,9 @@
<p>The <code>hgroup</code> element <span>represents</span> the
header of a section. The element is used to group a set of
- <code>h1</code>–<code>h6</code> elements to mark up a page's
- title with its subtitle or tagline.</p>
+ <code>h1</code>–<code>h6</code> elements when the header has
+ multiple levels, such as subheadings, alternative titles, or
+ taglines.</p>
<p>For the purposes of document summaries, outlines, and the like,
the text of <code>hgroup</code> elements is defined to be the text
@@ -13267,12 +13269,14 @@
<dd>Uses <code>HTMLElement</code>.</dd>
</dl>
- <p>The <code>header</code> element <span>represents</span> a header
- for the section it <a href="#applyToSection">applies</a> to. A
- header typically contains a heading
- (<code>h1</code>–<code>h6</code> or <code>hgroup</code>), a
- table of contents, a search form, relevant logos, and other
- introductory or navigational aids.</p>
+ <p>The <code>header</code> element <span>represents</span> a group
+ of introductory or navigational aids for the section it <a
+ href="#applyToSection">applies</a> to. A <code>header</code> element
+ typically contains the section's header (an
+ <code>h1</code>–<code>h6</code> element or an
+ <code>hgroup</code> element), but can also contain other content,
+ such as a table of contents, a search form, or any relevant
+ logos.</p>
<p>Contact information for the section to which the
<code>header</code> element <a href="#applyToSection">applies</a>
@@ -13314,9 +13318,44 @@
</div>
+ <p class="note">The <code>header</code> element is not
+ <span>sectioning content</span>; it doesn't introduce a new
+ section.</p>
+ <div class="example">
+ <p>In this example, the page has a page heading given by the
+ <code>h1</code> element, and two subsections whose headings are
+ given by <code>h2</code> elements. The content after the
+ <code>header</code> element is still part of the last subsection
+ started in the <code>header</code> element, because the
+ <code>header</code> element doesn't take part in the
+ <span>outline</span> algorithm.</p>
+ <pre><body>
+ <header>
+ <h1>Little Green Guys With Guns</h1>
+ <nav>
+ <ul>
+ <li><a href="/games">Games</a> |
+ <li><a href="/forum">Forum</a> |
+ <li><a href="/download">Download</a>
+ </ul>
+ </nav>
+ <h2>Important News</h2> <!-- this starts a second subsection -->
+ <!-- this is part of the subsection entitled "Important News" -->
+ <p>To play today's games you will need to update your client.</p>
+ <h2>Games</h2> <!-- this starts a second subsection -->
+ </header>
+ <p>You have three active games:</p>
+ <!-- this is still part of the subsection entitled "Games" -->
+ ...</pre>
+
+ </div>
+
+
+
+
<h4>The <dfn><code>footer</code></dfn> element</h4>
<dl class="element">
More information about the Commit-Watchers
mailing list