Skip to content

Commit

Permalink
[c] (2) apply wg decision
Browse files Browse the repository at this point in the history 
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=7539

git-svn-id: http://svn.whatwg.org/webapps@5999 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Apr 13, 2011
1 parent 9101289 commit 7d36a2f
Show file tree
Hide file tree
Showing 3 changed files with 155 additions and 297 deletions.
145 changes: 49 additions & 96 deletions complete.html
View file
Expand Up @@ -239,7 +239,7 @@

<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1>Web Applications 1.0</h1>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 12 April 2011</h2>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 13 April 2011</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
Expand Down Expand Up @@ -37097,7 +37097,6 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co
total).</dd>
<dt>Content attributes:</dt>
<dd><a href=#global-attributes>Global attributes</a></dd>
<dd><code title=attr-table-summary><a href=#attr-table-summary>summary</a></code> (but see prose)</dd>
<dt>DOM interface:</dt>
<dd>
<pre class=idl>interface <dfn id=htmltableelement>HTMLTableElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
Expand All @@ -37115,7 +37114,6 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co
readonly attribute <a href=#htmlcollection>HTMLCollection</a> <a href=#dom-table-rows title=dom-table-rows>rows</a>;
<a href=#htmlelement>HTMLElement</a> <a href=#dom-table-insertrow title=dom-table-insertRow>insertRow</a>(in optional long index);
void <a href=#dom-table-deleterow title=dom-table-deleteRow>deleteRow</a>(in long index);
attribute DOMString <a href=#dom-table-summary title=dom-table-summary>summary</a>;
};</pre>
</dd>
</dl><p>The <code><a href=#the-table-element>table</a></code> element <a href=#represents>represents</a> data with
Expand Down Expand Up @@ -37156,80 +37154,9 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co
are described in the description of the <a href=#table-model>table
model</a>.</span></p>

<p id=table-descriptions>For tables that consist of more than just
a grid of cells with headers in the first row and headers in the
first column, and for any table in general where the reader might
have difficulty understanding the content, authors should include
explanatory information introducing the table. This information is
useful for all users, but is especially useful for users who cannot
see the table, e.g. users of screen readers.</p>

<p>Such explanatory information should introduce the purpose of the
table, outline its basic cell structure, highlight any trends or
patterns, and generally teach the user how to use the table.</p>

<div class=example>

<p>For instance, the following table:</p>

<table><caption>Characteristics with positive and negative sides</caption>
<thead><tr><th id=n> Negative
<th> Characteristic
<th> Positive
<tbody><tr><td headers="n r1"> Sad
<th id=r1> Mood
<td> Happy
<tr><td headers="n r2"> Failing
<th id=r2> Grade
<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><a href=#table-descriptions-techniques>Guidance on how to
provide such information</a> is provided below.</p>

<p>The <dfn id=attr-table-summary title=attr-table-summary><code>summary</code></dfn>
attribute on <code><a href=#the-table-element>table</a></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>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><a href=#attr-table-summary>summary</a></code> attribute. Similarly, if
their explanatory text could help someone who is not visually
impaired, e.g. someone who is seeing the table for the first time,
then the text would be more useful before the table or in the
<code><a href=#the-caption-element>caption</a></code>. For example, describing the conclusions of the
data in a table is useful to everyone; explaining how to read the
table, if not obvious from the headers alone, is useful to everyone;
describing the structure of the table, if it is easy to grasp
visually, might not be useful to everyone, but it might also not be
useful to users who can quickly navigate the table with an
accessibility tool.</p>

<!--
<p class="note">Use of the <code
title="attr-table-summary">summary</code> attribute is discouraged
because in practice it is poorly understood. Because the attribute
is not exposed in visual user agents, authors who have included it
have typically not been able to test it, and have therefore set the
attribute to values that are of no use to users of accessibility
tools. This has lead to accessibility tools introducing heuristics
to try to avoid exposing such usage of the attribute to users. Even
the few authors who have made the best use of the attribute have
often misused it, for example by including text that would in fact
be useful for all users, or that is redundant with other information
on the page separate from the table.</p>
-->
<p>Authors are encouraged to provide information describing how to
interpret complex tables. Guidance on how <a href=#table-descriptions-techniques>provide such information</a>
is given below.</p>

