Short URL: http://html5.org/r/3041
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 3041 | Clarify <header>/<hgroup> etc. | 2009-04-30 18:39 |
Index: source
===================================================================
--- source (revision 3040)
+++ source (revision 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">