Skip to content

Commit

Permalink
[e] (0) Source cleanup: remove the text that the HTMLWG version has t…
Browse files Browse the repository at this point in the history 
…hat is all wishy washy about presentational tables for no good reason.

Affected topics: HTML

git-svn-id: http://svn.whatwg.org/webapps@7188 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Jul 20, 2012
1 parent 57155a0 commit 4042161
Show file tree
Hide file tree
Showing 3 changed files with 14 additions and 172 deletions.
56 changes: 5 additions & 51 deletions complete.html
View file
Expand Up @@ -41987,8 +41987,6 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co
may report the contents of that attribute to the user.</p>
</div>

<!--FORK-->

<p>Tables must not be used as layout aids.

Historically, some Web authors have misused tables in HTML as a way
Expand All @@ -42000,46 +41998,6 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co
likely to find it very difficult to navigate pages with tables used
for layout.</p>

<!-- The paragraph below replaces the above one in the W3C copy due
to a WG decision. It is not used in the WHATWG copy for the
following reasons:

* "should not" implies that there may be valid reasons to use
tables for layout, which there are not.

* The second sentence appears to be grammatically incorrect, and
more importantly, does not clearly state that use of tables for
layout has always been a misuse. This implies it may have once
been correct (even though that is not the case), and that further
may reduce the effectiveness of advocacy on this topic.

