- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 14 Apr 2011 23:47:02 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv32254
Modified Files:
Overview.html
Log Message:
apply wg decision (add the <table border=1> talisman) (whatwg r6008)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4830
retrieving revision 1.4831
diff -u -d -r1.4830 -r1.4831
--- Overview.html 14 Apr 2011 22:18:07 -0000 1.4830
+++ Overview.html 14 Apr 2011 23:46:57 -0000 1.4831
@@ -813,7 +813,8 @@
<ol>
<li><a href="#the-table-element"><span class="secno">4.9.1 </span>The <code>table</code> element</a>
<ol>
- <li><a href="#table-descriptions-techniques"><span class="secno">4.9.1.1 </span>Techniques for describing tables</a></ol></li>
+ <li><a href="#table-descriptions-techniques"><span class="secno">4.9.1.1 </span>Techniques for describing tables</a></li>
+ <li><a href="#table-layout-techniques"><span class="secno">4.9.1.2 </span>Techniques for table layout</a></ol></li>
<li><a href="#the-caption-element"><span class="secno">4.9.2 </span>The <code>caption</code> element</a></li>
<li><a href="#the-colgroup-element"><span class="secno">4.9.3 </span>The <code>colgroup</code> element</a></li>
<li><a href="#the-col-element"><span class="secno">4.9.4 </span>The <code>col</code> element</a></li>
@@ -26585,6 +26586,7 @@
total).</dd>
<dt>Content attributes:</dt>
<dd><a href="#global-attributes">Global attributes</a></dd>
+ <dd><code title="attr-table-border"><a href="#attr-table-border">border</a></code></dd>
<dt>DOM interface:</dt>
<dd>
<pre class="idl">interface <dfn id="htmltableelement">HTMLTableElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
@@ -26602,15 +26604,26 @@
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-border" title="dom-table-border">border</a>;
};</pre>
</dd>
</dl><p>The <code><a href="#the-table-element">table</a></code> element <a href="#represents">represents</a> data with
more than one dimension, in the form of a <a href="#concept-table" title="concept-table">table</a>.<div class="impl">
-
<p>The <code><a href="#the-table-element">table</a></code> element takes part in the <a href="#table-model">table
model</a>.</p>
-
- </div><p>Tables should not be used as layout aids.
+ </div><p>Tables have rows, columns, and cells given by their descendants.
+ The rows and columns form a grid; a table's cells must completely
+ cover that grid without overlap.<div class="impl">
+ <p class="note">Precise rules for determining whether this
+ conformance requirement is met are described in the description of
+ the <a href="#table-model">table model</a>.</p>
+ </div><hr><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.<div class="impl">
+ <p>If a <code><a href="#the-table-element">table</a></code> element has a <code title="attr-table-summary"><a href="#attr-table-summary">summary</a></code> attribute, and the user
+ agent has not classified the table as a layout table, the user agent
+ may report the contents of that attribute to the user.</p>
+ </div><hr><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
@@ -26626,20 +26639,47 @@
intent of the author to tools that wish to extract tabular data from
the document.</p><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>Tables have rows, columns, and cells given by their descendants.
- The rows and columns form a grid; a table's cells must completely
- cover that grid without overlap.<div class="impl">
- <p class="note">Precise rules for determining whether this
- conformance requirement is met are described in the description of
- the <a href="#table-model">table model</a>.</p>
- </div><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.<div class="impl">
+ model.<p>The <dfn id="attr-table-border" title="attr-table-border"><code>border</code></dfn>
+ attribute may be specified on a <code><a href="#the-table-element">table</a></code> element to
+ explicitly indicate that the <code><a href="#the-table-element">table</a></code> element is not being
+ used for layout purposes. If specified, the attribute's value must
+ either be the empty string or the value "<code title="">1</code>".
+ The attribute is used by certain user agents as an indication that
+ borders should be drawn around cells of the table.<div class="impl">
+ <p>Tables can be complicated to understand and navigate. To help
+ users with this, user agents should clearly dilineate cells in a
+ table from each other, unless the user agent has classified the
+ table as a
+ layout table.</p>
+ </div><p class="note">Authors <span class="impl">and implementors</span>
+ are encouraged to consider using some of the <a href="#table-layout-techniques">table layout techniques</a>
+ described below to make tables easier to navigate for users.<div class="impl">
- <p>If a <code><a href="#the-table-element">table</a></code> element has a <code title="attr-table-summary"><a href="#attr-table-summary">summary</a></code> attribute, the user agent
- may report the contents of that attribute to the user.</p>
+ <p>User agents, especially those that do table analysis on arbitrary
+ content, are encouraged to find heuristics to determine which tables
+ actually contain data and which are merely being used for layout.
+ This specification does not define a precise heuristic, but the
+ following are suggested as possible indicators:</p>
- </div><dl class="domintro"><dt><var title="">table</var> . <code title="dom-table-caption"><a href="#dom-table-caption">caption</a></code> [ = <var title="">value</var> ]</dt>
+ <table><thead><tr><th>Feature
+ <th>Indication
+ <tbody><tr><td>The use of the <code title="attr-aria-role">role</code> attribute with the value <code title="attr-aria-role-presentation">presentation</code>
+ <td>Probably a layout table
+ <tr><td>The use of the <code title="attr-table-border"><a href="#attr-table-border">border</a></code> attribute with the non-conforming value 0
+ <td>Probably a layout table
+ <tr><td>The use of the non-conforming <code title="attr-table-cellspacing"><a href="#attr-table-cellspacing">cellspacing</a></code> and <code title="attr-table-cellpadding"><a href="#attr-table-cellpadding">cellpadding</a></code> attributes with the value 0
+ <td>Probably a layout table
+ <tbody><tr><td>The use of <code><a href="#the-caption-element">caption</a></code>, <code><a href="#the-thead-element">thead</a></code>, or <code><a href="#the-th-element">th</a></code> elements
+ <td>Probably a non-layout table
+ <tr><td>The use of the <code title="attr-tdth-headers"><a href="#attr-tdth-headers">headers</a></code> and <code title="attr-th-scope"><a href="#attr-th-scope">scope</a></code> attributes
+ <td>Probably a non-layout table
+ <tr><td>The use of the <code title="attr-table-border"><a href="#attr-table-border">border</a></code> attribute with a value other than 0
+ <td>Probably a non-layout table
+ <tr><td>Explicit visible borders set using CSS
+ <td>Probably a non-layout table
+ <tbody><tr><td>The use of the <code title="attr-table-summary"><a href="#attr-table-summary">summary</a></code> attribute
+ <td>Not a good indicator (both layout and non-layout tables have historically been given this attribute)
+ </table></div><hr><dl class="domintro"><dt><var title="">table</var> . <code title="dom-table-caption"><a href="#dom-table-caption">caption</a></code> [ = <var title="">value</var> ]</dt>
<dd>
<p>Returns the table's <code><a href="#the-caption-element">caption</a></code> element.</p>
<p>Can be set, to replace the <code><a href="#the-caption-element">caption</a></code> element. If the
@@ -26887,7 +26927,11 @@
<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></div><div class="example">
+ </ol><p>The <dfn id="dom-table-border" title="dom-table-border"><code>border</code></dfn> IDL
+ attribute must <a href="#reflect">reflect</a> the content attribute of the
+ same name.</p>
+
+ </div><div class="example">
<p>Here is an example of a table being used to mark up a Sudoku
puzzle. Observe the lack of headers, which are not necessary in
@@ -27106,6 +27150,19 @@
<td> Passing
</table></pre>
+ </div><h5 id="table-layout-techniques"><span class="secno">4.9.1.2 </span>Techniques for table layout</h5><p>Good table layout is key to making tables more readable and usable.<p>In visual media, providing column and row borders and alternating
+ row backgrounds can be very effective to make complicated tables
+ more readable.<p>For tables with large volumes of numeric content, using
+ monospaced fonts can help users see patterns, especially in
+ situations where a user agent does not render the borders.
+ (Unfortunately, for historical reasons, not rendering borders on
+ tables is a common default.)<p>In speech media, table cells can be distinguished by reporting
+ the corresponding headers before reading the cell's contents, and by
+ allowing users to navigate the table in a grid fashion, rather than
+ serialising the entire contents of the table in source order.<p>Authors are encouraged to use CSS to achieve these effects.<div class="impl">
+ <p>User agents are encouraged to render tables using these
+ techniques whenever the page does not use CSS and the table is not
+ classified as a layout table.</p>
</div><h4 id="the-caption-element"><span class="secno">4.9.2 </span>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>
@@ -64721,7 +64778,6 @@
<dt><dfn id="attr-pre-width" title="attr-pre-width"><code>width</code></dfn> on <code><a href="#the-pre-element">pre</a></code> elements</dt>
<dt><dfn id="attr-table-align" title="attr-table-align"><code>align</code></dfn> on <code><a href="#the-table-element">table</a></code> elements</dt>
<dt><dfn id="attr-table-bgcolor" title="attr-table-bgcolor"><code>bgcolor</code></dfn> on <code><a href="#the-table-element">table</a></code> elements</dt>
- <dt><dfn id="attr-table-border" title="attr-table-border"><code>border</code></dfn> on <code><a href="#the-table-element">table</a></code> elements</dt>
<dt><dfn id="attr-table-cellpadding" title="attr-table-cellpadding"><code>cellpadding</code></dfn> on <code><a href="#the-table-element">table</a></code> elements</dt>
<dt><dfn id="attr-table-cellspacing" title="attr-table-cellspacing"><code>cellspacing</code></dfn> on <code><a href="#the-table-element">table</a></code> elements</dt>
<dt><dfn id="attr-table-frame" title="attr-table-frame"><code>frame</code></dfn> on <code><a href="#the-table-element">table</a></code> elements</dt>
@@ -64749,7 +64805,15 @@
<dt><dfn id="attr-background" title="attr-background"><code>background</code></dfn> on <code><a href="#the-body-element-0">body</a></code>, <code><a href="#the-table-element">table</a></code>, <code><a href="#the-thead-element">thead</a></code>, <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>, <code><a href="#the-td-element">td</a></code>, and <code><a href="#the-th-element">th</a></code> elements</dt>
<dd><p>Use CSS instead.</dd>
- </dl><div class="impl">
+ </dl><hr><p>The <code title="attr-table-border"><a href="#attr-table-border">border</a></code> attribute on
+ the <code><a href="#the-table-element">table</a></code> element can be used to provide basic fallback
+ styling for the purpose of making tables legible in browsing
+ environements where CSS support is limited or absent, such as
+ text-based browsers, WYSIWYG editors, and in situations where CSS
+ support is disabled or the style sheet is lost. Only the empty
+ string and the value "<code title="">1</code>" may be used as <code title="attr-table-border"><a href="#attr-table-border">border</a></code> values for this purpose.
+ Other values are considered obsolete. To regulate the thickness of
+ such borders, authors should instead use CSS.<div class="impl">
<h3 id="requirements-for-implementations"><span class="secno">11.3 </span>Requirements for implementations</h3>
@@ -65661,7 +65725,6 @@
interface <a href="#htmltableelement">HTMLTableElement</a> {
attribute DOMString <a href="#dom-table-align" title="dom-table-align">align</a>;
attribute DOMString <a href="#dom-table-bgcolor" title="dom-table-bgColor">bgColor</a>;
- attribute DOMString <a href="#dom-table-border" title="dom-table-border">border</a>;
attribute DOMString <a href="#dom-table-cellpadding" title="dom-table-cellPadding">cellPadding</a>;
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>;
@@ -65670,7 +65733,7 @@
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-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
+ <p>The <dfn id="dom-table-align" title="dom-table-align"><code>align</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>
@@ -67157,7 +67220,8 @@
<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></td>
+ <td><a href="#global-attributes" title="global attributes">globals</a>;
+ <code title="attr-table-border"><a href="#attr-table-border">border</a></code></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>
@@ -67676,6 +67740,10 @@
<code title="attr-media-autoplay"><a href="#attr-media-autoplay">video</a></code>
<td> Hint that the <a href="#media-resource">media resource</a> can be started automatically when the page is loaded
<td> <a href="#boolean-attribute">Boolean attribute</a>
+ <tr><th> <code title="">border</code>
+ <td> <code title="attr-table-border"><a href="#attr-table-border">border</a></code>
+ <td> Explicit indication that the <code><a href="#the-table-element">table</a></code> element is not being used for layout purposes
+ <td> The empty string, or "<code title="">1</code>"
<tr><th> <code title="">challenge</code>
<td> <code title="attr-keygen-challenge"><a href="#attr-keygen-challenge">keygen</a></code>
<td> String to package with the generated and signed public key
Received on Thursday, 14 April 2011 23:47:04 UTC