Browse files

[ac] (0) Tweak hidden='''s definition a bit to be more consistent wit…

…h likely usage scenarios.

Affected topics: HTML

git-svn-id: http://svn.whatwg.org/webapps@6895 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent e61cd8f commit ad0f7ba57801e708ceb75a3c01365af00c601664 @Hixie Hixie committed Jan 13, 2012
Showing with 74 additions and 32 deletions.
  1. +23 −10 complete.html
  2. +23 −10 index
  3. +28 −12 source
View
33 complete.html
@@ -70442,9 +70442,11 @@ <h3 id=the-hidden-attribute><span class=secno>8.1 </span>The <dfn title=attr-hid
<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,8 +70487,14 @@ <h3 id=the-hidden-attribute><span class=secno>8.1 </span>The <dfn title=attr-hid
<!-- 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>
@@ -70495,11 +70503,16 @@ <h3 id=the-hidden-attribute><span class=secno>8.1 </span>The <dfn title=attr-hid
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>
View
33 index
@@ -70442,9 +70442,11 @@ interface <dfn id=navigatorstorageutils>NavigatorStorageUtils</dfn> {
<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,8 +70487,14 @@ interface <dfn id=navigatorstorageutils>NavigatorStorageUtils</dfn> {
<!-- 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>
@@ -70495,11 +70503,16 @@ interface <dfn id=navigatorstorageutils>NavigatorStorageUtils</dfn> {
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>
View
40 source
@@ -82362,10 +82362,12 @@ interface <dfn>NavigatorStorageUtils</dfn> {
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,9 +82410,17 @@ interface <dfn>NavigatorStorageUtils</dfn> {
<!-- 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">
@@ -82420,13 +82430,19 @@ interface <dfn>NavigatorStorageUtils</dfn> {
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>

0 comments on commit ad0f7ba

Please sign in to comment.