HTML Standard Tracker

Diff (omit for latest revision)
Filter

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

File a bug

SVNBugCommentTime (UTC)
3039[Authors] [Conformance Checkers] Rename <header> to <hgroup> and restrict it just to supporting subheadings.2009-04-30 17:37
Index: source
===================================================================
--- source	(revision 3038)
+++ source	(revision 3039)
@@ -7944,14 +7944,14 @@
  &lt;h2&gt;Leading the way in widget design since 1432&lt;/h2&gt;
  ...</pre>
 
-   <p>The <code>header</code> element should be used in these kinds of
+   <p>The <code>hgroup</code> element should be used in these kinds of
    situations:</p>
 
    <pre>&lt;body&gt;
- &lt;header&gt;
+ &lt;hgroup&gt;
   &lt;h1&gt;ABC Company&lt;/h1&gt;
   &lt;h2&gt;Leading the way in widget design since 1432&lt;/h2&gt;
- &lt;/header&gt;
+ &lt;/hgroup&gt;
  ...</pre>
 
   </div>
@@ -12961,10 +12961,10 @@
    Web page) about apples, containing two short sections.</p>
 
    <pre>&lt;article>
- &lt;header>
+ &lt;hgroup>
   &lt;h1>Apples&lt;/h1>
-  &lt;p>Tasty, delicious fruit!&lt;/p>
- &lt;/header>
+  &lt;h2>Tasty, delicious fruit!&lt;/h2>
+ &lt;/hgroup>
  &lt;p>The apple is the pomaceous fruit of the apple tree.&lt;/p>
  &lt;section>
   &lt;h1>Red Delicious&lt;/h1>
@@ -13018,12 +13018,12 @@
    navigation section.</p>
 
    <pre>&lt;body>
- &lt;header>
+ <!--&lt;header>-->
   &lt;h1>Wake up sheeple!&lt;/h1>
   &lt;p>&lt;a href="news.html">News&lt;/a> -
      &lt;a href="blog.html">Blog&lt;/a> -
      &lt;a href="forums.html">Forums&lt;/a>&lt;/p>
- &lt;/header>
+ <!--&lt;/header>-->
  &lt;nav>
   &lt;h1>Navigation&lt;/h1>
   &lt;ul>
@@ -13190,7 +13190,7 @@
   elements with the same name have equal rank.</p>
 
 
-  <h4>The <dfn><code>header</code></dfn> element</h4>
+  <h4>The <dfn><code>hgroup</code></dfn> element</h4>
 
   <dl class="element">
    <dt>Categories</dt>
@@ -13199,41 +13199,35 @@
    <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>Flow content</span>, including at least one descendant
-   that is <span>heading content</span>, but no <span>sectioning
-   content</span> descendants, no <code>header</code> element
-   descendants, and no <code>footer</code> element descendants.</dd>
+   <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>header</code> element <span>represents</span> the
-  header of a section. The element is typically used to group a set of
+  <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. However, <code>header</code>
-  elements may contain more than just the section's headings and
-  subheadings &mdash; for example it would be reasonable for the
-  header to include version history information.
+  title with its subtitle or tagline.</p>
 
   <p>For the purposes of document summaries, outlines, and the like,
-  the text of <code>header</code> elements is defined to be the text
+  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>header</code> element, if there are any such elements, and 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>header</code> element is the empty string.</p>
+  the <code>hgroup</code> element is the empty string.</p>
 
-  <p>Other heading elements in the <code>header</code> element
+  <p>Other heading elements in the <code>hgroup</code> element
   indicate subheadings or subtitles.</p>
 
-  <p>The <span>rank</span> of a <code>header</code> element is the
+  <p>The <span>rank</span> of a <code>hgroup</code> element is the
   same as for an <code>h1</code> element (the highest rank).</p>
 
   <p>The section on <span>headings and sections</span>
-  defines how <code>header</code> elements are assigned to individual
+  defines how <code>hgroup</code> elements are assigned to individual
   sections.</p>
 
   <div class="example">
@@ -13243,24 +13237,31 @@
    header in an application extracting header data and ignoring
    subheadings.</p>
 
-   <pre>&lt;header&gt;
+   <pre>&lt;hgroup&gt;
  &lt;h1&gt;<strong>The reality dysfunction</strong>&lt;/h1&gt;
  &lt;h2&gt;Space is not the only void&lt;/h2&gt;
-&lt;/header&gt;</pre>
+&lt;/hgroup&gt;</pre>
 
-   <pre>&lt;header&gt;
+   <pre>&lt;hgroup&gt;
  &lt;h1&gt;<strong>Dr. Strangelove</strong>&lt;/h1&gt;
  &lt;h2&gt;Or: How I Learned to Stop Worrying and Love the Bomb&lt;/h2&gt;
-&lt;/header&gt;</pre>
+&lt;/hgroup&gt;</pre>
 
+<!--
+  The <code>header</code> element may contain more than just the
+  section's headings and subheadings &mdash; for example it would be
+  reasonable for the header to include version history information.
+
    <pre>&lt;header&gt;
  &lt;p&gt;Welcome to...&lt;/p&gt;
  &lt;h1&gt;<strong>Voidwars!</strong>&lt;/h1&gt;
 &lt;/header&gt;</pre>
 
    <pre>&lt;header&gt;
