Permalink
Browse files

[a] (0) Try to clarify <footer>.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7502

git-svn-id: http://svn.whatwg.org/webapps@3954 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent baa59bd commit ec57dfd07b178fdc05ab10fa848a30d973e8567c @Hixie Hixie committed Sep 22, 2009
Showing with 102 additions and 8 deletions.
  1. +51 −4 index
  2. +51 −4 source
View
@@ -13602,15 +13602,16 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
<dt>DOM interface:</dt>
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
</dl><p>The <code><a href=#the-footer-element>footer</a></code> element <a href=#represents>represents</a> a footer
- for its nearest ancestor <a href=#sectioning-content>sectioning content</a>. A footer
- typically contains information about its section such as who wrote
- it, links to related documents, copyright data, and the like.</p>
+ for its nearest ancestor <a href=#sectioning-content>sectioning content</a> or
+ <a href=#sectioning-root>sectioning root</a> element. A footer typically contains
+ information about its section such as who wrote it, links to related
+ documents, copyright data, and the like.</p>
<p class=note>Contact information belongs in an
<code><a href=#the-address-element>address</a></code> element, possibly itself inside a
<code><a href=#the-footer-element>footer</a></code>.</p>
- <p>Footers don't necessarily have to appear at the end of a section,
+ <p>Footers don't necessarily have to appear at the <em>end</em> of a section,
though they usually do.</p>
<p>When the <code><a href=#the-footer-element>footer</a></code> element contains entire sections,
@@ -13622,6 +13623,10 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
<a href=#sectioning-content>sectioning content</a>; it doesn't introduce a new
section.</p>
+ <p>When the nearest ancestor <a href=#sectioning-content>sectioning content</a> or
+ <a href=#sectioning-root>sectioning root</a> element is <a href=#the-body-element>the body
+ element</a>, then it applies to the whole page.</p>
+
<div class=example>
<p>Here is a page with two footers, one at the top and one at the
@@ -13645,6 +13650,48 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p&gt;
</div>
+ <div class=example>
+
+ <p>Here is an example which shows the <code><a href=#the-footer-element>footer</a></code> element
+ being used both for a site-wide footer and for a section
+ footer.</p>
+
+ <pre>&lt;!DOCTYPE HTML&gt;
+&lt;HTML&gt;&lt;HEAD&gt;
+&lt;TITLE&gt;The Ramblings of a Scientist&lt;/TITLE&gt;
+&lt;BODY&gt;
+&lt;H1&gt;The Ramblings of a Scientist&lt;/H1&gt;
+&lt;ARTICLE&gt;
+ &lt;H1&gt;Episode 15&lt;/H1&gt;
+ &lt;VIDEO SRC="/fm/015.ogv" CONTROLS AUTOBUFFER&gt;
+ &lt;P&gt;&lt;A HREF="/fm/015.ogv"&gt;Download video&lt;/A&gt;.&lt;/P&gt;
+ &lt;/VIDEO&gt;
+ &lt;FOOTER&gt; &lt;!-- footer for article --&gt;
+ &lt;P&gt;Published &lt;TIME PUBDATE DATETIME="2009-10-21T18:26-07:00"&gt;&lt;/TIME&gt;&lt;/P&gt;
+ &lt;/FOOTER&gt;
+&lt;/ARTICLE&gt;
+&lt;ARTICLE&gt;
+ &lt;H1&gt;My Favorite Trains&lt;/H1&gt;
+ &lt;P&gt;I love my trains. My favorite train of all time is a K&ouml;f.&lt;/P&gt;
+ &lt;P&gt;It is fun to see them pull some coal cars because they look so
+ dwarfed in comparison.&lt;/P&gt;
+ &lt;FOOTER&gt; &lt;!-- footer for article --&gt;
+ &lt;P&gt;Published &lt;TIME PUBDATE DATETIME="2009-09-15T14:54-07:00"&gt;&lt;/TIME&gt;&lt;/P&gt;
+ &lt;/FOOTER&gt;
+&lt;/ARTICLE&gt;
+&lt;FOOTER&gt; &lt;!-- site wide footer --&gt;
+ &lt;NAV&gt;
+ &lt;P&gt;&lt;A HREF="/credits.html"&gt;Credits&lt;/A&gt; &mdash;
+ &lt;A HREF="/tos.html"&gt;Terms of Service&lt;/A&gt; &mdash;
+ &lt;A HREF="/index.html"&gt;Blog Index&lt;/A&gt;&lt;/P&gt;
+ &lt;/NAV&gt;
+ &lt;P&gt;Copyright &copy; 2009 Gordon Freeman&lt;/P&gt;
+&lt;/FOOTER&gt;
+&lt;/BODY&gt;
+&lt;/HTML&gt;</pre>
+
+ </div>
+
<h4 id=the-address-element><span class=secno>4.4.10 </span>The <dfn><code>address</code></dfn> element</h4>
View
@@ -14438,15 +14438,16 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
</dl>
<p>The <code>footer</code> element <span>represents</span> a footer
- for its nearest ancestor <span>sectioning content</span>. A footer
- typically contains information about its section such as who wrote
- it, links to related documents, copyright data, and the like.</p>
+ for its nearest ancestor <span>sectioning content</span> or
+ <span>sectioning root</span> element. A footer typically contains
+ information about its section such as who wrote it, links to related
+ documents, copyright data, and the like.</p>
<p class="note">Contact information belongs in an
<code>address</code> element, possibly itself inside a
<code>footer</code>.</p>
- <p>Footers don't necessarily have to appear at the end of a section,
+ <p>Footers don't necessarily have to appear at the <em>end</em> of a section,
though they usually do.</p>
<p>When the <code>footer</code> element contains entire sections,
@@ -14458,6 +14459,10 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
<span>sectioning content</span>; it doesn't introduce a new
section.</p>
+ <p>When the nearest ancestor <span>sectioning content</span> or
+ <span>sectioning root</span> element is <span>the body
+ element</span>, then it applies to the whole page.</p>
+
<div class="example">
<p>Here is a page with two footers, one at the top and one at the
@@ -14481,6 +14486,48 @@ isn't his only passion. He also enjoys other pleasures.&lt;/p>
</div>
+ <div class="example">
+
+ <p>Here is an example which shows the <code>footer</code> element
+ being used both for a site-wide footer and for a section
+ footer.</p>
+
+ <pre>&lt;!DOCTYPE HTML>
+&lt;HTML>&lt;HEAD>
+&lt;TITLE>The Ramblings of a Scientist&lt;/TITLE>
+&lt;BODY>
+&lt;H1>The Ramblings of a Scientist&lt;/H1>
+&lt;ARTICLE>
+ &lt;H1>Episode 15&lt;/H1>
+ &lt;VIDEO SRC="/fm/015.ogv" CONTROLS AUTOBUFFER>
+ &lt;P>&lt;A HREF="/fm/015.ogv">Download video&lt;/A>.&lt;/P>
+ &lt;/VIDEO>
+ &lt;FOOTER> &lt;!-- footer for article -->
+ &lt;P>Published &lt;TIME PUBDATE DATETIME="2009-10-21T18:26-07:00">&lt;/TIME>&lt;/P>
+ &lt;/FOOTER>
+&lt;/ARTICLE>
+&lt;ARTICLE>
+ &lt;H1>My Favorite Trains&lt;/H1>
+ &lt;P>I love my trains. My favorite train of all time is a K&ouml;f.&lt;/P>
+ &lt;P>It is fun to see them pull some coal cars because they look so
+ dwarfed in comparison.&lt;/P>
+ &lt;FOOTER> &lt;!-- footer for article -->
+ &lt;P>Published &lt;TIME PUBDATE DATETIME="2009-09-15T14:54-07:00">&lt;/TIME>&lt;/P>
+ &lt;/FOOTER>
+&lt;/ARTICLE>
+&lt;FOOTER> &lt;!-- site wide footer -->
+ &lt;NAV>
+ &lt;P>&lt;A HREF="/credits.html">Credits&lt;/A> &mdash;
+ &lt;A HREF="/tos.html">Terms of Service&lt;/A> &mdash;
+ &lt;A HREF="/index.html">Blog Index&lt;/A>&lt;/P>
+ &lt;/NAV>
+ &lt;P>Copyright &copy; 2009 Gordon Freeman&lt;/P>
+&lt;/FOOTER>
+&lt;/BODY>
+&lt;/HTML></pre>
+
+ </div>
+
<h4>The <dfn><code>address</code></dfn> element</h4>

0 comments on commit ec57dfd

Please sign in to comment.