Skip to content

Commit

Permalink
[ac] (0) Tweak hidden='''s definition a bit to be more consistent wit…
Browse files Browse the repository at this point in the history
…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 ad0f7ba
Show file tree
Hide file tree
Showing 3 changed files with 74 additions and 32 deletions.
33 changes: 23 additions & 10 deletions complete.html
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down Expand Up @@ -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>

Expand All @@ -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>

Expand Down
33 changes: 23 additions & 10 deletions index
Original file line number Diff line number Diff line change
Expand Up @@ -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>

Expand Down Expand Up @@ -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>

Expand All @@ -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>

Expand Down
40 changes: 28 additions & 12 deletions source
Original file line number Diff line number Diff line change
Expand Up @@ -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">

Expand Down Expand Up @@ -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">

Expand All @@ -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>

Expand Down

0 comments on commit ad0f7ba

Please sign in to comment.