html5/spec Overview.html,1.1974,1.1975

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

Modified Files:
	Overview.html 
Log Message:
Handle elements losing focus when they are hidden, etc. (whatwg r2804)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1974
retrieving revision 1.1975
diff -u -d -r1.1974 -r1.1975
--- Overview.html	13 Feb 2009 01:06:20 -0000	1.1974
+++ Overview.html	13 Feb 2009 01:09:40 -0000	1.1975
@@ -35870,7 +35870,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>
 
@@ -35921,7 +35922,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>
 
@@ -45439,13 +45441,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
@@ -45454,6 +45454,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,
@@ -45513,9 +45551,17 @@
 
   </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>

Received on Friday, 13 February 2009 01:09:51 UTC