[acgiowt] (1) Spec <th abbr>.

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=17970 Affected topics: DOM APIs, HTML git-svn-id: http://svn.whatwg.org/webapps@7477 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Oct 19, 2012 · 9a9e4c0 · 9a9e4c0
1 parent a8821f6
commit 9a9e4c0
Show file tree

Hide file tree

Showing 3 changed files with 78 additions and 5 deletions.
diff --git a/complete.html b/complete.html
@@ -44117,6 +44117,14 @@ <h4 id=the-td-element><span class=secno>4.9.9 </span>The <dfn><code>td</code></d
   <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 @@ <h4 id=the-th-element><span class=secno>4.9.10 </span>The <dfn><code>th</code></
    <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 @@ <h4 id=the-th-element><span class=secno>4.9.10 </span>The <dfn><code>th</code></
   </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 @@ <h4 id=the-th-element><span class=secno>4.9.10 </span>The <dfn><code>th</code></
   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 @@ <h3 class=no-num id=elements-1>Elements</h3>
          <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 @@ <h3 class=no-num id=element-content-categories>Element content categories</h3>
      <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>

diff --git a/index b/index
@@ -44117,6 +44117,14 @@ the cell that corresponds to the values of the two dice.
   <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 @@ the cell that corresponds to the values of the two dice.
    <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 @@ the cell that corresponds to the values of the two dice.
   </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 @@ the cell that corresponds to the values of the two dice.
   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 @@ if (s = prompt('What is your name?')) {
          <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 @@ if (s = prompt('What is your name?')) {
      <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>

diff --git a/source b/source
@@ -51577,6 +51577,14 @@ the cell that corresponds to the values of the two dice.
   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 @@ the cell that corresponds to the values of the two dice.
    <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 @@ the cell that corresponds to the values of the two dice.
   <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 @@ the cell that corresponds to the values of the two dice.
   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 @@ if (s = prompt('What is your name?')) {
          <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>
 
@@ -121504,6 +121524,11 @@ if (s = prompt('What is your name?')) {
      <th> Description
      <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>