W3C home > Mailing lists > Public > public-html-commits@w3.org > August 2012

html5/spec Overview.html,1.5699,1.5700 editing.html,1.1224,1.1225 spec.html,1.1944,1.1945

From: Sam Ruby via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 22 Aug 2012 23:13:51 +0000
To: public-html-commits@w3.org
Message-Id: <E1T4K7T-0000pd-Hm@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv3141

Modified Files:
	Overview.html editing.html spec.html 
Log Message:
commit 29724e48d39024f3294c748fc222a584fe0a8742
Author: Edward O'Connor <hober0@gmail.com>
Date:   Wed Aug 22 15:54:32 2012 -0700

    [ISSUE-204] Apply Working Group decision.


Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5699
retrieving revision 1.5700
diff -u -d -r1.5699 -r1.5700
--- Overview.html	22 Aug 2012 22:14:26 -0000	1.5699
+++ Overview.html	22 Aug 2012 23:13:47 -0000	1.5700
@@ -67898,17 +67898,12 @@
   <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></p>
-
+  attribute</a>. When specified on an element, it indicates that
+  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>
 
@@ -67949,10 +67944,14 @@
   <!-- 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 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 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 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>
 
@@ -67961,13 +67960,16 @@
    attribute. If the content is not applicable or relevant, then there
    is no reason to link to it.</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>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>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>
 
@@ -67984,6 +67986,14 @@
 
   </div>
 
+  <p>User Agents are encouraged to expose the full semantics of <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> elements to Assistive Technology
+  when such elements are referenced from WAI-ARIA attributes such as
+  <code title=attr-aria-describedby>aria-describedby</code>. However,
+  because historically some User Agents have flattened hidden content
+  when exposing such content to Assistive Technology, authors SHOULD NOT
+  reference hidden content which would lose essential meaning when
+  flattened.</p>
+
 
 
   <h3 id=inert-subtrees><span class=secno>7.2 </span>Inert subtrees</h3>

Index: editing.html
===================================================================
RCS file: /sources/public/html5/spec/editing.html,v
retrieving revision 1.1224
retrieving revision 1.1225
diff -u -d -r1.1224 -r1.1225
--- editing.html	22 Aug 2012 10:52:40 -0000	1.1224
+++ editing.html	22 Aug 2012 23:13:49 -0000	1.1225
@@ -344,17 +344,12 @@
   <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="infrastructure.html#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="common-microsyntaxes.html#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>
-
+  attribute</a>. When specified on an element, it indicates that
+  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">
 
@@ -395,10 +390,14 @@
   <!-- 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 themselves <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> must not <a href="links.html#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.html#the-label-element">label</a></code> and
+  <code><a href="the-output-element.html#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 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 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">
 
@@ -407,13 +406,16 @@
    attribute. If the content is not applicable or relevant, then there
    is no reason to link to it.</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>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>Similarly, a <code><a href="the-canvas-element.html#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.html#the-form-element">form</a></code> element using its
+   <code title="attr-fae-form"><a href="association-of-controls-and-forms.html#attr-fae-form">form</a></code> attribute.</p>
 
   </div>
 
@@ -430,6 +432,14 @@
 
   </div>
 
+  <p>User Agents are encouraged to expose the full semantics of <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> elements to Assistive Technology
+  when such elements are referenced from WAI-ARIA attributes such as
+  <code title="attr-aria-describedby">aria-describedby</code>. However,
+  because historically some User Agents have flattened hidden content
+  when exposing such content to Assistive Technology, authors SHOULD NOT
+  reference hidden content which would lose essential meaning when
+  flattened.</p>
+
 
 
   <h3 id="inert-subtrees"><span class="secno">7.2 </span>Inert subtrees</h3>
Received on Wednesday, 22 August 2012 23:14:07 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 22 August 2012 23:14:08 GMT