HTML Standard Tracker

Filter

File a bug

SVNBugCommentTime (UTC)
3041Clarify <header>/<hgroup> etc.2009-04-30 18:39
@@ -13173,21 +13173,22 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>flow content</span> is expected.</dd>
    <dt>Content model:</dt>
    <dd><span>Phrasing content</span>.</dd>
    <dt>Content attributes:</dt>
    <dd><span>Global attributes</span></dd>
    <dt>DOM interface:</dt>
    <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>
 
   <p>These elements have a <dfn>rank</dfn> given by the number in
   their name. The <code>h1</code> element is said to have the highest
   rank, the <code>h6</code> element has the lowest rank, and two
   elements with the same name have equal rank.</p>
 
 
@@ -13202,22 +13203,23 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
    <dt>Content model:</dt>
    <dd>One or more <code>h1</code>, <code>h2</code>, <code>h3</code>, <code>h4</code>, <code>h5</code>, and/or <code>h6</code> elements.</dd>
    <dt>Content attributes:</dt>
    <dd><span>Global attributes</span></dd>
    <dt>DOM interface:</dt>
    <dd>Uses <code>HTMLElement</code>.</dd>
   </dl>
 
   <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
   of the highest <span title="rank">ranked</span>
   <code>h1</code>&ndash;<code>h6</code> element descendant of the
   <code>hgroup</code> element, if there are any such elements, and the
   first such element if there are multiple elements with that
   <span>rank</span>. If there are no such elements, then the text of
   the <code>hgroup</code> element is the empty string.</p>
 
@@ -13260,26 +13262,28 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
    <dd>Where <span>flow content</span> is expected.</dd>
    <dt>Content model:</dt>
    <dd><span>Flow content</span>, but with no <code>header</code>
    element descendants.</dd>
    <dt>Content attributes:</dt>
    <dd><span>Global attributes</span></dd>
    <dt>DOM interface:</dt>
    <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>
   should be marked up using the <code>address</code> element.</p>
 
   <div class="example">
 
   <p>Here are some sample headers. This first one is for a game:</p>
 
    <pre>&lt;header&gt;
@@ -13307,20 +13311,55 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
   &lt;dt&gt;Editor:&lt;/dt&gt;
   &lt;dd&gt;Dean Jackson, W3C, &lt;a href="mailto:dean@w3.org"&gt;dean@w3.org&lt;/a&gt;&lt;/dd&gt;
   &lt;dt&gt;Authors:&lt;/dt&gt;
   &lt;dd&gt;See &lt;a href="#authors"&gt;Author List&lt;/a&gt;&lt;/dd&gt;
  &lt;/dl&gt;
  &lt;p class="copyright"&gt;&lt;a href="http://www.w3.org/Consortium/Legal/ipr-notic <em>...</em>
 &lt;/header&gt;</pre>
 
   </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">
    <dt>Categories</dt>
    <dd><span>Flow content</span>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>flow content</span> is expected.</dd>

|