* The third sentence (in the paragraph below) is identical to the
fourth one in the paragraph above except for comma usage which
seems incorrect (it implies that the users are the screen
readers, as opposed to the tools, if I'm reading it right).

* The final sentence below flat out legitimizes layout tables.

* The paragraph below seems to assume that only ARIA-enabled ATs
are a concern, when in fact there are numerous UAs other than
ARIA-enabled ATs that are harmed by this use of layout tables.

* The paragraph below fails to suggest that UAs will need
heuristics to deal with the existing content.

* The text below actually contradicts other requirements in this
specification (<table>s represent tables, and elements must be
used per their semantics, so the requirement that tables not be
used for layout is in fact technically redundant, and the
paragraph below doesn't change that).

* There really is no good reason to use tables for layout anymore,
and conformance criteria should support best practices, not
obsolete authoring practices.

-->


<p class=note>There are a variety of alternatives to using HTML
tables for layout, primarily using CSS positioning and the CSS table
model.</p>
Expand All @@ -42055,14 +42013,12 @@ <h4 id=the-table-element><span class=secno>4.9.1 </span>The <dfn><code>table</co


<div class=impl>

<hr><p>Tables can be complicated to understand and navigate. To help
users with this, user agents should clearly delineate cells in a
table from each other, unless the user agent has classified the
table as a
<!--FORK-->
(non-conforming)
<!--FORK-->
layout table.</p>
table as a (non-conforming) layout table.</p>

</div>

<p class=note>Authors <span class=impl>and implementors</span>
Expand Down Expand Up @@ -42694,7 +42650,6 @@ <h4 id=the-caption-element><span class=secno>4.9.2 </span>The <dfn><code>caption
the cell that corresponds to the values of the two dice.
&lt;/caption&gt;</pre>

<!--HTML4POLICE (hidden in w3c version because w3c version has to be valid HTML4) --><!--FORK-->
<p>This provides the user with more context:</p>

<table class=dice-example><caption>
Expand All @@ -42711,7 +42666,7 @@ <h4 id=the-caption-element><span class=secno>4.9.2 </span>The <dfn><code>caption
<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><!--HTML4POLICE--><!--FORK--></div>
</table></div>



Expand Down Expand Up @@ -44514,7 +44469,6 @@ <h4 id=examples-0><span class=secno>4.9.13 </span>Examples</h4>
&lt;td&gt;29.0%
&lt;/table&gt;</pre>

<!--HTML4POLICE--><!--FORK-->
<p>This table could look like this:</p>

<table class="apple-table-examples e1"><thead><tr><th>
Expand All @@ -44537,7 +44491,7 @@ <h4 id=examples-0><span class=secno>4.9.13 </span>Examples</h4>
<td>34.3%
<td>34.0%
<td>29.0%
</table><!--HTML4POLICE--><!--FORK--><hr><p>The following shows how one might mark up the operating expenses
</table><hr><p>The following shows how one might mark up the operating expenses
table from lower on the same page of that document:</p>

<pre>&lt;table&gt;
Expand Down
56 changes: 5 additions & 51 deletions index
View file
Expand Up @@ -41987,8 +41987,6 @@ function AddCloud(data, x, y) { ... }</pre>
may report the contents of that attribute to the user.</p>
</div>

<!--FORK-->

<p>Tables must not be used as layout aids.

Historically, some Web authors have misused tables in HTML as a way
Expand All @@ -42000,46 +41998,6 @@ function AddCloud(data, x, y) { ... }</pre>
likely to find it very difficult to navigate pages with tables used
for layout.</p>

<!-- The paragraph below replaces the above one in the W3C copy due
to a WG decision. It is not used in the WHATWG copy for the
following reasons:

* "should not" implies that there may be valid reasons to use
tables for layout, which there are not.

* The second sentence appears to be grammatically incorrect, and
more importantly, does not clearly state that use of tables for
layout has always been a misuse. This implies it may have once
been correct (even though that is not the case), and that further
may reduce the effectiveness of advocacy on this topic.

* The third sentence (in the paragraph below) is identical to the
fourth one in the paragraph above except for comma usage which
seems incorrect (it implies that the users are the screen
readers, as opposed to the tools, if I'm reading it right).

* The final sentence below flat out legitimizes layout tables.

* The paragraph below seems to assume that only ARIA-enabled ATs
are a concern, when in fact there are numerous UAs other than
ARIA-enabled ATs that are harmed by this use of layout tables.

* The paragraph below fails to suggest that UAs will need
heuristics to deal with the existing content.

* The text below actually contradicts other requirements in this
specification (<table>s represent tables, and elements must be
used per their semantics, so the requirement that tables not be
used for layout is in fact technically redundant, and the
paragraph below doesn't change that).

* There really is no good reason to use tables for layout anymore,
and conformance criteria should support best practices, not
obsolete authoring practices.

-->


<p class=note>There are a variety of alternatives to using HTML
tables for layout, primarily using CSS positioning and the CSS table
model.</p>
Expand All @@ -42055,14 +42013,12 @@ function AddCloud(data, x, y) { ... }</pre>


<div class=impl>

<hr><p>Tables can be complicated to understand and navigate. To help
users with this, user agents should clearly delineate cells in a
table from each other, unless the user agent has classified the
table as a
<!--FORK-->
(non-conforming)
<!--FORK-->
layout table.</p>
table as a (non-conforming) layout table.</p>

</div>

<p class=note>Authors <span class=impl>and implementors</span>
Expand Down Expand Up @@ -42694,7 +42650,6 @@ 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>

<!--HTML4POLICE (hidden in w3c version because w3c version has to be valid HTML4) --><!--FORK-->
<p>This provides the user with more context:</p>

<table class=dice-example><caption>
Expand All @@ -42711,7 +42666,7 @@ the cell that corresponds to the values of the two dice.
<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><!--HTML4POLICE--><!--FORK--></div>
</table></div>



Expand Down Expand Up @@ -44514,7 +44469,6 @@ the cell that corresponds to the values of the two dice.
&lt;td&gt;29.0%
&lt;/table&gt;</pre>

<!--HTML4POLICE--><!--FORK-->
<p>This table could look like this:</p>

<table class="apple-table-examples e1"><thead><tr><th>
Expand All @@ -44537,7 +44491,7 @@ the cell that corresponds to the values of the two dice.
<td>34.3%
<td>34.0%
<td>29.0%
</table><!--HTML4POLICE--><!--FORK--><hr><p>The following shows how one might mark up the operating expenses
</table><hr><p>The following shows how one might mark up the operating expenses
table from lower on the same page of that document:</p>

<pre>&lt;table&gt;
Expand Down
74 changes: 4 additions & 70 deletions source
View file
Expand Up @@ -49054,8 +49054,6 @@ function AddCloud(data, x, y) { ... }</pre>
may report the contents of that attribute to the user.</p>
</div>

<!--END w3c-html--><!--FORK-->

<p>Tables must not be used as layout aids.

Historically, some Web authors have misused tables in HTML as a way
Expand All @@ -49067,65 +49065,6 @@ function AddCloud(data, x, y) { ... }</pre>
likely to find it very difficult to navigate pages with tables used
for layout.</p>

<!-- The paragraph below replaces the above one in the W3C copy due
to a WG decision. It is not used in the WHATWG copy for the
following reasons:

* "should not" implies that there may be valid reasons to use
tables for layout, which there are not.

* The second sentence appears to be grammatically incorrect, and
more importantly, does not clearly state that use of tables for
layout has always been a misuse. This implies it may have once
been correct (even though that is not the case), and that further
may reduce the effectiveness of advocacy on this topic.

* The third sentence (in the paragraph below) is identical to the
fourth one in the paragraph above except for comma usage which
seems incorrect (it implies that the users are the screen
readers, as opposed to the tools, if I'm reading it right).

* The final sentence below flat out legitimizes layout tables.

* The paragraph below seems to assume that only ARIA-enabled ATs
are a concern, when in fact there are numerous UAs other than
ARIA-enabled ATs that are harmed by this use of layout tables.

* The paragraph below fails to suggest that UAs will need
heuristics to deal with the existing content.

* The text below actually contradicts other requirements in this
specification (<table>s represent tables, and elements must be
used per their semantics, so the requirement that tables not be
used for layout is in fact technically redundant, and the
paragraph below doesn't change that).

* There really is no good reason to use tables for layout anymore,
and conformance criteria should support best practices, not
obsolete authoring practices.

-->

<!--END complete--><!--END dev-html--><!--START w3c-html--><!--FORK-->

<p>Tables should not be used as layout aids.

Historically, many Web authors have tables in HTML as a way to
control their page layout making it difficult to extract tabular
data from such documents.

In particular, users of accessibility tools, like screen readers,
are likely to find it very difficult to navigate pages with tables
used for layout.

If a table is to be used for layout it must be marked with the
attribute role="presentation" for a user agent to properly represent
the table to an assistive technology and to properly convey the
intent of the author to tools that wish to extract tabular data from
the document.</p>

<!--START complete--><!--START dev-html--><!--FORK-->

<p class="note">There are a variety of alternatives to using HTML
tables for layout, primarily using CSS positioning and the CSS table
model.</p>
Expand All @@ -49141,15 +49080,14 @@ function AddCloud(data, x, y) { ... }</pre>


<div class="impl">

<hr>

<p>Tables can be complicated to understand and navigate. To help
users with this, user agents should clearly delineate cells in a
table from each other, unless the user agent has classified the
table as a
<!--END w3c-html--><!--FORK-->
(non-conforming)
<!--START w3c-html--><!--FORK-->
layout table.</p>
table as a (non-conforming) layout table.</p>

</div>

<p class="note">Authors <span class="impl">and implementors</span>
Expand Down Expand Up @@ -49847,7 +49785,6 @@ 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></pre>

<!--END w3c-html--><!--HTML4POLICE (hidden in w3c version because w3c version has to be valid HTML4) --><!--FORK-->
<p>This provides the user with more context:</p>

<table class="dice-example">
Expand All @@ -49866,7 +49803,6 @@ the cell that corresponds to the values of the two dice.
<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>
<!--START w3c-html--><!--HTML4POLICE--><!--FORK-->

</div>

Expand Down Expand Up @@ -52069,7 +52005,6 @@ the cell that corresponds to the values of the two dice.
&lt;td>29.0%
&lt;/table></pre>

<!--END w3c-html--><!--HTML4POLICE--><!--FORK-->
<p>This table could look like this:</p>

<table class="apple-table-examples e1">
Expand Down Expand Up @@ -52103,7 +52038,6 @@ the cell that corresponds to the values of the two dice.
<td>34.0%
<td>29.0%
</table>
<!--START w3c-html--><!--HTML4POLICE--><!--FORK-->

<hr>

Expand Down

0 comments on commit 4042161

Please sign in to comment.