[html5] r3954 - [a] (0) Try to clarify <footer>. Fixing http://www.w3.org/Bugs/Public/show_bug.c [...]
whatwg at whatwg.org
whatwg at whatwg.org
Mon Sep 21 18:45:20 PDT 2009
Author: ianh
Date: 2009-09-21 18:45:19 -0700 (Mon, 21 Sep 2009)
New Revision: 3954
Modified:
index
source
Log:
[a] (0) Try to clarify <footer>.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7502
Modified: index
===================================================================
--- index 2009-09-22 01:26:16 UTC (rev 3953)
+++ index 2009-09-22 01:45:19 UTC (rev 3954)
@@ -13602,15 +13602,16 @@
<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 @@
<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,7 +13650,49 @@
</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><!DOCTYPE HTML>
+<HTML><HEAD>
+<TITLE>The Ramblings of a Scientist</TITLE>
+<BODY>
+<H1>The Ramblings of a Scientist</H1>
+<ARTICLE>
+ <H1>Episode 15</H1>
+ <VIDEO SRC="/fm/015.ogv" CONTROLS AUTOBUFFER>
+ <P><A HREF="/fm/015.ogv">Download video</A>.</P>
+ </VIDEO>
+ <FOOTER> <!-- footer for article -->
+ <P>Published <TIME PUBDATE DATETIME="2009-10-21T18:26-07:00"></TIME></P>
+ </FOOTER>
+</ARTICLE>
+<ARTICLE>
+ <H1>My Favorite Trains</H1>
+ <P>I love my trains. My favorite train of all time is a Köf.</P>
+ <P>It is fun to see them pull some coal cars because they look so
+ dwarfed in comparison.</P>
+ <FOOTER> <!-- footer for article -->
+ <P>Published <TIME PUBDATE DATETIME="2009-09-15T14:54-07:00"></TIME></P>
+ </FOOTER>
+</ARTICLE>
+<FOOTER> <!-- site wide footer -->
+ <NAV>
+ <P><A HREF="/credits.html">Credits</A> —
+ <A HREF="/tos.html">Terms of Service</A> —
+ <A HREF="/index.html">Blog Index</A></P>
+ </NAV>
+ <P>Copyright © 2009 Gordon Freeman</P>
+</FOOTER>
+</BODY>
+</HTML></pre>
+
+ </div>
+
+
<h4 id=the-address-element><span class=secno>4.4.10 </span>The <dfn><code>address</code></dfn> element</h4>
<dl class=element><dt>Categories</dt>
Modified: source
===================================================================
--- source 2009-09-22 01:26:16 UTC (rev 3953)
+++ source 2009-09-22 01:45:19 UTC (rev 3954)
@@ -14438,15 +14438,16 @@
</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 @@
<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,7 +14486,49 @@
</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><!DOCTYPE HTML>
+<HTML><HEAD>
+<TITLE>The Ramblings of a Scientist</TITLE>
+<BODY>
+<H1>The Ramblings of a Scientist</H1>
+<ARTICLE>
+ <H1>Episode 15</H1>
+ <VIDEO SRC="/fm/015.ogv" CONTROLS AUTOBUFFER>
+ <P><A HREF="/fm/015.ogv">Download video</A>.</P>
+ </VIDEO>
+ <FOOTER> <!-- footer for article -->
+ <P>Published <TIME PUBDATE DATETIME="2009-10-21T18:26-07:00"></TIME></P>
+ </FOOTER>
+</ARTICLE>
+<ARTICLE>
+ <H1>My Favorite Trains</H1>
+ <P>I love my trains. My favorite train of all time is a Köf.</P>
+ <P>It is fun to see them pull some coal cars because they look so
+ dwarfed in comparison.</P>
+ <FOOTER> <!-- footer for article -->
+ <P>Published <TIME PUBDATE DATETIME="2009-09-15T14:54-07:00"></TIME></P>
+ </FOOTER>
+</ARTICLE>
+<FOOTER> <!-- site wide footer -->
+ <NAV>
+ <P><A HREF="/credits.html">Credits</A> —
+ <A HREF="/tos.html">Terms of Service</A> —
+ <A HREF="/index.html">Blog Index</A></P>
+ </NAV>
+ <P>Copyright © 2009 Gordon Freeman</P>
+</FOOTER>
+</BODY>
+</HTML></pre>
+
+ </div>
+
+
<h4>The <dfn><code>address</code></dfn> element</h4>
<dl class="element">
More information about the Commit-Watchers
mailing list