[html5] r6895 - [ac] (0) Tweak hidden='''s definition a bit to be more consistent with likely us [...]

whatwg at whatwg.org whatwg at whatwg.org
Fri Jan 13 14:11:11 PST 2012


Author: ianh
Date: 2012-01-13 14:11:10 -0800 (Fri, 13 Jan 2012)
New Revision: 6895

Modified:
   complete.html
   index
   source
Log:
[ac] (0) Tweak hidden='''s definition a bit to be more consistent with likely usage scenarios.
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2012-01-13 01:42:12 UTC (rev 6894)
+++ complete.html	2012-01-13 22:11:10 UTC (rev 6895)
@@ -70442,9 +70442,11 @@
 
   <p>All <a href=#html-elements>HTML elements</a> may have the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> content attribute set. The <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute is a <a href=#boolean-attribute>boolean
   attribute</a>. When specified on an element, it indicates that
-  the element is not yet, or is no longer, relevant. <span class=impl>User agents should not render elements that have the
-  <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute
-  specified.</span></p>
+  the element is not yet, or is no longer, directly relevant to the
+  page's current state, or that it is being used to declare content to
+  be reused by other parts of the page as opposed to being directly
+  accessed by the user. <span class=impl>User agents should not
+  render elements that have the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute specified.</span></p>
 
   <div class=example>
 
@@ -70485,9 +70487,15 @@
   <!-- 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>
+  <p>Elements that are not themselves <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> must not <a href=#hyperlink>hyperlink</a> to
+  elements that are <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code>. The <code title="">for</code> attributes of <code><a href=#the-label-element>label</a></code> and
+  <code><a href=#the-output-element>output</a></code> elements that are not themselves <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> must similarly not refer to
+  elements that are <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code>. In both
+  cases, such references would cause user confusion.</p>
 
+  <p>Elements and scripts may, however, refer to elements that are
+  <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> in other contexts.</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
@@ -70495,12 +70503,17 @@
    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>
+   <p>It would be fine, however, 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>. While hiding the descriptions
+   implies that they are not useful alone, they could be written in
+   such a way that they are useful in the specific context of being
+   referenced from the images that they describe.</p>
 
+   <p>Similarly, a <code><a href=#the-canvas-element>canvas</a></code> element with the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute could be used by a
+   scripted graphics engine as an off-screen buffer, and a form
+   control could refer to a hidden <code><a href=#the-form-element>form</a></code> element using its
+   <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute.</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,

Modified: index
===================================================================
--- index	2012-01-13 01:42:12 UTC (rev 6894)
+++ index	2012-01-13 22:11:10 UTC (rev 6895)
@@ -70442,9 +70442,11 @@
 
   <p>All <a href=#html-elements>HTML elements</a> may have the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> content attribute set. The <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute is a <a href=#boolean-attribute>boolean
   attribute</a>. When specified on an element, it indicates that
-  the element is not yet, or is no longer, relevant. <span class=impl>User agents should not render elements that have the
-  <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute
-  specified.</span></p>
+  the element is not yet, or is no longer, directly relevant to the
+  page's current state, or that it is being used to declare content to
+  be reused by other parts of the page as opposed to being directly
+  accessed by the user. <span class=impl>User agents should not
+  render elements that have the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute specified.</span></p>
 
   <div class=example>
 
@@ -70485,9 +70487,15 @@
   <!-- 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>
+  <p>Elements that are not themselves <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> must not <a href=#hyperlink>hyperlink</a> to
+  elements that are <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code>. The <code title="">for</code> attributes of <code><a href=#the-label-element>label</a></code> and
+  <code><a href=#the-output-element>output</a></code> elements that are not themselves <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> must similarly not refer to
+  elements that are <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code>. In both
+  cases, such references would cause user confusion.</p>
 
+  <p>Elements and scripts may, however, refer to elements that are
+  <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> in other contexts.</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
@@ -70495,12 +70503,17 @@
    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>
+   <p>It would be fine, however, 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>. While hiding the descriptions
+   implies that they are not useful alone, they could be written in
+   such a way that they are useful in the specific context of being
+   referenced from the images that they describe.</p>
 
+   <p>Similarly, a <code><a href=#the-canvas-element>canvas</a></code> element with the <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute could be used by a
+   scripted graphics engine as an off-screen buffer, and a form
+   control could refer to a hidden <code><a href=#the-form-element>form</a></code> element using its
+   <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute.</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,

Modified: source
===================================================================
--- source	2012-01-13 01:42:12 UTC (rev 6894)
+++ source	2012-01-13 22:11:10 UTC (rev 6895)
@@ -82362,10 +82362,12 @@
   title="attr-hidden">hidden</code> content attribute set. The <code
   title="attr-hidden">hidden</code> attribute is a <span>boolean
   attribute</span>. When specified on an element, it indicates that
-  the element is not yet, or is no longer, relevant. <span
-  class="impl">User agents should not render elements that have the
-  <code title="attr-hidden">hidden</code> attribute
-  specified.</span></p>
+  the element is not yet, or is no longer, directly relevant to the
+  page's current state, or that it is being used to declare content to
+  be reused by other parts of the page as opposed to being directly
+  accessed by the user. <span class="impl">User agents should not
+  render elements that have the <code
+  title="attr-hidden">hidden</code> attribute specified.</span></p>
 
   <div class="example">
 
@@ -82408,10 +82410,18 @@
   <!-- 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>
+  <p>Elements that are not themselves <code
+  title="attr-hidden">hidden</code> must not <span>hyperlink</span> to
+  elements that are <code title="attr-hidden">hidden</code>. The <code
+  title="">for</code> attributes of <code>label</code> and
+  <code>output</code> elements that are not themselves <code
+  title="attr-hidden">hidden</code> must similarly not refer to
+  elements that are <code title="attr-hidden">hidden</code>. In both
+  cases, such references would cause user confusion.</p>
 
+  <p>Elements and scripts may, however, refer to elements that are
+  <code title="attr-hidden">hidden</code> in other contexts.</p>
+
   <div class="example">
 
    <p>For example, it would be incorrect to use the <code
@@ -82420,14 +82430,20 @@
    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
+   <p>It would be fine, however, 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>
+   title="attr-hidden">hidden</code>. While hiding the descriptions
+   implies that they are not useful alone, they could be written in
+   such a way that they are useful in the specific context of being
+   referenced from the images that they describe.</p>
 
+   <p>Similarly, a <code>canvas</code> element with the <code
+   title="attr-hidden">hidden</code> attribute could be used by a
+   scripted graphics engine as an off-screen buffer, and a form
+   control could refer to a hidden <code>form</code> element using its
+   <code title="attr-fae-form">form</code> attribute.</p>
+
   </div>
 
   <p>Elements in a section hidden by the <code




More information about the Commit-Watchers mailing list