html5/spec Overview.html,1.5492,1.5493

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv4531

Modified Files:
	Overview.html 
Log Message:
Tweak hidden='''s definition a bit to be more consistent with likely usage scenarios. (whatwg r6895)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5492
retrieving revision 1.5493
diff -u -d -r1.5492 -r1.5493
--- Overview.html	13 Jan 2012 01:42:16 -0000	1.5492
+++ Overview.html	13 Jan 2012 22:11:16 -0000	1.5493
@@ -54247,9 +54247,11 @@
 
    </ol></div><h2 id="editing"><span class="secno">7 </span><dfn>User interaction</dfn></h2><h3 id="the-hidden-attribute"><span class="secno">7.1 </span>The <dfn title="attr-hidden"><code>hidden</code></dfn> attribute</h3><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><div class="example">
+  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><div class="example">
 
    <p>In the following skeletal example, the attribute is used to hide
    the Web game's main screen until the user logs in:</p>
@@ -54281,19 +54283,28 @@
   controls in one big page with a scrollbar. 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><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>.<div class="example">
+  presentations, including, for instance, screen readers.</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>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.<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>
+   <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,
   e.g. scripts and form controls in such sections still execute

Received on Friday, 13 January 2012 22:11:26 UTC