- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 13 Mar 2010 00:47:44 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec-author-view
In directory hutz:/tmp/cvs-serv20007
Modified Files:
Overview.html acknowledgements.html editing.html spec.html
Log Message:
Cover more possible misuses for hidden=''. Anyone got good suggestions of short examples where hidden='' is useful? All the examples I can think of are huge... (whatwg r4846)
[updated by splitter]
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/Overview.html,v
retrieving revision 1.774
retrieving revision 1.775
diff -u -d -r1.774 -r1.775
--- Overview.html 13 Mar 2010 00:07:03 -0000 1.774
+++ Overview.html 13 Mar 2010 00:47:40 -0000 1.775
@@ -306,7 +306,7 @@
</dl><p>This specification is available in the following formats:
<a href="spec.html">single page HTML</a>,
<a href="Overview.html">multipage HTML</a>.
-This is revision 1.3881.
+This is revision 1.3882.
</p>
<p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
© 2010 <a href="http://www.w3.org/"><abbr title="World Wide
Index: editing.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/editing.html,v
retrieving revision 1.574
retrieving revision 1.575
diff -u -d -r1.574 -r1.575
--- editing.html 4 Mar 2010 07:16:12 -0000 1.574
+++ editing.html 13 Mar 2010 00:47:41 -0000 1.575
@@ -329,7 +329,24 @@
presentation. For example, it is incorrect to use <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> to hide panels in a tabbed dialog,
because the tabbed interface is merely a kind of overflow
presentation — showing all the form controls in one big page
- with a scrollbar would be equivalent, and no less correct.</p><p>Elements in a section hidden by the <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> attribute are still active,
+ with a scrollbar would be equivalent, and no less correct. It is
+ similarly incorrect to use this attribute to hide content just from
+ one presentation — if something is marked <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code>, it is hidden from all
+ presentations, including, for instance, screen readers.</p><!-- for example, "<a hidden href=#content>Skip to content</a>" would be inappropriate. --><!-- (but only add that example if you first add some more good valid examples --><p>Elements that are not <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code>
+ should not link to or refer to elements that are <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code>.</p><div class="example">
+
+ <p>For example, it would be incorrect to use the <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code> attribute to link to a
+ section marked with the <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code>
+ attribute. If the content is not applicable or relevant, then there
+ is no reason to link to it.</p>
+
+ <p>It would similarly be incorrect to use the ARIA <code title="attr-aria-describedby">aria-describedby</code> attribute to
+ refer to descriptions that are themselves <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code>. Hiding a section means that it
+ is not applicable or relevant to anyone at the current time, so
+ clearly it cannot be a valid description of content the user can
+ interact with.</p>
+
+ </div><p>Elements in a section hidden by the <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> attribute are still active,
e.g. scripts and form controls in such sections still execute
and submit respectively. Only their presentation to the user
changes.</p><h3 id="activation"><span class="secno">7.2 </span>Activation</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2 idea: HTMLImageElement.click(x, y); or clickPoint(), if
Index: spec.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/spec.html,v
retrieving revision 1.780
retrieving revision 1.781
diff -u -d -r1.780 -r1.781
--- spec.html 13 Mar 2010 00:07:03 -0000 1.780
+++ spec.html 13 Mar 2010 00:47:41 -0000 1.781
@@ -304,7 +304,7 @@
</dl><p>This specification is available in the following formats:
<a href=spec.html>single page HTML</a>,
<a href=Overview.html>multipage HTML</a>.
-This is revision 1.3881.
+This is revision 1.3882.
</p>
<p class=copyright><a href=http://www.w3.org/Consortium/Legal/ipr-notice#Copyright>Copyright</a>
© 2010 <a href=http://www.w3.org/><abbr title="World Wide
@@ -23264,7 +23264,24 @@
presentation. For example, it is incorrect to use <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> to hide panels in a tabbed dialog,
because the tabbed interface is merely a kind of overflow
presentation — showing all the form controls in one big page
- with a scrollbar would be equivalent, and no less correct.</p><p>Elements in a section hidden by the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute are still active,
+ with a scrollbar would be equivalent, and no less correct. It is
+ similarly incorrect to use this attribute to hide content just from
+ one presentation — if something is marked <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code>, it is hidden from all
+ presentations, including, for instance, screen readers.</p><!-- for example, "<a hidden href=#content>Skip to content</a>" would be inappropriate. --><!-- (but only add that example if you first add some more good valid examples --><p>Elements that are not <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code>
+ should not link to or refer to elements that are <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code>.</p><div class=example>
+
+ <p>For example, it would be incorrect to use the <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute to link to a
+ section marked with the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code>
+ attribute. If the content is not applicable or relevant, then there
+ is no reason to link to it.</p>
+
+ <p>It would similarly be incorrect to use the ARIA <code title=attr-aria-describedby>aria-describedby</code> attribute to
+ refer to descriptions that are themselves <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code>. Hiding a section means that it
+ is not applicable or relevant to anyone at the current time, so
+ clearly it cannot be a valid description of content the user can
+ interact with.</p>
+
+ </div><p>Elements in a section hidden by the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute are still active,
e.g. scripts and form controls in such sections still execute
and submit respectively. Only their presentation to the user
changes.</p><h3 id=activation><span class=secno>7.2 </span>Activation</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2 idea: HTMLImageElement.click(x, y); or clickPoint(), if
@@ -29221,7 +29238,7 @@
Aaron Leventhal,
Adam Barth,
Adam de Boor,
- Adam Hepton
+ Adam Hepton,
Adam Roben,
Addison Phillips,
Adele Peterson,
Index: acknowledgements.html
===================================================================
RCS file: /sources/public/html5/spec-author-view/acknowledgements.html,v
retrieving revision 1.586
retrieving revision 1.587
diff -u -d -r1.586 -r1.587
--- acknowledgements.html 13 Mar 2010 00:07:03 -0000 1.586
+++ acknowledgements.html 13 Mar 2010 00:47:41 -0000 1.587
@@ -297,7 +297,7 @@
Aaron Leventhal,
Adam Barth,
Adam de Boor,
- Adam Hepton
+ Adam Hepton,
Adam Roben,
Addison Phillips,
Adele Peterson,
Received on Saturday, 13 March 2010 00:47:46 UTC