[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