spec/Overview.html 1.2034 2863 Give more details of how <caption> eleme

Give more details of how <caption> elements should be used. (whatwg
r2863)

4.9.3 The caption element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2034.html#the-caption-element
W3C Working Draft 12 February 2009
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2034.html#w3c-working-draft-12-february-year
A vocabulary and associated APIs for HTML and XHTML
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2034.html#a-vocabulary-and-associated-apis-for-html-and-xhtml
4.9.4 The colgroup element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2034.html#the-colgroup-element
Status of this document
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2034.html#status-of-this-document

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2033&r2=1.2034&f=h
http://html5.org/tools/web-apps-tracker?from=2862&to=2863

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2033
retrieving revision 1.2034
diff -u -d -r1.2033 -r1.2034
--- Overview.html 23 Feb 2009 22:04:47 -0000 1.2033
+++ Overview.html 24 Feb 2009 02:19:41 -0000 1.2034
@@ -10,7 +10,7 @@
    <p><a href=http://www.w3.org/><img alt=W3C height=48 src=http://www.w3.org/Icons/w3c_home width=72></a></p>
    <h1>HTML 5</h1>
    <h2 class="no-num no-toc" id=a-vocabulary-and-associated-apis-for-html-and-xhtml>A vocabulary and associated APIs for HTML and XHTML</h2>
-   <h2 class="no-num no-toc" id=w3c-working-draft-12-february-year><!--ZZZ:--> W3C Working Draft 12 February 2009<!-- fix date ZZZ --><!-- Editor's Draft 23 February 2009 --><!--:ZZZ--></h2>
+   <h2 class="no-num no-toc" id=w3c-working-draft-12-february-year><!--ZZZ:--> W3C Working Draft 12 February 2009<!-- fix date ZZZ --><!-- Editor's Draft 24 February 2009 --><!--:ZZZ--></h2>
    <dl><!-- ZZZ: update the month/day (twice), uncomment out --><dt>This Version:</dt>
     <dd><a href=http://www.w3.org/TR/2009/WD-html5-20090212/>http://www.w3.org/TR/2009/WD-html5-20090212/</a></dd>
 <!-- :ZZZ -->
@@ -100,7 +100,7 @@
   track.
   <!--ZZZ:-->
   This specification is the 12 February 2009 Working Draft.
-  <!-- This specification is the 23 February 2009 Editor's Draft. -->
+  <!-- This specification is the 24 February 2009 Editor's Draft. -->
   <!--:ZZZ-->
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href=http://www.whatwg.org/>WHATWG</a>. The two specifications are
   identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -18779,7 +18779,54 @@
   </dl><p>The <code><a href=#the-caption-element>caption</a></code> element <a href=#represents>represents</a> the title of the
   <code><a href=#the-table-element>table</a></code> that is its parent, if it has a parent and that
   is a <code><a href=#the-table-element>table</a></code> element.<p>The <code><a href=#the-caption-element>caption</a></code> element takes part in the <a href=#table-model>table
-  model</a>.<h4 id=the-colgroup-element><span class=secno>4.9.4 </span>The <dfn><code>colgroup</code></dfn> element</h4><dl class=element><dt>Categories</dt>
+  model</a>.<p>The <code><a href=#the-caption-element>caption</a></code> element should be included for any table
+  where the reader might have difficulty understanding the content or
+  where the table's structure would not be obvious to the user of a
+  screen reader. The element's contents should describe what the
+  purpose of the table is, along with any information that could be
+  useful for understanding and using the table.<p>When a <code><a href=#the-table-element>table</a></code> element is in a <code><a href=#the-figure-element>figure</a></code>
+  element alone but for the <code><a href=#the-figure-element>figure</a></code>'s <code><a href=#the-legend-element>legend</a></code>,
+  the <code><a href=#the-caption-element>caption</a></code> element should be omitted in favor of the
+  <code><a href=#the-legend-element>legend</a></code>.<div class=example>
+
+   <p>Consider, for instance, the following table:</p>
+
+   <table class=dice-example><tr><th>   <th> 1 <th> 2 <th> 3 <th> 4 <th> 5 <th> 6
+    <tr><th> 1 <td> 2 <td> 3 <td> 4 <td> 5 <td> 6 <td> 7
+    <tr><th> 2 <td> 3 <td> 4 <td> 5 <td> 6 <td> 7 <td> 8
+    <tr><th> 3 <td> 4 <td> 5 <td> 6 <td> 7 <td> 8 <td> 9
+    <tr><th> 4 <td> 5 <td> 6 <td> 7 <td> 8 <td> 9 <td> 10
+    <tr><th> 5 <td> 6 <td> 7 <td> 8 <td> 9 <td> 10 <td> 11
+    <tr><th> 6 <td> 7 <td> 8 <td> 9 <td> 10 <td> 11 <td> 12
+   </table><p>In the abstract, this table is not clear. However, with a
+   caption giving the table's number (for reference in the main prose)
+   and explaining its use, it makes more sense:</p>
+
+   <pre>&lt;caption&gt;
+&lt;strong&gt;Table 1.&lt;/strong&gt;
+This table shows the total score obtained from rolling two six-sided
+dice. The first row represents the value of the first die, the first
+column the value of the second die. The total is given in the cell
+that corresponds to the values of the two dice.
+&lt;/caption&gt;</pre>
+
+   <p>This provides the user with more context:</p>
+
+   <table class=dice-example><caption>
+     <strong>Table 1.</strong>
+     This table shows the total score obtained from rolling two six-sided
+     dice. The first row represents the value of the first die, the first
+     column the value of the second die. The total is given in the cell
+     that corresponds to the values of the two dice.
+    </caption>
+    <tr><th>   <th> 1 <th> 2 <th> 3 <th> 4 <th> 5 <th> 6
+    <tr><th> 1 <td> 2 <td> 3 <td> 4 <td> 5 <td> 6 <td> 7
+    <tr><th> 2 <td> 3 <td> 4 <td> 5 <td> 6 <td> 7 <td> 8
+    <tr><th> 3 <td> 4 <td> 5 <td> 6 <td> 7 <td> 8 <td> 9
+    <tr><th> 4 <td> 5 <td> 6 <td> 7 <td> 8 <td> 9 <td> 10
+    <tr><th> 5 <td> 6 <td> 7 <td> 8 <td> 9 <td> 10 <td> 11
+    <tr><th> 6 <td> 7 <td> 8 <td> 9 <td> 10 <td> 11 <td> 12
+   </table></div><h4 id=the-colgroup-element><span class=secno>4.9.4 </span>The <dfn><code>colgroup</code></dfn> element</h4><dl class=element><dt>Categories</dt>
    <dd>None.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>As a child of a <code><a href=#the-table-element>table</a></code> element, after any

Received on Tuesday, 24 February 2009 02:23:46 UTC