HTML Standard Tracker

Diff (omit for latest revision)
Filter

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

File a bug

SVNBugCommentTime (UTC)
59788449apply wg decision2011-04-08 21:35
Index: source
===================================================================
--- source	(revision 5977)
+++ source	(revision 5978)
@@ -41132,191 +41132,15 @@
 
   </div>
 
-  <p>There are a variety of ways to include this information, such as:</p>
+  <p><a href="#table-descriptions-techniques">Guidance on how to
+  provide such information</a> is provided below.</p>
 
-  <dl>
-
-   <dt>In prose, surrounding the table</dt>
-
-   <dd>
-    <div class="example"><pre>&lt;p>In the following table, characteristics are given in the second
-column, with the negative side in the left column and the positive
-side in the right column.&lt;/p>
-&lt;table>
- &lt;caption>Characteristics with positive and negative sides&lt;/caption>
- &lt;thead>
-  &lt;tr>
-   &lt;th id="n"> Negative
-   &lt;th> Characteristic
-   &lt;th> Positive
- &lt;tbody>
-  &lt;tr>
-   &lt;td headers="n r1"> Sad
-   &lt;th id="r1"> Mood
-   &lt;td> Happy
-  &lt;tr>
-   &lt;td headers="n r2"> Failing
-   &lt;th id="r2"> Grade
-   &lt;td> Passing
-&lt;/table></pre></div>
-   </dd>
-
-   <dt>In the table's <code>caption</code></dt>
-
-   <dd>
-    <div class="example"><pre>&lt;table>
- &lt;caption>
-  &lt;strong>Characteristics with positive and negative sides.&lt;/strong>
-  &lt;p>Characteristics are given in the second column, with the
-  negative side in the left column and the positive side in the right
-  column.&lt;/p>
- &lt;/caption>
- &lt;thead>
-  &lt;tr>
-   &lt;th id="n"> Negative
-   &lt;th> Characteristic
-   &lt;th> Positive
- &lt;tbody>
-  &lt;tr>
-   &lt;td headers="n r1"> Sad
-   &lt;th id="r1"> Mood
-   &lt;td> Happy
-  &lt;tr>
-   &lt;td headers="n r2"> Failing
-   &lt;th id="r2"> Grade
-   &lt;td> Passing
-&lt;/table></pre></div>
-   </dd>
-
-   <dt>In the table's <code>caption</code>, in a <code>details</code> element</dt>
-
-   <dd>
-    <div class="example"><pre>&lt;table>
- &lt;caption>
-  &lt;strong>Characteristics with positive and negative sides.&lt;/strong>
-  &lt;details>
-   &lt;summary>Help&lt;/summary>
-   &lt;p>Characteristics are given in the second column, with the
-   negative side in the left column and the positive side in the right
-   column.&lt;/p>
-  &lt;/details>
- &lt;/caption>
- &lt;thead>
-  &lt;tr>
-   &lt;th id="n"> Negative
-   &lt;th> Characteristic
-   &lt;th> Positive
- &lt;tbody>
-  &lt;tr>
-   &lt;td headers="n r1"> Sad
-   &lt;th id="r1"> Mood
-   &lt;td> Happy
-  &lt;tr>
-   &lt;td headers="n r2"> Failing
-   &lt;th id="r2"> Grade
-   &lt;td> Passing
-&lt;/table></pre></div>
-   </dd>
-
-   <dt>Next to the table, in the same <code>figure</code></dt>
-
-   <dd>
-    <div class="example"><pre>&lt;figure>
- &lt;figcaption>Characteristics with positive and negative sides&lt;/figcaption>
- &lt;p>Characteristics are given in the second column, with the
- negative side in the left column and the positive side in the right
- column.&lt;/p>
- &lt;table>
-  &lt;thead>
-   &lt;tr>
-    &lt;th id="n"> Negative
-    &lt;th> Characteristic
-    &lt;th> Positive
-  &lt;tbody>
-   &lt;tr>
-    &lt;td headers="n r1"> Sad
-    &lt;th id="r1"> Mood
-    &lt;td> Happy
-   &lt;tr>
-    &lt;td headers="n r2"> Failing
-    &lt;th id="r2"> Grade
-    &lt;td> Passing
- &lt;/table>
-&lt;/figure></pre></div>
-   </dd>
-
-   <dt>Next to the table, in a <code>figure</code>'s <code>figcaption</code></dt>
-
-   <dd>
-    <div class="example"><pre>&lt;figure>
- &lt;figcaption>
-  &lt;strong>Characteristics with positive and negative sides&lt;/strong>
-  &lt;p>Characteristics are given in the second column, with the
-  negative side in the left column and the positive side in the right
-  column.&lt;/p>
- &lt;/figcaption>
- &lt;table>
-  &lt;thead>
-   &lt;tr>
-    &lt;th id="n"> Negative
-    &lt;th> Characteristic
-    &lt;th> Positive
-  &lt;tbody>
-   &lt;tr>
-    &lt;td headers="n r1"> Sad
-    &lt;th id="r1"> Mood
-    &lt;td> Happy
-   &lt;tr>
-    &lt;td headers="n r2"> Failing
-    &lt;th id="r2"> Grade
-    &lt;td> Passing
- &lt;/table>
-&lt;/figure></pre></div>
-   </dd>
-
-  </dl>
-
-  <p>Authors may also use other techniques, or combinations of the
-  above techniques, as appropriate.</p>
-
-  <p>The best option, of course, rather than writing a description
-  explaining the way the table is laid out, is to adjust the table
-  such that no explanation is needed.</p>
-
-  <div class="example">
-
-   <p>In the case of the table used in the examples above, a simple
-   rearrangement of the table so that the headers are on the top and
-   left sides removes the need for an explanation as well as removing
-   the need for the use of <code
-   title="attr-tdth-headers">headers</code> attributes:</p>
-
-   <pre>&lt;table>
- &lt;caption>Characteristics with positive and negative sides&lt;/caption>
- &lt;thead>
-  &lt;tr>
-   &lt;th> Characteristic
-   &lt;th> Negative
-   &lt;th> Positive
- &lt;tbody>
-  &lt;tr>
-   &lt;th> Mood
-   &lt;td> Sad
-   &lt;td> Happy
-  &lt;tr>
-   &lt;th> Grade
-   &lt;td> Failing
-   &lt;td> Passing
-&lt;/table></pre>
-
-  </div>
-
   <p>The <dfn title="attr-table-summary"><code>summary</code></dfn>
   attribute on <code>table</code> elements was suggested in earlier
   versions of the language as a technique for providing explanatory
   text for complex tables for users of screen readers. One of the <a
