[html5] r2804 - [] (0) Handle elements losing focus when they are hidden, etc.

whatwg at whatwg.org whatwg at whatwg.org
Thu Feb 12 17:09:35 PST 2009


Author: ianh
Date: 2009-02-12 17:09:34 -0800 (Thu, 12 Feb 2009)
New Revision: 2804

Modified:
   index
   source
Log:
[] (0) Handle elements losing focus when they are hidden, etc.

Modified: index
===================================================================
--- index	2009-02-13 01:06:13 UTC (rev 2803)
+++ index	2009-02-13 01:09:34 UTC (rev 2804)
@@ -35875,7 +35875,8 @@
 
      <li><code><a href=#the-command>command</a></code> elements that do not have a <code title=attr-command-disabled><a href=#attr-command-disabled>disabled</a></code> attribute</li>
 
-     <li>any other element, if it is <a href=#focusable>focusable</a></li>
+     <li>any other element, if it is <a href=#specially-focusable>specially
+     focusable</a></li>
 
     </ul>
 
@@ -35926,7 +35927,8 @@
      first such element's <a href=#command-facet-disabledstate title=command-facet-disabledstate>Disabled State</a> facet
      is false (not disabled)</li>
 
-     <li>any other element, if it is <a href=#focusable>focusable</a></li>
+     <li>any other element, if it is <a href=#specially-focusable>specially
+     focusable</a></li>
 
     </ul>
 
@@ -45444,13 +45446,11 @@
 
   </dl>
 
-  <p>An element is <dfn id=focusable>focusable</dfn> if the <code title=attr-tabindex><a href=#attr-tabindex>tabindex</a></code> attribute's definition above
-  defines the element to be focusable <em>and</em> the element is
-  <span>being rendered</span><!-- XXX xref, define display:none as not
-  being rendered, off-screen as being rendered? -->.</p>
+  <p>An element is <dfn id=specially-focusable>specially focusable</dfn> if the <code title=attr-tabindex><a href=#attr-tabindex>tabindex</a></code> attribute's definition above
+  defines the element to be focusable.</p>
 
-  <p>An element that is <a href=#focusable>focusable</a> but does not otherwise
-  have an <a href=#activation-behavior>activation behavior</a> defined has an
+  <p>An element that is <a href=#specially-focusable>specially focusable</a> but does not
+  otherwise have an <a href=#activation-behavior>activation behavior</a> defined has an
   <a href=#activation-behavior>activation behavior</a> that does nothing.</p>
 
   <p class=note>This means that an element that is only focusable
@@ -45459,6 +45459,44 @@
   to a non-mouse activation (e.g. hitting the "enter" key while the
   element is focused).</p>
 
+  <p>An element is <dfn id=focusable>focusable</dfn> if the user agent's default
+  behavior allows it to be focusable or if the element is
+  <a href=#specially-focusable>specially focusable</a>, but only if the element is
+  <span>being rendered</span><!-- XXX xref, define display:none,
+  orphan nodes as not being rendered, off-screen as being rendered?
+  -->.</p>
+
+  <p>User agents should make the following elements
+  <a href=#focusable>focusable</a>, unless platform conventions dictate
+  otherwise:</p>
+
+  <ul>
+
+   <li><code><a href=#the-a-element>a</a></code> elements that have an <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute</li>
+
+   <li class=XXX><code><a href=#the-area-element>area</a></code> elements that have an <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute</li> <!-- should
+   define the behavior in the face of multiple images and in the face
+   of no images -->
+
+   <li><code><a href=#the-link-element>link</a></code> elements that have an <code title=attr-link-href><a href=#attr-link-href>href</a></code> attribute</li>
+
+   <li><code><a href=#the-bb-element>bb</a></code> elements whose <code title=attr-bb-type><a href=#attr-bb-type>type</a></code> attribute is in a state whose
+   <i>relevance</i> is true</li>
+
+   <li><code><a href=#the-button-element>button</a></code> elements that are not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a></li>
+
+   <li><code><a href=#the-input-element>input</a></code> elements whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute are not in the
+   <a href=#hidden-state title=attr-input-type-hidden>Hidden</a> state and that
+   are not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a></li>
+
+   <li><code><a href=#the-select-element>select</a></code> elements that are not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a></li>
+
+   <li><code><a href=#the-textarea-element>textarea</a></code> elements that are not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a></li>
+
+   <li><code><a href=#the-command>command</a></code> elements that do not have a <code title=attr-command-disabled><a href=#attr-command-disabled>disabled</a></code> attribute</li>
+
+  </ul>
+
   <p>The <dfn id=dom-tabindex title=dom-tabIndex><code>tabIndex</code></dfn> DOM
   attribute must <a href=#reflect>reflect</a> the value of the <code title=attr-tabindex><a href=#attr-tabindex>tabindex</a></code> content attribute. If the
   attribute is not present, or parsing its value returns an error,
@@ -45518,11 +45556,19 @@
 
   </ol>
 
-  <p>User agents should run the <a href=#unfocusing-steps>unfocusing steps</a> for an
-  element whenever the user moves the focus away from any
-  <a href=#focusable>focusable</a> element.</p>
+  <p>When the user moves the focus away from a <a href=#focusable>focusable</a>
+  element, the user agent should run the <a href=#unfocusing-steps>unfocusing steps</a>
+  that element.</p>
 
