- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 08 Feb 2012 23:00:00 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv30385
Modified Files:
Overview.html
Log Message:
Apply W3C chair revert request (to W3C copy only). Fix markup typo. (whatwg r6980)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5574
retrieving revision 1.5575
diff -u -d -r1.5574 -r1.5575
--- Overview.html 8 Feb 2012 00:31:26 -0000 1.5574
+++ Overview.html 8 Feb 2012 22:59:57 -0000 1.5575
@@ -9468,11 +9468,11 @@
element's <code title="attr-translate"><a href="#attr-translate">translate</a></code> attribute is
in the <i>no</i> state, then the element's <a href="#translation-mode">translation
mode</a> is in the <a href="#no-translate">no-translate</a> state. Otherwise,
- the element's code title="attr-translate">translate attribute
- is in the <i>inherit</i> state; in that case, the element's
- <a href="#translation-mode">translation mode</a> is in the same state as its parent
- element, if any, or in the <a href="#translate-enabled">translate-enabled</a> state, if
- the element is a <a href="#root-element">root element</a>.<p>When an element is in the <dfn id="translate-enabled">translate-enabled</dfn> state, the
+ the element's <code title="attr-translate"><a href="#attr-translate">translate</a></code>
+ attribute is in the <i>inherit</i> state; in that case, the
+ element's <a href="#translation-mode">translation mode</a> is in the same state as its
+ parent element, if any, or in the <a href="#translate-enabled">translate-enabled</a>
+ state, if the element is a <a href="#root-element">root element</a>.<p>When an element is in the <dfn id="translate-enabled">translate-enabled</dfn> state, the
element's attribute values and the values of its <code><a href="#text">Text</a></code>
node children are to be translated when the page is localized.<p>When an element is in the <dfn id="no-translate">no-translate</dfn> state, the
element's attribute values and the values of its <code><a href="#text">Text</a></code>
@@ -54512,12 +54512,17 @@
<li><p>Return 1.</li>
</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, 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">
+ 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">
<p>In the following skeletal example, the attribute is used to hide
the Web game's main screen until the user logs in:</p>
@@ -54549,28 +54554,22 @@
controls in one big page with a scrollbar. It is similarly incorrect
to use this attribute to hide content just from one presentation
— 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 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">
+ 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">
<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 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>
+ <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>
+
+
</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 Wednesday, 8 February 2012 23:00:06 UTC