Skip to content

/html

Permalink
Browse files

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

git-svn-id: http://svn.whatwg.org/webapps@2804 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
@Hixie
Hixie committed Feb 13, 2009
1 parent 3429247 commit 457f1d52094a7e53579d3814aeb3e5b0ed8525d7
Unified Split
Showing with 125 additions and 22 deletions.
  1. +57 −11 index
  2. +68 −11 source
68 index
View file

<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>

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>


</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
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,

</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>
79 source
View file
<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>

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>


</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
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

</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>

0 comments on commit 457f1d5

Please sign in to comment.
You can’t perform that action at this time.