[html5] r4846 - [ac] (0) Cover more possible misuses for hidden=''. Anyone got good suggestions [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2010-03-12 16:37:06 -0800 (Fri, 12 Mar 2010)
New Revision: 4846

Modified:
   complete.html
   index
   source
Log:
[ac] (0) 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...

Modified: complete.html
===================================================================
--- complete.html	2010-03-13 00:05:35 UTC (rev 4845)
+++ complete.html	2010-03-13 00:37:06 UTC (rev 4846)
@@ -60318,8 +60318,32 @@
   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>
+  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
@@ -90501,7 +90525,7 @@
   Aaron Leventhal,
   Adam Barth,
   Adam de Boor,
-  Adam Hepton
+  Adam Hepton,
   Adam Roben,
   Addison Phillips,
   Adele Peterson,

Modified: index
===================================================================
--- index	2010-03-13 00:05:35 UTC (rev 4845)
+++ index	2010-03-13 00:37:06 UTC (rev 4846)
@@ -60246,8 +60246,32 @@
   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>
+  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
@@ -84062,7 +84086,7 @@
   Aaron Leventhal,
   Adam Barth,
   Adam de Boor,
-  Adam Hepton
+  Adam Hepton,
   Adam Roben,
   Addison Phillips,
   Adele Peterson,

Modified: source
===================================================================
--- source	2010-03-13 00:05:35 UTC (rev 4845)
+++ source	2010-03-13 00:37:06 UTC (rev 4846)
@@ -68196,8 +68196,37 @@
   title="attr-hidden">hidden</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>
+  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">hidden</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">hidden</code>
+  should not link to or refer to elements that are <code
+  title="attr-hidden">hidden</code>.</p>
+
+  <div class="example">
+
+   <p>For example, it would be incorrect to use the <code
+   title="attr-hyperlink-href">href</code> attribute to link to a
+   section marked with the <code title="attr-hidden">hidden</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">hidden</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">hidden</code> attribute are still active,
   e.g. scripts and form controls in such sections still execute
@@ -101419,7 +101448,7 @@
   Aaron Leventhal,
   Adam Barth,
   Adam de Boor,
-  Adam Hepton
+  Adam Hepton,
   Adam Roben,
   Addison Phillips,
   Adele Peterson,