HTML Standard Tracker

Filter

File a bug

SVNBugCommentTime (UTC)
59788449apply wg decision2011-04-08 21:35
@@ -41125,205 +41125,29 @@ function AddCloud(data, x, y) { ... }</pre>
       <td> Passing
    </table>
 
    <p>...might benefit from a description explaining the way the table
    is laid out, something like "Characteristics are given in the
    second column, with the negative side in the left column and the
    positive side in the right column".</p>
 
   </div>
 
-  <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>
+  <p><a href="#table-descriptions-techniques">Guidance on how to
+  provide such information</a> is provided below.</p>
 
   <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>
 
   <p class="note">In particular, authors are encouraged to consider
   whether their explanatory text for tables is likely to be useful to
   the visually impaired: if their text would not be useful, then it is
   best to not include a <code
   title="attr-table-summary">summary</code> attribute. Similarly, if
   their explanatory text could help someone who is not visually
@@ -41669,20 +41493,204 @@ side in the right column.&lt;/p>
   &lt;tbody>
    &lt;tr> &lt;td> 6 &lt;td>   &lt;td>   &lt;td>   &lt;td> 5 &lt;td>   &lt;td>   &lt;td>   &lt;td> 2
    &lt;tr> &lt;td>   &lt;td>   &lt;td>   &lt;td>   &lt;td> 7 &lt;td>   &lt;td>   &lt;td>   &lt;td>
    &lt;tr> &lt;td> 9 &lt;td>   &lt;td>   &lt;td> 8 &lt;td>   &lt;td> 2 &lt;td>   &lt;td>   &lt;td> 5
  &lt;/table>
 &lt;/section></pre>
 
   </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">
    <dt>Categories</dt>
    <dd>None.</dd>
    <dt>Contexts in which this element can be used:</dt>
    <dd>As the first element child of a <code>table</code> element.</dd>
    <dt>Content model:</dt>
    <dd><span>Flow content</span>, but with no descendant <code>table</code> elements.</dd>
    <dt>Content attributes:</dt>

|