Permalink
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...
Hixie committed Jan 13, 2012
1 parent e61cd8f commit ad0f7ba57801e708ceb75a3c01365af00c601664
Showing with 74 additions and 32 deletions.
  1. +23 −10 complete.html
  2. +23 −10 index
  3. +28 −12 source

<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>

<!-- 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>

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>

33 index

<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>

<!-- 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>

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>

40 source
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">

<!-- 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">

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.