-  href="#table-descriptions">techniques</a> described <!--in the
-  <code>table</code> section--> above should be used
+  href="#table-descriptions-techniques">techniques</a> described
+  <!--in the <code>table</code> section--> below should be used
   instead. <!--Authors should not specify the <code
   title="attr-table-summary">summary</code> attribute on
   <code>table</code> elements. --> <!-- 2.65% pages --></p>
@@ -41676,6 +41500,190 @@
   </div>
 
 
+  <h5 id="table-descriptions-techniques">Techniques for describing tables</h5>
+
+  <p>There are a variety of ways to include this information, such as:</p>
+
+  <dl>
+
+   <dt>In prose, surrounding the table</dt>
+
+   <dd>
+    <div class="example"><pre>&lt;p>In the following table, characteristics are given in the second
+column, with the negative side in the left column and the positive
+side in the right column.&lt;/p>
+&lt;table>
+ &lt;caption>Characteristics with positive and negative sides&lt;/caption>
+ &lt;thead>
+  &lt;tr>
+   &lt;th id="n"> Negative
+   &lt;th> Characteristic
+   &lt;th> Positive
+ &lt;tbody>
+  &lt;tr>
+   &lt;td headers="n r1"> Sad
+   &lt;th id="r1"> Mood
+   &lt;td> Happy
+  &lt;tr>
+   &lt;td headers="n r2"> Failing
+   &lt;th id="r2"> Grade
+   &lt;td> Passing
+&lt;/table></pre></div>
+   </dd>
+
+   <dt>In the table's <code>caption</code></dt>
+
+   <dd>
+    <div class="example"><pre>&lt;table>
+ &lt;caption>
+  &lt;strong>Characteristics with positive and negative sides.&lt;/strong>
+  &lt;p>Characteristics are given in the second column, with the
+  negative side in the left column and the positive side in the right
+  column.&lt;/p>
+ &lt;/caption>
+ &lt;thead>
+  &lt;tr>
+   &lt;th id="n"> Negative
+   &lt;th> Characteristic
+   &lt;th> Positive
+ &lt;tbody>
+  &lt;tr>
+   &lt;td headers="n r1"> Sad
+   &lt;th id="r1"> Mood
+   &lt;td> Happy
+  &lt;tr>
+   &lt;td headers="n r2"> Failing
+   &lt;th id="r2"> Grade
+   &lt;td> Passing
+&lt;/table></pre></div>
+   </dd>
+
+   <dt>In the table's <code>caption</code>, in a <code>details</code> element</dt>
+
+   <dd>
+    <div class="example"><pre>&lt;table>
+ &lt;caption>
+  &lt;strong>Characteristics with positive and negative sides.&lt;/strong>
+  &lt;details>
+   &lt;summary>Help&lt;/summary>
+   &lt;p>Characteristics are given in the second column, with the
+   negative side in the left column and the positive side in the right
+   column.&lt;/p>
+  &lt;/details>
+ &lt;/caption>
+ &lt;thead>
+  &lt;tr>
+   &lt;th id="n"> Negative
+   &lt;th> Characteristic
+   &lt;th> Positive
+ &lt;tbody>
+  &lt;tr>
+   &lt;td headers="n r1"> Sad
+   &lt;th id="r1"> Mood
+   &lt;td> Happy
+  &lt;tr>
+   &lt;td headers="n r2"> Failing
+   &lt;th id="r2"> Grade
+   &lt;td> Passing
+&lt;/table></pre></div>
+   </dd>
+
+   <dt>Next to the table, in the same <code>figure</code></dt>
+
+   <dd>
+    <div class="example"><pre>&lt;figure>
+ &lt;figcaption>Characteristics with positive and negative sides&lt;/figcaption>
+ &lt;p>Characteristics are given in the second column, with the
+ negative side in the left column and the positive side in the right
+ column.&lt;/p>
+ &lt;table>
+  &lt;thead>
+   &lt;tr>
+    &lt;th id="n"> Negative
+    &lt;th> Characteristic
+    &lt;th> Positive
+  &lt;tbody>
+   &lt;tr>
+    &lt;td headers="n r1"> Sad
+    &lt;th id="r1"> Mood
+    &lt;td> Happy
+   &lt;tr>
+    &lt;td headers="n r2"> Failing
+    &lt;th id="r2"> Grade
+    &lt;td> Passing
+ &lt;/table>
+&lt;/figure></pre></div>
+   </dd>
+
+   <dt>Next to the table, in a <code>figure</code>'s <code>figcaption</code></dt>
+
+   <dd>
+    <div class="example"><pre>&lt;figure>
+ &lt;figcaption>
+  &lt;strong>Characteristics with positive and negative sides&lt;/strong>
+  &lt;p>Characteristics are given in the second column, with the
+  negative side in the left column and the positive side in the right
+  column.&lt;/p>
+ &lt;/figcaption>
+ &lt;table>
+  &lt;thead>
+   &lt;tr>
+    &lt;th id="n"> Negative
+    &lt;th> Characteristic
+    &lt;th> Positive
+  &lt;tbody>
+   &lt;tr>
+    &lt;td headers="n r1"> Sad
+    &lt;th id="r1"> Mood
+    &lt;td> Happy
+   &lt;tr>
+    &lt;td headers="n r2"> Failing
+    &lt;th id="r2"> Grade
+    &lt;td> Passing
+ &lt;/table>
+&lt;/figure></pre></div>
+   </dd>
+
+  </dl>
+
+  <p>Authors may also use other techniques, or combinations of the
+  above techniques, as appropriate.</p>
+
+  <p>The best option, of course, rather than writing a description
+  explaining the way the table is laid out, is to adjust the table
+  such that no explanation is needed.</p>
+
+  <div class="example">
+
+   <p>In the case of the table used in the examples above, a simple
+   rearrangement of the table so that the headers are on the top and
+   left sides removes the need for an explanation as well as removing
+   the need for the use of <code
+   title="attr-tdth-headers">headers</code> attributes:</p>
+
+   <pre>&lt;table>
+ &lt;caption>Characteristics with positive and negative sides&lt;/caption>
+ &lt;thead>
+  &lt;tr>
+   &lt;th> Characteristic
+   &lt;th> Negative
+   &lt;th> Positive
+ &lt;tbody>
+  &lt;tr>
+   &lt;th> Mood
+   &lt;td> Sad
+   &lt;td> Happy
+  &lt;tr>
+   &lt;th> Grade
+   &lt;td> Failing
+   &lt;td> Passing
+&lt;/table></pre>
+
+  </div>
+
+
+
+
   <h4>The <dfn><code>caption</code></dfn> element</h4>
 
   <dl class="element">

|