[html5] r7477 - [acgiowt] (1) Spec <th abbr>. Fixing https://www.w3.org/Bugs/Public/show_bug.cgi [...]

whatwg at whatwg.org whatwg at whatwg.org
Fri Oct 19 15:23:06 PDT 2012


Author: ianh
Date: 2012-10-19 15:23:04 -0700 (Fri, 19 Oct 2012)
New Revision: 7477

Modified:
   complete.html
   index
   source
Log:
[acgiowt] (1) Spec <th abbr>.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=17970
Affected topics: DOM APIs, HTML

Modified: complete.html
===================================================================
--- complete.html	2012-10-19 21:23:25 UTC (rev 7476)
+++ complete.html	2012-10-19 22:23:04 UTC (rev 7477)
@@ -44117,6 +44117,14 @@
   <p>The <code><a href=#the-td-element>td</a></code> element and its <code title=attr-tdth-colspan><a href=#attr-tdth-colspan>colspan</a></code>, <code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code>, and <code title=attr-tdth-headers><a href=#attr-tdth-headers>headers</a></code> attributes take part in the
   <a href=#table-model>table model</a>.</p>
 
+  <p>User agents, especially in non-visual environments or where displaying the table as a 2D grid
+  is impractical, may give the user context for the cell when rendering the contents of a cell; for
+  instance, giving its position in the <a href=#table-model>table model</a>, or listing the cell's header cells
+  (as determined by the <a href=#algorithm-for-assigning-header-cells>algorithm for assigning header cells</a>). When a cell's header
+  cells are being listed, user agents may use the value of <code title=attr-th-abbr><a href=#attr-th-abbr>abbr</a></code>
+  attributes on those header cells, if any, instead of the contents of the header cells
+  themselves.</p>
+
   </div>
 
 
@@ -44135,10 +44143,12 @@
    <dd><code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code></dd>
    <dd><code title=attr-tdth-headers><a href=#attr-tdth-headers>headers</a></code></dd>
    <dd><code title=attr-th-scope><a href=#attr-th-scope>scope</a></code></dd>
+   <dd><code title=attr-th-abbr><a href=#attr-th-abbr>abbr</a></code></dd>
    <dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
    <dd>
     <pre class=idl>interface <dfn id=htmltableheadercellelement>HTMLTableHeaderCellElement</dfn> : <a href=#htmltablecellelement>HTMLTableCellElement</a> {
            attribute DOMString <a href=#dom-th-scope title=dom-th-scope>scope</a>;
+           attribute DOMString <a href=#dom-th-abbr title=dom-th-abbr>abbr</a>;
 };</pre>
    </dd>
   </dl><!--TOPIC:HTML--><p>The <code><a href=#the-th-element>th</a></code> element <a href=#represents>represents</a> a header <a href=#concept-cell title=concept-cell>cell</a> in a table.</p>
@@ -44186,6 +44196,12 @@
   </dl><p>The <code title=attr-th-scope><a href=#attr-th-scope>scope</a></code> attribute's
   <i>missing value default</i> is the <i>auto</i> state.</p>
 
+  <p>The <code><a href=#the-th-element>th</a></code> element may have an <dfn id=attr-th-abbr title=attr-th-abbr><code>abbr</code></dfn>
+  content attribute specified. Its value must be an alternative label for the header cell, to be
+  used when referencing the cell in other contexts (e.g. when describing the header cells that apply
+  to a data cell). It is typically an abbreviated form of the full header cell, but can also be an
+  expansion, or merely a different phrasing.</p>
+
   <div class=impl>
 
   <p>The <code><a href=#the-th-element>th</a></code> element and its <code title=attr-tdth-colspan><a href=#attr-tdth-colspan>colspan</a></code>, <code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code>, <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 take part in the
@@ -44195,6 +44211,9 @@
   attribute must <a href=#reflect>reflect</a> the content attribute of the
   same name, <a href=#limited-to-only-known-values>limited to only known values</a>.</p>
 
+  <p>The <dfn id=dom-th-abbr title=dom-th-abbr><code>abbr</code></dfn> IDL attribute must <a href=#reflect>reflect</a>
+  the content attribute of the same name.</p>
+
   </div>
 
   <div class=example>
@@ -103292,7 +103311,8 @@
          <code title=attr-tdth-colspan><a href=#attr-tdth-colspan>colspan</a></code>;
          <code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code>;
          <code title=attr-tdth-headers><a href=#attr-tdth-headers>headers</a></code>;
-         <code title=attr-th-scope><a href=#attr-th-scope>scope</a></code></td>
+         <code title=attr-th-scope><a href=#attr-th-scope>scope</a></code></td>;
+         <code title=attr-th-abbr><a href=#attr-th-abbr>abbr</a></code>
      <td><code><a href=#htmltableheadercellelement>HTMLTableHeaderCellElement</a></code></td>
     <tr><th><code><a href=#the-thead-element>thead</a></code></th>
      <td>Group of heading rows in a table</td>
@@ -103794,7 +103814,11 @@
      <th> Element(s)
      <th> Description
      <th> Value
