HTML Standard Tracker

Filter

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
@@ -7937,28 +7937,28 @@ interface <dfn>HTMLDocument</dfn> {
    of a corporate site, is similarly non-conforming because the second
    line is not intended to be a heading of a subsection, but merely a
    subheading or subtitle (a subordinate heading for the same
    section).</p>
 
    <pre class="bad">&lt;body&gt;
  &lt;h1&gt;ABC Company&lt;/h1&gt;
  &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>
 
   <p>Through scripting and using other mechanisms, the values of
   attributes, text, and indeed the entire structure of the document
   may change dynamically while a user agent is processing it. The
   semantics of a document at an instant in time are those represented
   by the state of the document at that instant in time, and the
   semantics of a document can therefore change over time. User agents
@@ -12954,24 +12954,24 @@ not-slash     = %x0000-002E / %x0030-%10FFFF
   various tabbed pages in a tabbed dialog box, or the numbered
   sections of a thesis. A Web site's home page could be split into
   sections for an introduction, news items, contact information.</p>
 
   <div class="example">
 
    <p>In the following example, we see an article (part of a larger
    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>
   &lt;p>These bright red apples are the most common found in many
   supermarkets.&lt;/p>
  &lt;/section>
  &lt;section>
   &lt;h1>Granny Smith&lt;/h1>
   &lt;p>These juicy, green apples and make a great filling for
   apple pies.&lt;/p>
@@ -13011,26 +13011,26 @@ not-slash     = %x0000-002E / %x0030-%10FFFF
   have a list of links to various key parts of a site, but the
   <code>footer</code> element is more appropriate in such cases.</p>
 
   <div class="example">
 
    <p>In the following example, the page has several places where
    links are present, but only one of those places is considered a
    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>
    &lt;li>&lt;a href="articles.html">Index of all articles&lt;/a>&lt;/li>
    &lt;li>&lt;a href="today.html">Things sheeple need to wake up for today&lt;/a>&lt;/li>
    &lt;li>&lt;a href="successes.html">Sheeple we have managed to wake&lt;/a>&lt;/li>
   &lt;/ul>
  &lt;/nav>
  &lt;article>
   &lt;p>...<em>page content would be here</em>...&lt;/p>
@@ -13183,107 +13183,109 @@ isn't his only passion. He also enjoys other pleasures.&lt;/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>
 
 
-  <h4>The <dfn><code>header</code></dfn> element</h4>
+  <h4>The <dfn><code>hgroup</code></dfn> element</h4>
 
   <dl class="element">
    <dt>Categories</dt>
    <dd><span>Flow content</span>.</dd>
    <dd><span>Heading content</span>.</dd>
    <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">
 
    <p>Here are some examples of valid headers. In each case, the
    emphasized text represents the text that would be used as the
    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;
   &lt;dt&gt;Previous version:&lt;/dt&gt;
   &lt;dd&gt;&lt;a href="http://www.w3.org/TR/2004/WD-SVG12-20040510/"&gt;http://www.w3.org/TR/2004/WD-SVG12-20040510/&lt;/a&gt;&lt;/dd&gt;
   &lt;dt&gt;Latest version of SVG 1.2:&lt;/dt&gt;
   &lt;dd&gt;&lt;a href="http://www.w3.org/TR/SVG12/"&gt;http://www.w3.org/TR/SVG12/&lt;/a&gt;&lt;/dd&gt;
   &lt;dt&gt;Latest SVG Recommendation:&lt;/dt&gt;
   &lt;dd&gt;&lt;a href="http://www.w3.org/TR/SVG/"&gt;http://www.w3.org/TR/SVG/&lt;/a&gt;&lt;/dd&gt;
   &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>
 
 
   <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>
@@ -13310,24 +13312,24 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
   <p>Footers don't necessarily have to appear at the end of a section,
   though they usually do.</p>
 
   <div class="example">
 
    <p>Here is a page with two footers, one at the top and one at the
    bottom, with the same content:</p>
 
    <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
  ea commodo consequat. Duis aute irure dolor in reprehenderit in
  voluptate velit esse cillum dolore eu fugiat nulla
  pariatur. Excepteur sint occaecat cupidatat non proident, sunt in
  culpa qui officia deserunt mollit anim id est laborum.&lt;/p>
  &lt;footer>&lt;a href="../">Back to index...&lt;/a>&lt;/footer>
 &lt;/body></pre>
 
@@ -13402,21 +13404,21 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
   <p class="note">Contact information for one <span>sectioning
   content</span> element, e.g.  an <code>aside</code> element, does
   not apply to its ancestor elements, e.g. the page's
   <code>body</code>.</p>
 
 
 
   <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
   header for that section. Subsequent headers of equal or higher
   <span>rank</span> start new (implied) sections, headers of lower
   <span>rank</span> start implied subsections that are part of the
   previous one. In both cases, the element <span>represents</span> the
   header of the implied section.</p>
 
   <p><span>Sectioning content</span> elements are always considered
@@ -18759,20 +18761,21 @@ document.write(), passes data to the Tokenizer."></strong>&lt;/p></pre>
  Configuration Tools&lt;/a>&lt;/p>
 &lt;/nav></pre>
 
   </div>
 
   <p>In other cases, the icon has no text next to it describing what
   it means; the icon is supposed to be self-explanatory. In those
   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
    indicating their topic.</p>
 
    <pre>&lt;body>
  &lt;article>
   &lt;header>
    &lt;h1>Ratatouille wins &lt;i>Best Movie of the Year&lt;/i> award&lt;/h1>
    &lt;p><strong>&lt;img src="movies.png" alt="Movies"></strong>&lt;/p>
@@ -18786,20 +18789,21 @@ document.write(), passes data to the Tokenizer."></strong>&lt;/p></pre>
    &lt;p><strong>&lt;img src="podcasts.png" alt="Podcasts"></strong>&lt;/p>
   &lt;/header>
   &lt;p>The latest TWiT episode has been posted, in which we hear
   several tech news stories as well as learning much more about the
   iPhone. This week, the panelists compare how reflective their
   iPhones' Apple logos are.&lt;/p>
  &lt;/article>
 &lt;/body></pre>
 
   </div>
+-->
 
   <p>Many pages include logos, insignia, flags, or emblems, which
   stand for a particular entity such as a company, organization,
   project, band, software package, country, or some such.</p>
 
   <p>If the logo is being used to represent the entity, e.g. as a page
   header, the <code title="attr-img-alt">alt</code> attribute must
   contain the name of the entity being represented by the logo. The
   <code title="attr-img-alt">alt</code> attribute must <em>not</em>
   contain text like the word "logo", as it is not the fact that it is
@@ -21407,20 +21411,22 @@ interface <dfn>CueRangeCallback</dfn> {
       (e.g. for chained Ogg streams of multiple independent videos)
     * balance and 3D position audio
     * audio filters
     * audio synthesis
     * feedback to the script on how well the video is playing
        - frames per second?
        - skipped frames per second?
        - 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
   present audio data, or video and audio data, to the user. This is
   referred to as <dfn>media data</dfn> in this section, since this
   section applies equally to <span title="media element">media
   elements</span> for audio or for video. The term <dfn>media
   resource</dfn> is used to refer to the complete set of media data,
   e.g. the complete video file, or complete audio file.</p>
 
@@ -64724,21 +64730,21 @@ interface <dfn>MessagePort</dfn> {
 
   <!-- </p> -->
   <p>A <code>p</code> element's <span title="syntax-end-tag">end
   tag</span> may be omitted if the <code>p</code> element is
   immediately followed by an <code>address</code>,
   <code>article</code>, <code>aside</code>, <code>blockquote</code>,
   <code>datagrid</code>, <code>dialog</code>, <code>dir</code>,
   <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
   more content in the parent element and the parent element is not an
   <code>a</code> element.</p>
 
   <!-- </rt> -->
   <p>An <code>rt</code> element's <span title="syntax-end-tag">end
   tag</span> may be omitted if the <code>rt</code> element is
   immediately followed by an <code>rt</code> or <code>rp</code>
@@ -65969,21 +65975,21 @@ interface <dfn>MessagePort</dfn> {
    <code>basefont</code>, <code>bgsound</code>,
    <code>blockquote</code>, <code>body</code>, <code>br</code>,
    <code>center</code>, <code>col</code>, <code>colgroup</code>,
    <code>command</code>, <code>datagrid</code>, <code>dd</code>,
    <code>details</code>, <code>dialog</code>, <code>dir</code>,
    <code>div</code>, <code>dl</code>, <code>dt</code>,
    <code>embed</code>, <code>fieldset</code>, <code>figure</code>,
    <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>,
    <code>isindex</code>, <code>li</code>, <code>link</code>,
    <code>listing</code>, <code>menu</code>, <code>meta</code>,
    <code>nav</code>, <code>noembed</code>, <code>noframes</code>,
    <code>noscript</code>, <code>ol</code>, <code>p</code>,
    <code>param</code>, <code>plaintext</code>, <code>pre</code>,
    <code>script</code>, <code>section</code>, <code>select</code>,
    <code>spacer</code>, <code>style</code>, <code>tbody</code>,
@@ -68924,21 +68930,21 @@ document.body.appendChild(text);
     <p class="note">The fake end tag token here can only be
     ignored in the <span>fragment case</span>.</p>
 
    </dd>
 
    <!-- start tags for non-phrasing flow content elements -->
 
    <!-- 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>
 
     <!-- As of May 2008 this doesn't match any browser exactly, but is
     as close to what IE does as I can get without doing the non-tree
     DOM nonsense, and thus should actually afford better compatibility
     when implemented by the other browsers. -->
 
     <p>If the <span>stack of open elements</span> <span title="has
     an element in scope">has a <code>p</code> element in
@@ -69135,21 +69141,21 @@ document.body.appendChild(text);
     there is no way to switch the <span>content model flag</span>
     out of the PLAINTEXT state.</p>
 
    </dd>
 
    <!-- end tags for non-phrasing flow content elements -->
 
    <!-- 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>
 
     <p>If the <span>stack of open elements</span> does not <span
     title="has an element in scope">have an element in scope</span>
     with the same tag name as that of the token, then this is a
     <span>parse error</span>; ignore the token.</p>
 
     <p>Otherwise, run these steps:</p>
 

|