HTML Standard Tracker

Diff (omit for latest revision)
Filter

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

File a bug

SVNBugCommentTime (UTC)
3040[Authors] [Conformance Checkers] Introduce a new <header> element.2009-04-30 18:07
Index: source
===================================================================
--- source	(revision 3039)
+++ source	(revision 3040)
@@ -13018,20 +13018,21 @@
    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;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;p>Last Modified: &lt;time>2009-04-01&lt;/time>&lt;/p>
+  &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;/header>
  &lt;article>
   &lt;p>...<em>page content would be here</em>...&lt;/p>
  &lt;/article>
@@ -13247,19 +13248,51 @@
  &lt;h2&gt;Or: How I Learned to Stop Worrying and Love the Bomb&lt;/h2&gt;
 &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.
+  </div>
 
+
+  <h4>The <dfn><code>header</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>
+   <dt>Content model:</dt>
+   <dd><span>Flow content</span>, but with no <code>header</code>
+   element descendants.</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> a header
+  for the section it <a href="#applyToSection">applies</a> to. A
+  header typically contains a heading
+  (<code>h1</code>&ndash;<code>h6</code> or <code>hgroup</code>), a
+  table of contents, a search form, relevant logos, and other
+  introductory or navigational aids.</p>
+
+  <p>Contact information for the section to which the
+  <code>header</code> element <a href="#applyToSection">applies</a>
+  should be marked up using the <code>address</code> element.</p>
+
+  <div class="example">
+
+  <p>Here are some sample headers. This first one is for a game:</p>
+
    <pre>&lt;header&gt;
  &lt;p&gt;Welcome to...&lt;/p&gt;
- &lt;h1&gt;<strong>Voidwars!</strong>&lt;/h1&gt;
+ &lt;h1&gt;Voidwars!&lt;/h1&gt;
 &lt;/header&gt;</pre>
 
+   <p>The following snippet shows how the element can be used to mark
+   up a specification's heading:</p>
+
    <pre>&lt;header&gt;
  &lt;hgroup&gt;
-  &lt;h1&gt;<strong>Scalable Vector Graphics (SVG) 1.2</strong>&lt;/h1&gt;
+  &lt;h1&gt;Scalable Vector Graphics (SVG) 1.2&lt;/h1&gt;
   &lt;h2&gt;W3C Working Draft 27 October 2004&lt;/h2&gt;
  &lt;/hgroup&gt;
  &lt;dl&gt;
@@ -13278,10 +13311,12 @@
  &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">
@@ -13305,13 +13340,19 @@
   wrote it, links to related documents, copyright data, and the
   like.</p>
 
-  <p>Contact information for the section given in a
-  <code>footer</code> should be marked up using the
-  <code>address</code> element.</p>
+  <p>Contact information for the section to which the
+  <code>footer</code> element <a href="#applyToSection">applies</a>
+  should be marked up using the <code>address</code> element.</p>
 
   <p>Footers don't necessarily have to appear at the end of a section,
   though they usually do.</p>
 
+  <p>The <code>footer</code> element is inappropriate for containing
+  entire sections. For appendices, indexes, long colophons, verbose
+  license agreements, and other such content which needs sectioning
+  with headers and so forth, regular <code>section</code> elements
+  should be used, not a <code>footer</code>.</p>
+
   <div class="example">
 
    <p>Here is a page with two footers, one at the top and one at the
@@ -18768,7 +18809,6 @@
   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
@@ -18796,7 +18836,6 @@
 &lt;/body></pre>
 
   </div>
--->
 
   <p>Many pages include logos, insignia, flags, or emblems, which
   stand for a particular entity such as a company, organization,
@@ -64737,12 +64776,12 @@
   <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>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>
+  <code>h6</code>, <code>header</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
@@ -65982,20 +66021,20 @@
    <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>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>,
-   <code>textarea</code>, <code>tfoot</code>, <code>thead</code>,
-   <code>title</code>, <code>tr</code>, <code>ul</code>, and
-   <code>wbr</code>.</p></dd>
+   <code>head</code>, <code>header</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>, <code>textarea</code>, <code>tfoot</code>,
+   <code>thead</code>, <code>title</code>, <code>tr</code>,
+   <code>ul</code>, and <code>wbr</code>.</p></dd>
 
    <dt><dfn>Scoping</dfn></dt>
    <dd><p>The following HTML elements introduce new <span title="has
@@ -68937,8 +68976,8 @@
    <!-- 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", "hgroup",
-   "menu", "nav", "ol", "p", "section", "ul"</dt>
+   "dir", "div", "dl", "fieldset", "figure", "footer", "header",
+   "hgroup", "menu", "nav", "ol", "p", "section", "ul"</dt>
    <dd>
 
     <!-- As of May 2008 this doesn't match any browser exactly, but is
@@ -69148,8 +69187,9 @@
    <!-- 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", "hgroup",
-   "listing", "menu", "nav", "ol", "pre", "section", "ul"</dt>
+   "dir", "div", "dl", "fieldset", "figure", "footer", "header",
+   "hgroup", "listing", "menu", "nav", "ol", "pre", "section",
+   "ul"</dt>
    <dd>
 
     <p>If the <span>stack of open elements</span> does not <span

|