-   <tbody><tr><th> <code title="">accept</code>
+   <tbody><tr><th> <code title="">abbr</code>
+     <td> <code title=attr-th-abbr><a href=#attr-th-abbr>th</a></code>
+     <td> Alternative label to use for the header cell when referencing the cell in other contexts
+     <td> <a href=#attribute-text>Text</a>*
+    <tr><th> <code title="">accept</code>
      <td> <code title=attr-input-accept><a href=#attr-input-accept>input</a></code>
      <td> Hint for expected file type in <a href="#file-upload-state-(type=file)" title=attr-input-type-file>file upload controls</a>
      <td> <a href=#set-of-comma-separated-tokens>Set of comma-separated tokens</a>* consisting of <a href=#valid-mime-type title="valid MIME type">valid MIME types with no parameters</a> or <code title="">audio/*</code>, <code title="">video/*</code>, or <code title="">image/*</code>

Modified: index
===================================================================
--- index	2012-10-19 21:23:25 UTC (rev 7476)
+++ index	2012-10-19 22:23:04 UTC (rev 7477)
@@ -44117,6 +44117,14 @@
   <p>The <code><a href=#the-td-element>td</a></code> element and its <code title=attr-tdth-colspan><a href=#attr-tdth-colspan>colspan</a></code>, <code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code>, and <code title=attr-tdth-headers><a href=#attr-tdth-headers>headers</a></code> attributes take part in the
   <a href=#table-model>table model</a>.</p>
 
+  <p>User agents, especially in non-visual environments or where displaying the table as a 2D grid
+  is impractical, may give the user context for the cell when rendering the contents of a cell; for
+  instance, giving its position in the <a href=#table-model>table model</a>, or listing the cell's header cells
+  (as determined by the <a href=#algorithm-for-assigning-header-cells>algorithm for assigning header cells</a>). When a cell's header
+  cells are being listed, user agents may use the value of <code title=attr-th-abbr><a href=#attr-th-abbr>abbr</a></code>
+  attributes on those header cells, if any, instead of the contents of the header cells
+  themselves.</p>
+
   </div>
 
 
@@ -44135,10 +44143,12 @@
    <dd><code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code></dd>
    <dd><code title=attr-tdth-headers><a href=#attr-tdth-headers>headers</a></code></dd>
    <dd><code title=attr-th-scope><a href=#attr-th-scope>scope</a></code></dd>
+   <dd><code title=attr-th-abbr><a href=#attr-th-abbr>abbr</a></code></dd>
    <dt><a href=#element-dfn-dom title=element-dfn-dom>DOM interface</a>:</dt><!--TOPIC:DOM APIs-->
    <dd>
     <pre class=idl>interface <dfn id=htmltableheadercellelement>HTMLTableHeaderCellElement</dfn> : <a href=#htmltablecellelement>HTMLTableCellElement</a> {
            attribute DOMString <a href=#dom-th-scope title=dom-th-scope>scope</a>;
+           attribute DOMString <a href=#dom-th-abbr title=dom-th-abbr>abbr</a>;
 };</pre>
    </dd>
   </dl><!--TOPIC:HTML--><p>The <code><a href=#the-th-element>th</a></code> element <a href=#represents>represents</a> a header <a href=#concept-cell title=concept-cell>cell</a> in a table.</p>
@@ -44186,6 +44196,12 @@
   </dl><p>The <code title=attr-th-scope><a href=#attr-th-scope>scope</a></code> attribute's
   <i>missing value default</i> is the <i>auto</i> state.</p>
 
+  <p>The <code><a href=#the-th-element>th</a></code> element may have an <dfn id=attr-th-abbr title=attr-th-abbr><code>abbr</code></dfn>
+  content attribute specified. Its value must be an alternative label for the header cell, to be
+  used when referencing the cell in other contexts (e.g. when describing the header cells that apply
+  to a data cell). It is typically an abbreviated form of the full header cell, but can also be an
+  expansion, or merely a different phrasing.</p>
+
   <div class=impl>
 
   <p>The <code><a href=#the-th-element>th</a></code> element and its <code title=attr-tdth-colspan><a href=#attr-tdth-colspan>colspan</a></code>, <code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code>, <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 take part in the
@@ -44195,6 +44211,9 @@
   attribute must <a href=#reflect>reflect</a> the content attribute of the
   same name, <a href=#limited-to-only-known-values>limited to only known values</a>.</p>
 
+  <p>The <dfn id=dom-th-abbr title=dom-th-abbr><code>abbr</code></dfn> IDL attribute must <a href=#reflect>reflect</a>
+  the content attribute of the same name.</p>
+
   </div>
 
   <div class=example>
@@ -103292,7 +103311,8 @@
          <code title=attr-tdth-colspan><a href=#attr-tdth-colspan>colspan</a></code>;
          <code title=attr-tdth-rowspan><a href=#attr-tdth-rowspan>rowspan</a></code>;
          <code title=attr-tdth-headers><a href=#attr-tdth-headers>headers</a></code>;
