W3C home > Mailing lists > Public > public-html-commits@w3.org > April 2011

html5/spec Overview.html,1.4830,1.4831

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 14 Apr 2011 23:47:02 +0000
To: public-html-commits@w3.org
Message-Id: <E1QAWFa-0008Oh-87@lionel-hutz.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 @@
    &lt;td&gt; Passing
 &lt;/table&gt;</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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 14 April 2011 23:47:06 GMT