[ac] (0) Cover more possible misuses for hidden=''. Anyone got good s…

…uggestions of short examples where hidden='' is useful? All the examples I can think of are huge... git-svn-id: http://svn.whatwg.org/webapps@4846 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Mar 13, 2010 · 05c4fe5 · 05c4fe5
1 parent 492f028
commit 05c4fe5
Show file tree

Hide file tree

Showing 3 changed files with 83 additions and 6 deletions.
diff --git a/complete.html b/complete.html
@@ -60318,7 +60318,31 @@ <h3 id=the-hidden-attribute><span class=secno>8.1 </span>The <dfn title=attr-hid
   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 &mdash; 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 &mdash; 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
@@ -90501,7 +90525,7 @@ <h3 class="no-num">Reflecting IDL attributes</h3>
   Aaron Leventhal,
   Adam Barth,
   Adam de Boor,
-  Adam Hepton
+  Adam Hepton,
   Adam Roben,
   Addison Phillips,
   Adele Peterson,

diff --git a/index b/index
@@ -60246,7 +60246,31 @@ interface <dfn id=navigatorabilities>NavigatorAbilities</dfn> {
   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 &mdash; 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 &mdash; 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
@@ -84062,7 +84086,7 @@ interface <a href=#htmldocument>HTMLDocument</a> {
   Aaron Leventhal,
   Adam Barth,
   Adam de Boor,
-  Adam Hepton
+  Adam Hepton,
   Adam Roben,
   Addison Phillips,
   Adele Peterson,

diff --git a/source b/source
@@ -68196,7 +68196,36 @@ interface <dfn>NavigatorAbilities</dfn> {
   title="attr-hidden">hidden</code> to hide panels in a tabbed dialog,
   because the tabbed interface is merely a kind of overflow
   presentation &mdash; 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 &mdash; 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,
@@ -101419,7 +101448,7 @@ interface <span>HTMLDocument</span> {
   Aaron Leventhal,
   Adam Barth,
   Adam de Boor,
-  Adam Hepton
+  Adam Hepton,
   Adam Roben,
   Addison Phillips,
   Adele Peterson,