[html5] r7600 - [giow] (0) Until we have more concrete implementation experience, make the whole [...]
whatwg at whatwg.org
whatwg at whatwg.org
Thu Dec 27 14:56:06 PST 2012
Author: ianh
Date: 2012-12-27 14:56:05 -0800 (Thu, 27 Dec 2012)
New Revision: 7600
Modified:
complete.html
index
source
Log:
[giow] (0) Until we have more concrete implementation experience, make the whole <th> of a sortable table interactive.
Affected topics: HTML, Rendering
Modified: complete.html
===================================================================
--- complete.html 2012-12-27 22:46:05 UTC (rev 7599)
+++ complete.html 2012-12-27 22:56:05 UTC (rev 7600)
@@ -42642,11 +42642,12 @@
<h4 id=the-th-element><span class=secno>4.9.10 </span>The <dfn><code>th</code></dfn> element</h4>
<dl class=element><dt><a href=#element-dfn-categories title=element-dfn-categories>Categories</a>:</dt>
- <dd>None.</dd>
+ <dd>If the <code><a href=#the-th-element>th</a></code> element is a <a href=#sorting-interface-th-element>sorting interface <code>th</code> element</a>: <a href=#interactive-content>Interactive content</a>.</dd>
+ <dd>Otherwise: None.</dd>
<dt><a href=#element-dfn-contexts title=element-dfn-contexts>Contexts in which this element can be used</a>:</dt>
<dd>As a child of a <code><a href=#the-tr-element>tr</a></code> element.</dd>
<dt><a href=#element-dfn-content-model title=element-dfn-content-model>Content model</a>:</dt>
- <dd><a href=#flow-content>Flow content</a>, but with no <code><a href=#the-header-element>header</a></code>, <code><a href=#the-footer-element>footer</a></code>, <a href=#sectioning-content>sectioning content</a>, or <a href=#heading-content>heading content</a> descendants.</dd>
+ <dd><a href=#flow-content>Flow content</a>, but with no <code><a href=#the-header-element>header</a></code>, <code><a href=#the-footer-element>footer</a></code>, <a href=#sectioning-content>sectioning content</a>, or <a href=#heading-content>heading content</a> descendants, and if the <code><a href=#the-th-element>th</a></code> element is a <a href=#sorting-interface-th-element>sorting interface <code>th</code> element</a>, no <a href=#interactive-content>interactive content</a> descendants.</dd>
<!-- EDITING NOTE: If you remove 'heading content' from the list above, make sure to fix the definition of 'sectioning root' to include <th> -->
<dt><a href=#element-dfn-attributes title=element-dfn-attributes>Content attributes</a>:</dt>
<dd><a href=#global-attributes>Global attributes</a></dd>
@@ -43973,7 +43974,11 @@
sorting interface</dfn> if it is a <a href=#sorting-capable-table-element>sorting-capable <code>table</code> element</a> and has
a <code title=attr-table-sortable><a href=#attr-table-sortable>sortable</a></code> attribute specified.</p>
- <p>Each <code><a href=#the-table-element>table</a></code> element has a <dfn id=currently-sorting-flag>currently-sorting flag</dfn>, which must initially
+ <p>A <dfn id=sorting-interface-th-element>sorting interface <code>th</code> element</dfn> is a <a href=#sorting-capable-th-element>sorting-capable
+ <code>th</code> element</a> whose <a href=#concept-cell title=concept-cell>cell</a>'s <a href=#concept-table title=concept-table>table</a> is a <a href=#table-element-with-a-user-agent-exposed-sorting-interface><code>table</code> element with a user-agent exposed
+ sorting interface</a>.</p>
+
+ <hr><p>Each <code><a href=#the-table-element>table</a></code> element has a <dfn id=currently-sorting-flag>currently-sorting flag</dfn>, which must initially
be false.</p>
<hr><p>The <code title=attr-th-sorted><a href=#attr-th-sorted>sorted</a></code> attribute must not be specified on
@@ -44485,10 +44490,8 @@
<li><p>Set <var title="">target</var>'s <code title=attr-th-sorted><a href=#attr-th-sorted>sorted</a></code> attribute to
the empty string.</li>
- </ol><hr><p>The <a href=#activation-behavior>activation behavior</a> of the <a href=#sorting-capable-th-elements-of-the-table-element title="sorting-capable th elements of the
- table element">sorting-capable <code>th</code> elements of</a> all <a href=#table-element-with-a-user-agent-exposed-sorting-interface title="table element
- with a user-agent exposed sorting interface"><code>table</code> elements with a user-agent exposed
- sorting interface</a> is to <a href=#set-the-sort-key>set the sort key</a> to the <code><a href=#the-th-element>th</a></code> element.</p>
+ </ol><hr><p>The <a href=#activation-behavior>activation behavior</a> of a <a href=#sorting-interface-th-element>sorting interface <code>th</code>
+ element</a> is to <a href=#set-the-sort-key>set the sort key</a> to the <code><a href=#the-th-element>th</a></code> element.</p>
<p class=note>The <code><a href=#the-table-element>table</a></code> will be sorted the next time the user agent <a href=#perform-a-microtask-checkpoint title="perform a microtask checkpoint">performs a microtask checkpoint</a>.</p>
@@ -77073,6 +77076,9 @@
<li><a href=#browsing-context-container title="browsing context container">Browsing context
containers</a></li> <!-- like <iframe>s -->
+ <li><a href=#sorting-interface-th-element title="sorting interface th element">Sorting interface <code>th</code>
+ elements</a></li>
+
</ul><p class=note>One valid reason to ignore the platform
conventions and always allow an element to be focused (by setting
its <a href=#specially-focusable>tabindex focus flag</a>) would be if the user's only
@@ -97205,11 +97211,9 @@
<!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1793 -->
<!-- note that the "rules for parsing dimension values" can't return 0, if the value is "0" they treat it as an error -->
- <hr><p id=sortable-ui>User agents are expected to render <a href=#sorting-capable-th-elements-of-the-table-element title="sorting-capable th elements of
- the table element">sorting-capable <code>th</code> elements of</a> all <a href=#table-element-with-a-user-agent-exposed-sorting-interface title="table
- element with a user-agent exposed sorting interface"><code>table</code> elements with a user-agent
- exposed sorting interface</a> in such a manner as to indicate that activating the elements will
- cause the table to be sorted.</p>
+ <hr><p id=sortable-ui>User agents are expected to render <a href=#sorting-interface-th-element title="sorting interface th
+ element">sorting interface <code>th</code> elements</a> in such a manner as to indicate that
+ activating the elements will cause the table to be sorted.</p>
<h4 id=form-controls><span class=secno>14.3.10 </span>Form controls</h4>
Modified: index
===================================================================
--- index 2012-12-27 22:46:05 UTC (rev 7599)
+++ index 2012-12-27 22:56:05 UTC (rev 7600)
@@ -42642,11 +42642,12 @@
<h4 id=the-th-element><span class=secno>4.9.10 </span>The <dfn><code>th</code></dfn> element</h4>
<dl class=element><dt><a href=#element-dfn-categories title=element-dfn-categories>Categories</a>:</dt>
- <dd>None.</dd>
+ <dd>If the <code><a href=#the-th-element>th</a></code> element is a <a href=#sorting-interface-th-element>sorting interface <code>th</code> element</a>: <a href=#interactive-content>Interactive content</a>.</dd>
+ <dd>Otherwise: None.</dd>
<dt><a href=#element-dfn-contexts title=element-dfn-contexts>Contexts in which this element can be used</a>:</dt>
<dd>As a child of a <code><a href=#the-tr-element>tr</a></code> element.</dd>
<dt><a href=#element-dfn-content-model title=element-dfn-content-model>Content model</a>:</dt>
- <dd><a href=#flow-content>Flow content</a>, but with no <code><a href=#the-header-element>header</a></code>, <code><a href=#the-footer-element>footer</a></code>, <a href=#sectioning-content>sectioning content</a>, or <a href=#heading-content>heading content</a> descendants.</dd>
+ <dd><a href=#flow-content>Flow content</a>, but with no <code><a href=#the-header-element>header</a></code>, <code><a href=#the-footer-element>footer</a></code>, <a href=#sectioning-content>sectioning content</a>, or <a href=#heading-content>heading content</a> descendants, and if the <code><a href=#the-th-element>th</a></code> element is a <a href=#sorting-interface-th-element>sorting interface <code>th</code> element</a>, no <a href=#interactive-content>interactive content</a> descendants.</dd>
<!-- EDITING NOTE: If you remove 'heading content' from the list above, make sure to fix the definition of 'sectioning root' to include <th> -->
<dt><a href=#element-dfn-attributes title=element-dfn-attributes>Content attributes</a>:</dt>
<dd><a href=#global-attributes>Global attributes</a></dd>
@@ -43973,7 +43974,11 @@
sorting interface</dfn> if it is a <a href=#sorting-capable-table-element>sorting-capable <code>table</code> element</a> and has
a <code title=attr-table-sortable><a href=#attr-table-sortable>sortable</a></code> attribute specified.</p>
- <p>Each <code><a href=#the-table-element>table</a></code> element has a <dfn id=currently-sorting-flag>currently-sorting flag</dfn>, which must initially
+ <p>A <dfn id=sorting-interface-th-element>sorting interface <code>th</code> element</dfn> is a <a href=#sorting-capable-th-element>sorting-capable
+ <code>th</code> element</a> whose <a href=#concept-cell title=concept-cell>cell</a>'s <a href=#concept-table title=concept-table>table</a> is a <a href=#table-element-with-a-user-agent-exposed-sorting-interface><code>table</code> element with a user-agent exposed
+ sorting interface</a>.</p>
+
+ <hr><p>Each <code><a href=#the-table-element>table</a></code> element has a <dfn id=currently-sorting-flag>currently-sorting flag</dfn>, which must initially
be false.</p>
<hr><p>The <code title=attr-th-sorted><a href=#attr-th-sorted>sorted</a></code> attribute must not be specified on
@@ -44485,10 +44490,8 @@
<li><p>Set <var title="">target</var>'s <code title=attr-th-sorted><a href=#attr-th-sorted>sorted</a></code> attribute to
the empty string.</li>
- </ol><hr><p>The <a href=#activation-behavior>activation behavior</a> of the <a href=#sorting-capable-th-elements-of-the-table-element title="sorting-capable th elements of the
- table element">sorting-capable <code>th</code> elements of</a> all <a href=#table-element-with-a-user-agent-exposed-sorting-interface title="table element
- with a user-agent exposed sorting interface"><code>table</code> elements with a user-agent exposed
- sorting interface</a> is to <a href=#set-the-sort-key>set the sort key</a> to the <code><a href=#the-th-element>th</a></code> element.</p>
+ </ol><hr><p>The <a href=#activation-behavior>activation behavior</a> of a <a href=#sorting-interface-th-element>sorting interface <code>th</code>
+ element</a> is to <a href=#set-the-sort-key>set the sort key</a> to the <code><a href=#the-th-element>th</a></code> element.</p>
<p class=note>The <code><a href=#the-table-element>table</a></code> will be sorted the next time the user agent <a href=#perform-a-microtask-checkpoint title="perform a microtask checkpoint">performs a microtask checkpoint</a>.</p>
@@ -77073,6 +77076,9 @@
<li><a href=#browsing-context-container title="browsing context container">Browsing context
containers</a></li> <!-- like <iframe>s -->
+ <li><a href=#sorting-interface-th-element title="sorting interface th element">Sorting interface <code>th</code>
+ elements</a></li>
+
</ul><p class=note>One valid reason to ignore the platform
conventions and always allow an element to be focused (by setting
its <a href=#specially-focusable>tabindex focus flag</a>) would be if the user's only
@@ -97205,11 +97211,9 @@
<!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/1793 -->
<!-- note that the "rules for parsing dimension values" can't return 0, if the value is "0" they treat it as an error -->
- <hr><p id=sortable-ui>User agents are expected to render <a href=#sorting-capable-th-elements-of-the-table-element title="sorting-capable th elements of
- the table element">sorting-capable <code>th</code> elements of</a> all <a href=#table-element-with-a-user-agent-exposed-sorting-interface title="table
- element with a user-agent exposed sorting interface"><code>table</code> elements with a user-agent
- exposed sorting interface</a> in such a manner as to indicate that activating the elements will
- cause the table to be sorted.</p>
+ <hr><p id=sortable-ui>User agents are expected to render <a href=#sorting-interface-th-element title="sorting interface th
+ element">sorting interface <code>th</code> elements</a> in such a manner as to indicate that
+ activating the elements will cause the table to be sorted.</p>
<h4 id=form-controls><span class=secno>14.3.10 </span>Form controls</h4>
Modified: source
===================================================================
--- source 2012-12-27 22:46:05 UTC (rev 7599)
+++ source 2012-12-27 22:56:05 UTC (rev 7600)
@@ -49816,11 +49816,12 @@
<dl class="element">
<dt><span title="element-dfn-categories">Categories</span>:</dt>
- <dd>None.</dd>
+ <dd>If the <code>th</code> element is a <span>sorting interface <code>th</code> element</span>: <span>Interactive content</span>.</dd>
+ <dd>Otherwise: None.</dd>
<dt><span title="element-dfn-contexts">Contexts in which this element can be used</span>:</dt>
<dd>As a child of a <code>tr</code> element.</dd>
<dt><span title="element-dfn-content-model">Content model</span>:</dt>
- <dd><span>Flow content</span>, but with no <code>header</code>, <code>footer</code>, <span>sectioning content</span>, or <span>heading content</span> descendants.</dd>
+ <dd><span>Flow content</span>, but with no <code>header</code>, <code>footer</code>, <span>sectioning content</span>, or <span>heading content</span> descendants, and if the <code>th</code> element is a <span>sorting interface <code>th</code> element</span>, no <span>interactive content</span> descendants.</dd>
<!-- EDITING NOTE: If you remove 'heading content' from the list above, make sure to fix the definition of 'sectioning root' to include <th> -->
<dt><span title="element-dfn-attributes">Content attributes</span>:</dt>
<dd><span>Global attributes</span></dd>
@@ -51474,6 +51475,13 @@
sorting interface</dfn> if it is a <span>sorting-capable <code>table</code> element</span> and has
a <code title="attr-table-sortable">sortable</code> attribute specified.</p>
+ <p>A <dfn>sorting interface <code>th</code> element</dfn> is a <span>sorting-capable
+ <code>th</code> element</span> whose <span title="concept-cell">cell</span>'s <span
+ title="concept-table">table</span> is a <span><code>table</code> element with a user-agent exposed
+ sorting interface</span>.</p>
+
+ <hr>
+
<p>Each <code>table</code> element has a <dfn>currently-sorting flag</dfn>, which must initially
be false.</p>
@@ -52077,10 +52085,8 @@
<hr>
- <p>The <span>activation behavior</span> of the <span title="sorting-capable th elements of the
- table element">sorting-capable <code>th</code> elements of</span> all <span title="table element
- with a user-agent exposed sorting interface"><code>table</code> elements with a user-agent exposed
- sorting interface</span> is to <span>set the sort key</span> to the <code>th</code> element.</p>
+ <p>The <span>activation behavior</span> of a <span>sorting interface <code>th</code>
+ element</span> is to <span>set the sort key</span> to the <code>th</code> element.</p>
<p class="note">The <code>table</code> will be sorted the next time the user agent <span
title="perform a microtask checkpoint">performs a microtask checkpoint</span>.</p>
@@ -90054,6 +90060,9 @@
<li><span title="browsing context container">Browsing context
containers</span></li> <!-- like <iframe>s -->
+ <li><span title="sorting interface th element">Sorting interface <code>th</code>
+ elements</span></li>
+
</ul>
<p class="note">One valid reason to ignore the platform
@@ -112392,11 +112401,9 @@
<hr>
- <p id="sortable-ui">User agents are expected to render <span title="sorting-capable th elements of
- the table element">sorting-capable <code>th</code> elements of</span> all <span title="table
- element with a user-agent exposed sorting interface"><code>table</code> elements with a user-agent
- exposed sorting interface</span> in such a manner as to indicate that activating the elements will
- cause the table to be sorted.</p>
+ <p id="sortable-ui">User agents are expected to render <span title="sorting interface th
+ element">sorting interface <code>th</code> elements</span> in such a manner as to indicate that
+ activating the elements will cause the table to be sorted.</p>
<h4>Form controls</h4>
More information about the Commit-Watchers
mailing list