-         <code title=attr-th-scope><a href=#attr-th-scope>scope</a></code></td>
+         <code title=attr-th-scope><a href=#attr-th-scope>scope</a></code></td>;
+         <code title=attr-th-abbr><a href=#attr-th-abbr>abbr</a></code>
      <td><code><a href=#htmltableheadercellelement>HTMLTableHeaderCellElement</a></code></td>
     <tr><th><code><a href=#the-thead-element>thead</a></code></th>
      <td>Group of heading rows in a table</td>
@@ -103794,7 +103814,11 @@
      <th> Element(s)
      <th> Description
      <th> Value
-   <tbody><tr><th> <code title="">accept</code>
+   <tbody><tr><th> <code title="">abbr</code>
+     <td> <code title=attr-th-abbr><a href=#attr-th-abbr>th</a></code>
+     <td> Alternative label to use for the header cell when referencing the cell in other contexts
+     <td> <a href=#attribute-text>Text</a>*
+    <tr><th> <code title="">accept</code>
      <td> <code title=attr-input-accept><a href=#attr-input-accept>input</a></code>
      <td> Hint for expected file type in <a href="#file-upload-state-(type=file)" title=attr-input-type-file>file upload controls</a>
      <td> <a href=#set-of-comma-separated-tokens>Set of comma-separated tokens</a>* consisting of <a href=#valid-mime-type title="valid MIME type">valid MIME types with no parameters</a> or <code title="">audio/*</code>, <code title="">video/*</code>, or <code title="">image/*</code>

Modified: source
===================================================================
--- source	2012-10-19 21:23:25 UTC (rev 7476)
+++ source	2012-10-19 22:23:04 UTC (rev 7477)
@@ -51577,6 +51577,14 @@
   title="attr-tdth-headers">headers</code> attributes take part in the
   <span>table model</span>.</p>
 
+  <p>User agents, especially in non-visual environments or where displaying the table as a 2D grid
+  is impractical, may give the user context for the cell when rendering the contents of a cell; for
+  instance, giving its position in the <span>table model</span>, or listing the cell's header cells
+  (as determined by the <span>algorithm for assigning header cells</span>). When a cell's header
+  cells are being listed, user agents may use the value of <code title="attr-th-abbr">abbr</code>
+  attributes on those header cells, if any, instead of the contents of the header cells
+  themselves.</p>
+
   </div>
 
 
@@ -51596,10 +51604,12 @@
    <dd><code title="attr-tdth-rowspan">rowspan</code></dd>
    <dd><code title="attr-tdth-headers">headers</code></dd>
    <dd><code title="attr-th-scope">scope</code></dd>
+   <dd><code title="attr-th-abbr">abbr</code></dd>
    <dt><span title="element-dfn-dom">DOM interface</span>:</dt><!--TOPIC:DOM APIs-->
    <dd>
     <pre class="idl">interface <dfn>HTMLTableHeaderCellElement</dfn> : <span>HTMLTableCellElement</span> {
            attribute DOMString <span title="dom-th-scope">scope</span>;
+           attribute DOMString <span title="dom-th-abbr">abbr</span>;
 };</pre>
    </dd>
   </dl><!--TOPIC:HTML-->
@@ -51659,6 +51669,12 @@
   <p>The <code title="attr-th-scope">scope</code> attribute's
   <i>missing value default</i> is the <i>auto</i> state.</p>
 
+  <p>The <code>th</code> element may have an <dfn title="attr-th-abbr"><code>abbr</code></dfn>
+  content attribute specified. Its value must be an alternative label for the header cell, to be
+  used when referencing the cell in other contexts (e.g. when describing the header cells that apply
+  to a data cell). It is typically an abbreviated form of the full header cell, but can also be an
+  expansion, or merely a different phrasing.</p>
+
   <div class="impl">
 
   <p>The <code>th</code> element and its <code
@@ -51672,6 +51688,9 @@
   attribute must <span>reflect</span> the content attribute of the
   same name, <span>limited to only known values</span>.</p>
 
+  <p>The <dfn title="dom-th-abbr"><code>abbr</code></dfn> IDL attribute must <span>reflect</span>
+  the content attribute of the same name.</p>
+
   </div>
 
   <div class="example">
@@ -120943,7 +120962,8 @@
          <code title="attr-tdth-colspan">colspan</code>;
          <code title="attr-tdth-rowspan">rowspan</code>;
          <code title="attr-tdth-headers">headers</code>;
-         <code title="attr-th-scope">scope</code></td>
+         <code title="attr-th-scope">scope</code></td>;
+         <code title="attr-th-abbr">abbr</code></td>
      <td><code>HTMLTableHeaderCellElement</code></td>
     </tr>
 
@@ -121505,6 +121525,11 @@
      <th> Value
    <tbody>
     <tr>
+     <th> <code title="">abbr</code>
+     <td> <code title="attr-th-abbr">th</code>
+     <td> Alternative label to use for the header cell when referencing the cell in other contexts
+     <td> <a href="#attribute-text">Text</a>*
+    <tr>
      <th> <code title="">accept</code>
      <td> <code title="attr-input-accept">input</code>
      <td> Hint for expected file type in <span title="attr-input-type-file">file upload controls</span>




More information about the Commit-Watchers mailing list