- 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