Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[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
Hixie committed Sep 22, 2009
1 parent baa59bd commit ec57dfd
Show file tree
Hide file tree
Showing 2 changed files with 102 additions and 8 deletions.
55 changes: 51 additions & 4 deletions index
Expand Up @@ -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,
Expand All @@ -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
Expand All @@ -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>

Expand Down
55 changes: 51 additions & 4 deletions source
Expand Up @@ -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,
Expand All @@ -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
Expand All @@ -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>

Expand Down

0 comments on commit ec57dfd

Please sign in to comment.