<div class=impl>

Expand Down Expand Up @@ -37486,11 +37413,7 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co

<li><p>Otherwise, the method must remove the <var title="">index</var>th element in the <code title=dom-table-rows><a href=#dom-table-rows>rows</a></code> collection from its parent.</p>

</ol><p>The <dfn id=dom-table-summary title=dom-table-summary><code>summary</code></dfn> IDL
attribute must <a href=#reflect>reflect</a> the content attribute of the
same name.</p>

</div>
</ol></div>

<div class=example>

Expand Down Expand Up @@ -37529,6 +37452,42 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co

<h5 id=table-descriptions-techniques><span class=secno>4.9.1.1 </span>Techniques for describing tables</h5>

<p id=table-descriptions>For tables that consist of more than just
a grid of cells with headers in the first row and headers in the
first column, and for any table in general where the reader might
have difficulty understanding the content, authors should include
explanatory information introducing the table. This information is
useful for all users, but is especially useful for users who cannot
see the table, e.g. users of screen readers.</p>

<p>Such explanatory information should introduce the purpose of the
table, outline its basic cell structure, highlight any trends or
patterns, and generally teach the user how to use the table.</p>

<!--Describing the conclusions of the data in a table is useful to
everyone; explaining how to read the table, if not obvious from the
headers alone, is useful to everyone; describing the structure of
the table, if it is easy to grasp visually, might not be useful to
everyone, but it might also not be useful to users who can quickly
navigate the table with an accessibility tool.-->

<p>For instance, the following table:</p>

<table><caption>Characteristics with positive and negative sides</caption>
<thead><tr><th id=n> Negative
<th> Characteristic
<th> Positive
<tbody><tr><td headers="n r1"> Sad
<th id=r1> Mood
<td> Happy
<tr><td headers="n r2"> Failing
<th id=r2> Grade
<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>

<p>There are a variety of ways to include this information, such as:</p>

<dl><dt>In prose, surrounding the table</dt>
Expand Down Expand Up @@ -91606,10 +91565,6 @@ <h3 id=obsolete-but-conforming-features><span class=secno>16.1 </span>Obsolete b
<p class=note>In <a href=#syntax>the HTML syntax</a>, specifying a <a href=#syntax-doctype title=syntax-DOCTYPE>DOCTYPE</a> that is an <a href=#obsolete-permitted-doctype>obsolete
permitted DOCTYPE</a> will also trigger a warning.</p>

<p class=note>The <code title=attr-table-summary><a href=#attr-table-summary>summary</a></code>
attribute, defined in the <code><a href=#the-table-element>table</a></code> section, will also
trigger a warning.</p>


<div class=impl>

Expand Down Expand Up @@ -91644,9 +91599,6 @@ <h4 id=warnings-for-obsolete-but-conforming-features><span class=secno>16.1.1 </
attribute on an <code><a href=#the-a-element>a</a></code> element, if its value is not the
empty string.</li>

<li><p>The presence of a <code title=attr-table-summary><a href=#attr-table-summary>summary</a></code> attribute on a
<code><a href=#the-table-element>table</a></code> element.</li> <!-- 2.65% pages -->

</ul><p>Conformance checkers must distinguish between pages that have no
conformance errors and have none of these obsolete features, and
pages that have no conformance errors but do have some of these
Expand Down Expand Up @@ -91831,6 +91783,11 @@ <h3 id=non-conforming-features><span class=secno>16.2 </span>Non-conforming feat
<dt><dfn id=attr-table-datapagesize title=attr-table-datapagesize><code>datapagesize</code></dfn> on <code><a href=#the-table-element>table</a></code> elements</dt>
<dd><p>Unnecessary. Omit it altogether.</dd>

