HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/3041

File a bug

SVNBugCommentTime (UTC)
3041Clarify <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>&ndash;<code>h6</code> elements to mark up a page's
-  title with its subtitle or tagline.</p>
+  <code>h1</code>&ndash;<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>&ndash;<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>&ndash;<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>&lt;body>
+ &lt;header>
+  &lt;h1>Little Green Guys With Guns&lt;/h1>
+  &lt;nav>
+   &lt;ul>
+    &lt;li>&lt;a href="/games">Games&lt;/a> |
+    &lt;li>&lt;a href="/forum">Forum&lt;/a> |
+    &lt;li>&lt;a href="/download">Download&lt;/a>
+   &lt;/ul>
+  &lt;/nav>
+  &lt;h2>Important News&lt;/h2> &lt;!-- this starts a second subsection -->
+  &lt;!-- this is part of the subsection entitled "Important News" -->
+  &lt;p>To play today's games you will need to update your client.&lt;/p>
+  &lt;h2>Games&lt;/h2> &lt;!-- this starts a second subsection -->
+ &lt;/header>
+ &lt;p>You have three active games:&lt;/p>
+ &lt;!-- this is still part of the subsection entitled "Games" -->
+ ...</pre>
+
+  </div>
+
+
+
+
   <h4>The <dfn><code>footer</code></dfn> element</h4>
 
   <dl class="element">

|