+  <p>When an element that is focused stops being a
+  <a href=#focusable>focusable</a> element, the user agent should run the
+  <a href=#unfocusing-steps>unfocusing steps</a> that element.</p>
 
+  <p class=example>For example, this might happen because the
+  element is removed from its <code>Document</code>, or has a <code title=attr-hidden><a href=#the-hidden-attribute>hidden</a></code> attribute added. It would also
+  happen to an <code><a href=#the-input-element>input</a></code> element when the element gets <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>.</p>
+
+
   <h4 id=document-level-focus-apis><span class=secno>6.5.3 </span>Document-level focus APIs</h4>
 
   <p>The <dfn id=dom-document-activeelement title=dom-document-activeElement><code>activeElement</code></dfn>

Modified: source
===================================================================
--- source	2009-02-13 01:06:13 UTC (rev 2803)
+++ source	2009-02-13 01:09:34 UTC (rev 2804)
@@ -38255,7 +38255,8 @@
      <li><code>command</code> elements that do not have a <code
      title="attr-command-disabled">disabled</code> attribute</li>
 
-     <li>any other element, if it is <span>focusable</span></li>
+     <li>any other element, if it is <span>specially
+     focusable</span></li>
 
     </ul>
 
@@ -38318,7 +38319,8 @@
      title="command-facet-disabledstate">Disabled State</span> facet
      is false (not disabled)</li>
 
-     <li>any other element, if it is <span>focusable</span></li>
+     <li>any other element, if it is <span>specially
+     focusable</span></li>
 
     </ul>
 
@@ -48613,14 +48615,12 @@
 
   </dl>
 
-  <p>An element is <dfn>focusable</dfn> if the <code
+  <p>An element is <dfn>specially focusable</dfn> if the <code
   title="attr-tabindex">tabindex</code> attribute's definition above
-  defines the element to be focusable <em>and</em> the element is
-  <span>being rendered</span><!-- XXX xref, define display:none as not
-  being rendered, off-screen as being rendered? -->.</p>
+  defines the element to be focusable.</p>
 
-  <p>An element that is <span>focusable</span> but does not otherwise
-  have an <span>activation behavior</span> defined has an
+  <p>An element that is <span>specially focusable</span> but does not
+  otherwise have an <span>activation behavior</span> defined has an
   <span>activation behavior</span> that does nothing.</p>
 
   <p class="note">This means that an element that is only focusable
@@ -48629,6 +48629,53 @@
   to a non-mouse activation (e.g. hitting the "enter" key while the
   element is focused).</p>
 
+  <p>An element is <dfn>focusable</dfn> if the user agent's default
+  behavior allows it to be focusable or if the element is
+  <span>specially focusable</span>, but only if the element is
+  <span>being rendered</span><!-- XXX xref, define display:none,
+  orphan nodes as not being rendered, off-screen as being rendered?
+  -->.</p>
+
+  <p>User agents should make the following elements
+  <span>focusable</span>, unless platform conventions dictate
+  otherwise:</p>
+
+  <ul>
+
+   <li><code>a</code> elements that have an <code
+   title="attr-hyperlink-href">href</code> attribute</li>
+
+   <li class="XXX"><code>area</code> elements that have an <code
+   title="attr-hyperlink-href">href</code> attribute</li> <!-- should
+   define the behavior in the face of multiple images and in the face
+   of no images -->
+
+   <li><code>link</code> elements that have an <code
+   title="attr-link-href">href</code> attribute</li>
+
+   <li><code>bb</code> elements whose <code
+   title="attr-bb-type">type</code> attribute is in a state whose
+   <i>relevance</i> is true</li>
+
+   <li><code>button</code> elements that are not <span
+   title="concept-fe-disabled">disabled</span></li>
+
+   <li><code>input</code> elements whose <code
+   title="attr-input-type">type</code> attribute are not in the
+   <span title="attr-input-type-hidden">Hidden</span> state and that
+   are not <span title="concept-fe-disabled">disabled</span></li>
+
+   <li><code>select</code> elements that are not <span
+   title="concept-fe-disabled">disabled</span></li>
+
+   <li><code>textarea</code> elements that are not <span
+   title="concept-fe-disabled">disabled</span></li>
+
+   <li><code>command</code> elements that do not have a <code
+   title="attr-command-disabled">disabled</code> attribute</li>
+
+  </ul>
+
   <p>The <dfn title="dom-tabIndex"><code>tabIndex</code></dfn> DOM
   attribute must <span>reflect</span> the value of the <code
   title="attr-tabindex">tabindex</code> content attribute. If the
@@ -48693,11 +48740,21 @@
 
   </ol>
 
-  <p>User agents should run the <span>unfocusing steps</span> for an
-  element whenever the user moves the focus away from any
-  <span>focusable</span> element.</p>
+  <p>When the user moves the focus away from a <span>focusable</span>
+  element, the user agent should run the <span>unfocusing steps</span>
+  that element.</p>
 
+  <p>When an element that is focused stops being a
+  <span>focusable</span> element, the user agent should run the
+  <span>unfocusing steps</span> that element.</p>
 
+  <p class="example">For example, this might happen because the
+  element is removed from its <code>Document</code>, or has a <code
+  title="attr-hidden">hidden</code> attribute added. It would also
+  happen to an <code>input</code> element when the element gets <span
+  title="concept-fe-disabled">disabled</span>.</p>
+
+
   <h4>Document-level focus APIs</h4>
 
   <p>The <dfn




More information about the Commit-Watchers mailing list