- &lt;h1&gt;<strong>Scalable Vector Graphics (SVG) 1.2</strong>&lt;/h1&gt;
- &lt;h2&gt;W3C Working Draft 27 October 2004&lt;/h2&gt;
+ &lt;hgroup&gt;
+  &lt;h1&gt;<strong>Scalable Vector Graphics (SVG) 1.2</strong>&lt;/h1&gt;
+  &lt;h2&gt;W3C Working Draft 27 October 2004&lt;/h2&gt;
+ &lt;/hgroup&gt;
  &lt;dl&gt;
   &lt;dt&gt;This version:&lt;/dt&gt;
   &lt;dd&gt;&lt;a href="http://www.w3.org/TR/2004/WD-SVG12-20041027/"&gt;http://www.w3.org/TR/2004/WD-SVG12-20041027/&lt;/a&gt;&lt;/dd&gt;
@@ -13277,6 +13278,7 @@
  &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>
 
 
@@ -13317,10 +13319,10 @@
 
    <pre>&lt;body>
  &lt;footer>&lt;a href="../">Back to index...&lt;/a>&lt;/footer>
- &lt;header>
+ &lt;hgroup>
   &lt;h1>Lorem ipsum&lt;/h1>
   &lt;h2>The ipsum of all lorems&lt;/h2>
- &lt;/header>
+ &lt;/hgroup>
  &lt;p>A dolor sit amet, consectetur adipisicing elit, sed do eiusmod
  tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
  veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex
@@ -13409,7 +13411,7 @@
   <h4><dfn>Headings and sections</dfn></h4>
 
   <p>The <code>h1</code>&ndash;<code>h6</code> elements and the
-  <code>header</code> element are headings.</p>
+  <code>hgroup</code> element are headings.</p>
 
   <p>The first element of <span>heading content</span> in an element
   of <span>sectioning content</span> <span>represents</span> the
@@ -18766,6 +18768,7 @@
   cases, an equivalent textual label must be given in the <code
   title="attr-img-alt">alt</code> attribute.</p>
 
+<!--
   <div class="example">
 
    <p>Here, posts on a news site are labeled with an icon
@@ -18793,6 +18796,7 @@
 &lt;/body></pre>
 
   </div>
+-->
 
   <p>Many pages include logos, insignia, flags, or emblems, which
   stand for a particular entity such as a company, organization,
@@ -21414,6 +21418,8 @@
        - an event that reports playback difficulties?
        - an arbitrary quality metric?
     * bufferingRate/bufferingThrottled (see v3BUF)
+    * events for when the user agent's controls get shown or hidden
+      so that the author's controls can get away of the UA's
   -->
 
   <p><span title="media element">Media elements</span> are used to
@@ -64731,7 +64737,7 @@
   <code>div</code>, <code>dl</code>, <code>fieldset</code>,
   <code>footer</code>, <code>form</code>, <code>h1</code>,
   <code>h2</code>, <code>h3</code>, <code>h4</code>, <code>h5</code>,
-  <code>h6</code>, <code>header</code>, <code>hr</code>,
+  <code>h6</code>, <code>hgroup</code>, <code>hr</code>,
   <code>menu</code>, <code>nav</code>, <code>ol</code>,
   <code>p</code>, <code>pre</code>, <code>section</code>,
   <code>table</code>, or <code>ul</code>, element, or if there is no
@@ -65976,7 +65982,7 @@
    <code>footer</code>, <code>form</code>, <code>frame</code>,
    <code>frameset</code>, <code>h1</code>, <code>h2</code>,
    <code>h3</code>, <code>h4</code>, <code>h5</code>, <code>h6</code>,
-   <code>head</code>, <code>header</code>, <code>hr</code>,
+   <code>head</code>, <code>hgroup</code>, <code>hr</code>,
    <code>iframe</code>, <!-- <code>image</code>, (commented out
    because this isn't an element that can end up on the stack, so it
    doesn't matter) --> <code>img</code>, <code>input</code>,
@@ -68931,7 +68937,7 @@
    <!-- the normal ones -->
    <dt>A start tag whose tag name is one of: "address", "article",
    "aside", "blockquote", "center", "datagrid", "details", "dialog",
-   "dir", "div", "dl", "fieldset", "figure", "footer", "header",
+   "dir", "div", "dl", "fieldset", "figure", "footer", "hgroup",
    "menu", "nav", "ol", "p", "section", "ul"</dt>
    <dd>
 
@@ -69142,7 +69148,7 @@
    <!-- the normal ones -->
    <dt>An end tag whose tag name is one of: "address", "article",
    "aside", "blockquote", "center", "datagrid", "details", "dialog",
-   "dir", "div", "dl", "fieldset", "figure", "footer", "header",
+   "dir", "div", "dl", "fieldset", "figure", "footer", "hgroup",
    "listing", "menu", "nav", "ol", "pre", "section", "ul"</dt>
    <dd>
 

|