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

Clarify <header>/<hgroup> etc. (whatwg r3041)

From: poot <cvsmail@w3.org>
Date: Fri, 1 May 2009 03:41:34 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20090430184134.D36222BCA1@toro.w3.mag.keio.ac.jp>
Clarify <header>/<hgroup> etc. (whatwg r3041)

4.4.9 The footer element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2201.html#the-footer-element
4.4.8 The header element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2201.html#the-header-element
rank
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2201.html#rank
4.4.6 The h1, h2, h3, h4, h5, and h6 elements
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2201.html#the-h1-h2-h3-h4-h5-and-h6-elements
4.4.7 The hgroup element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2201.html#the-hgroup-element

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2200&r2=1.2201&f=h
http://html5.org/tools/web-apps-tracker?from=3040&to=3041

===================================================================
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:42:12 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:14:04 GMT