W3C home > Mailing lists > Public > public-html-commits@w3.org > April 2009

html5/spec Overview.html,1.2200,1.2201

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 30 Apr 2009 18:39:58 +0000
To: public-html-commits@w3.org
Message-Id: <E1LzbAs-000053-RM@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv32763

Modified Files:
	Overview.html 
Log Message:
Clarify <header>/<hgroup> etc. (whatwg r3041)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2200
retrieving revision 1.2201
diff -u -d -r1.2200 -r1.2201
--- Overview.html	30 Apr 2009 18:07:24 -0000	1.2200
+++ Overview.html	30 Apr 2009 18:39:55 -0000	1.2201
@@ -10924,7 +10924,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>The semantics and meaning of these elements are defined in the
+  </dl><p>These elements <a href="#represents" title="represents">represent</a> headers
+  for their sections.<p>The semantics and meaning of these elements are defined in the
   section on <a href="#headings-and-sections">headings and sections</a>.<p>These elements have a <dfn id="rank">rank</dfn> given by the number in
   their name. The <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code> element is said to have the highest
   rank, the <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> element has the lowest rank, and two
@@ -10941,8 +10942,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>&ndash;<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>For the purposes of document summaries, outlines, and the like,
+  <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>&ndash;<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>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
   of the highest <a href="#rank" title="rank">ranked</a>
   <code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>&ndash;<code><a href="#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> element descendant of the
@@ -10981,12 +10983,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>&ndash;<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>Contact information for the section to which the
+  </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>&ndash;<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>Contact information for the section to which the
   <code><a href="#the-header-element">header</a></code> element <a href="#applyToSection">applies</a>
   should be marked up using the <code><a href="#the-address-element">address</a></code> element.<div class="example">
 
@@ -11022,6 +11025,37 @@
  &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><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.<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>&lt;body&gt;
+ &lt;header&gt;
+  &lt;h1&gt;Little Green Guys With Guns&lt;/h1&gt;
+  &lt;nav&gt;
+   &lt;ul&gt;
+    &lt;li&gt;&lt;a href="/games"&gt;Games&lt;/a&gt; |
+    &lt;li&gt;&lt;a href="/forum"&gt;Forum&lt;/a&gt; |
+    &lt;li&gt;&lt;a href="/download"&gt;Download&lt;/a&gt;
+   &lt;/ul&gt;
+  &lt;/nav&gt;
+  &lt;h2&gt;Important News&lt;/h2&gt; &lt;!-- this starts a second subsection --&gt;
+  &lt;!-- this is part of the subsection entitled "Important News" --&gt;
+  &lt;p&gt;To play today's games you will need to update your client.&lt;/p&gt;
+  &lt;h2&gt;Games&lt;/h2&gt; &lt;!-- this starts a second subsection --&gt;
+ &lt;/header&gt;
+ &lt;p&gt;You have three active games:&lt;/p&gt;
+ &lt;!-- this is still part of the subsection entitled "Games" --&gt;
+ ...</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>
    <dd><a href="#flow-content-0">Flow content</a>.</dd>
    <dt>Contexts in which this element may be used:</dt>
Received on Thursday, 30 April 2009 18:40:08 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 30 April 2009 18:40:15 GMT