<dt><dfn id=attr-table-summary title=attr-table-summary><code>summary</code></dfn> on <code><a href=#the-table-element>table</a></code> elements</dt><!-- 2.65% pages -->
<dd><p>Use one of the <a href=#table-descriptions-techniques>techniques for describing
tables</a> given in the <code><a href=#the-table-element>table</a></code> section
instead.</dd>

<dt><dfn id=attr-tdth-abbr title=attr-tdth-abbr><code>abbr</code></dfn> on <code><a href=#the-td-element>td</a></code> and <code><a href=#the-th-element>th</a></code> elements</dt>
<dd><p>Use text that begins in an unambiguous and terse manner, and include any more elaborate text after that. The <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute can also be useful in including more detailed text, so that the cell's contents can be made terse.</p>

Expand Down Expand Up @@ -92846,10 +92803,11 @@ <h4 id=other-elements,-attributes-and-apis><span class=secno>16.3.4 </span>Other
attribute DOMString <a href=#dom-table-cellspacing title=dom-table-cellSpacing>cellSpacing</a>;
attribute DOMString <a href=#dom-table-frame title=dom-table-frame>frame</a>;
attribute DOMString <a href=#dom-table-rules title=dom-table-rules>rules</a>;
attribute DOMString <a href=#dom-table-summary title=dom-table-summary>summary</a>;
attribute DOMString <a href=#dom-table-width title=dom-table-width>width</a>;
};</pre>

<p>The <dfn id=dom-table-align title=dom-table-align><code>align</code></dfn>, <dfn id=dom-table-border title=dom-table-border><code>border</code></dfn>, <dfn id=dom-table-frame title=dom-table-frame><code>frame</code></dfn>, <dfn id=dom-table-rules title=dom-table-rules><code>rules</code></dfn>, and <dfn id=dom-table-width title=dom-table-width><code>width</code></dfn>, IDL attributes of
<p>The <dfn id=dom-table-align title=dom-table-align><code>align</code></dfn>, <dfn id=dom-table-border title=dom-table-border><code>border</code></dfn>, <dfn id=dom-table-frame title=dom-table-frame><code>frame</code></dfn>, <dfn id=dom-table-summary title=dom-table-summary><code>summary</code></dfn>, <dfn id=dom-table-rules title=dom-table-rules><code>rules</code></dfn>, and <dfn id=dom-table-width title=dom-table-width><code>width</code></dfn>, IDL attributes of
the <code><a href=#the-table-element>table</a></code> element must <a href=#reflect>reflect</a> the
respective content attributes of the same name.</p>

Expand Down Expand Up @@ -94761,8 +94719,7 @@ <h3 class=no-num id=elements-1>Elements</h3>
<code><a href=#the-tbody-element>tbody</a></code>*;
<code><a href=#the-tfoot-element>tfoot</a></code>*;
<code><a href=#the-tr-element>tr</a></code>*</td>
<td><a href=#global-attributes title="global attributes">globals</a>;
<code title=attr-table-summary><a href=#attr-table-summary>summary</a></code></td>
<td><a href=#global-attributes title="global attributes">globals</a></td>
<td><code><a href=#htmltableelement>HTMLTableElement</a></code></td>
<tr><th><code><a href=#the-tbody-element>tbody</a></code></th>
<td>Group of rows in a table</td>
Expand Down Expand Up @@ -95824,10 +95781,6 @@ <h3 class=no-num id=element-content-categories>Element content categories</h3>
<td> <a href=#the-style-attribute title=attr-style>HTML elements</a>
<td> Presentational and formatting instructions
<td> CSS declarations*
<tr><th> <code title="">summary</code>
<td> <code title=attr-table-summary><a href=#attr-table-summary>table</a></code>
<td> Explanatory text for complex tables for users of screen readers
<td> <a href=#attribute-text>Text</a>*
<tr><th> <code title="">tabindex</code>
<td> <a href=#attr-tabindex title=attr-tabindex>HTML elements</a>
<td> Whether the element is focusable, and the relative order of the element for the purposes of sequential focus navigation
Expand Down

0 comments on commit 7d36a2f

Please sign in to comment.