[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