Skip to content

Commit

Permalink
[e] (0) Rephrase the :active prose to not suggest that the Selectors …
Browse files Browse the repository at this point in the history 
…spec is wrong.

git-svn-id: http://svn.whatwg.org/webapps@5897 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Feb 16, 2011
1 parent af26d79 commit c3b5adc
Show file tree
Hide file tree
Showing 3 changed files with 155 additions and 105 deletions.
75 changes: 45 additions & 30 deletions complete.html
View file
Expand Up @@ -52804,48 +52804,63 @@ <h4 id=pseudo-classes><span class=secno>4.14.2 </span>Pseudo-classes</h4>
<dd>

<p>The <code title=selector-active><a href=#selector-active>:active</a></code> pseudo-class
must match any element falling into one of the following
categories between the time the user begins to activate the
element and the time the user stops activating the element:</p>
is defined to match an element <q cite=http://dev.w3.org/csswg/selectors3/#the-user-action-pseudo-classes-hover-act>while
an element is <i>being activated</i> by the user</q>. For the
purposes of defining the <code title=selector-active><a href=#selector-active>:active</a></code> pseudo-class only, an HTML
user agent must consider an element as <i>being activated</i> if
it is:</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>
<ul><li>

<li><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>
<p>An element falling into one of the following categories
between the time the user begins to indicate an intent to
trigger the element's <a href=#activation-behavior>activation behavior</a> and
either the time the user stops indicating an intent to trigger
the element's <a href=#activation-behavior>activation behavior</a>, or the time the
element's <a href=#activation-behavior>activation behavior</a> has finished running,
which ever comes first:</p>

<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>
<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><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-area-element>area</a></code> elements that have an <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute</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 is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a>, <a href=#image-button-state title=attr-input-type-image>Image Button</a>, <a href=#reset-button-state title=attr-input-type-reset>Reset Button</a>, or <a href=#button-state title=attr-input-type-button>Button</a> state</li>
<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-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><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>elements that are <a href=#specially-focusable>specially focusable</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 is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a>, <a href=#image-button-state title=attr-input-type-image>Image Button</a>, <a href=#reset-button-state title=attr-input-type-reset>Reset Button</a>, or <a href=#button-state title=attr-input-type-button>Button</a> state</li>

</ul><p class=example>For example, if the user is using a keyboard to
push a <code><a href=#the-button-element>button</a></code> element by pressing the space bar, the
element would match this pseudo-class in between the time that the
element received the <code title=event-keydown>keydown</code>
event and the time the element received the <code title=event-keyup>keyup</code> event.</p>
<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>

<p>In addition, the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class must match any element that the user indicates using
a pointing device while that pointing device is in the "down"
state (e.g. for a mouse, between the time the mouse button is
pressed and the time it is depressed).</p>
<li>elements that are <a href=#specially-focusable>specially focusable</a></li>

<p class=note>This requirement is a <a href=#willful-violation>willful
violation</a> of the Selectors specification (which only allows
elements to match the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class when they are activated), motivated by a desire to be
compatible with legacy user agents. <a href=#refsSELECTORS>[SELECTORS]</a></p>
</ul><p class=example>For example, if the user is using a keyboard
to push a <code><a href=#the-button-element>button</a></code> element by pressing the space bar,
the element would match this pseudo-class in between the time
that the element received the <code title=event-keydown>keydown</code> event and the time the
element received the <code title=event-keyup>keyup</code>
event.</p>

<p>In addition, the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class must match any element that has an ancestor that
matches the the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class.</p>
</li>

</dd>
<li>

<p>An element that the user indicates using a pointing device
while that pointing device is in the "down" state (e.g. for a
mouse, between the time the mouse button is pressed and the time
it is depressed).</p>

</li>

<li>

<p>An element that has a descendant that is currently matching
the the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class.</p>

</li>

</ul></dd>


<dt><dfn id=selector-enabled title=selector-enabled><code>:enabled</code></dfn></dt>
Expand Down
75 changes: 45 additions & 30 deletions index
View file
Expand Up @@ -52787,48 +52787,63 @@ contradict people?
<dd>

<p>The <code title=selector-active><a href=#selector-active>:active</a></code> pseudo-class
must match any element falling into one of the following
categories between the time the user begins to activate the
element and the time the user stops activating the element:</p>
is defined to match an element <q cite=http://dev.w3.org/csswg/selectors3/#the-user-action-pseudo-classes-hover-act>while
an element is <i>being activated</i> by the user</q>. For the
purposes of defining the <code title=selector-active><a href=#selector-active>:active</a></code> pseudo-class only, an HTML
user agent must consider an element as <i>being activated</i> if
it is:</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>
<ul><li>

<li><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>
<p>An element falling into one of the following categories
between the time the user begins to indicate an intent to
trigger the element's <a href=#activation-behavior>activation behavior</a> and
either the time the user stops indicating an intent to trigger
the element's <a href=#activation-behavior>activation behavior</a>, or the time the
element's <a href=#activation-behavior>activation behavior</a> has finished running,
which ever comes first:</p>

<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>
<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><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-area-element>area</a></code> elements that have an <code title=attr-hyperlink-href><a href=#attr-hyperlink-href>href</a></code> attribute</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 is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a>, <a href=#image-button-state title=attr-input-type-image>Image Button</a>, <a href=#reset-button-state title=attr-input-type-reset>Reset Button</a>, or <a href=#button-state title=attr-input-type-button>Button</a> state</li>
<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-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><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>elements that are <a href=#specially-focusable>specially focusable</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 is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a>, <a href=#image-button-state title=attr-input-type-image>Image Button</a>, <a href=#reset-button-state title=attr-input-type-reset>Reset Button</a>, or <a href=#button-state title=attr-input-type-button>Button</a> state</li>

</ul><p class=example>For example, if the user is using a keyboard to
push a <code><a href=#the-button-element>button</a></code> element by pressing the space bar, the
element would match this pseudo-class in between the time that the
element received the <code title=event-keydown>keydown</code>
event and the time the element received the <code title=event-keyup>keyup</code> event.</p>
<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>

<p>In addition, the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class must match any element that the user indicates using
a pointing device while that pointing device is in the "down"
state (e.g. for a mouse, between the time the mouse button is
pressed and the time it is depressed).</p>
<li>elements that are <a href=#specially-focusable>specially focusable</a></li>

<p class=note>This requirement is a <a href=#willful-violation>willful
violation</a> of the Selectors specification (which only allows
elements to match the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class when they are activated), motivated by a desire to be
compatible with legacy user agents. <a href=#refsSELECTORS>[SELECTORS]</a></p>
</ul><p class=example>For example, if the user is using a keyboard
to push a <code><a href=#the-button-element>button</a></code> element by pressing the space bar,
the element would match this pseudo-class in between the time
that the element received the <code title=event-keydown>keydown</code> event and the time the
element received the <code title=event-keyup>keyup</code>
event.</p>

<p>In addition, the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class must match any element that has an ancestor that
matches the the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class.</p>
</li>

</dd>
<li>

<p>An element that the user indicates using a pointing device
while that pointing device is in the "down" state (e.g. for a
mouse, between the time the mouse button is pressed and the time
it is depressed).</p>

</li>

<li>

<p>An element that has a descendant that is currently matching
the the <code title=selector-active><a href=#selector-active>:active</a></code>
pseudo-class.</p>

</li>

</ul></dd>


<dt><dfn id=selector-enabled title=selector-enabled><code>:enabled</code></dfn></dt>
Expand Down
110 changes: 65 additions & 45 deletions source
View file
Expand Up @@ -59437,62 +59437,82 @@ contradict people?
<dd>

<p>The <code title="selector-active">:active</code> pseudo-class
must match any element falling into one of the following
categories between the time the user begins to activate the
element and the time the user stops activating the element:</p>
is defined to match an element <q
cite="http://dev.w3.org/csswg/selectors3/#the-user-action-pseudo-classes-hover-act">while
an element is <i>being activated</i> by the user</q>. For the
purposes of defining the <code
title="selector-active">:active</code> pseudo-class only, an HTML
user agent must consider an element as <i>being activated</i> if
it is:</p>

<ul>

<li><code>a</code> elements that have an <code
title="attr-hyperlink-href">href</code> attribute</li>
<li>

<li><code>area</code> elements that have an <code
title="attr-hyperlink-href">href</code> attribute</li>
<p>An element falling into one of the following categories
between the time the user begins to indicate an intent to
trigger the element's <span>activation behavior</span> and
either the time the user stops indicating an intent to trigger
the element's <span>activation behavior</span>, or the time the
element's <span>activation behavior</span> has finished running,
which ever comes first:</p>

<li><code>link</code> elements that have an <code
title="attr-link-href">href</code> attribute</li>
<ul>

<li><code>button</code> elements that are not <span
title="concept-fe-disabled">disabled</span></li>
<li><code>a</code> elements that have an <code
title="attr-hyperlink-href">href</code> attribute</li>

<li><code>input</code> elements whose <code
title="attr-input-type">type</code> attribute is in the <span
title="attr-input-type-submit">Submit Button</span>, <span
title="attr-input-type-image">Image Button</span>, <span
title="attr-input-type-reset">Reset Button</span>, or <span
title="attr-input-type-button">Button</span> state</li>
<li><code>area</code> elements that have an <code
title="attr-hyperlink-href">href</code> attribute</li>

<li><code>command</code> elements that do not have a <code
title="attr-command-disabled">disabled</code> attribute</li>
<li><code>link</code> elements that have an <code
title="attr-link-href">href</code> attribute</li>

<li>elements that are <span>specially focusable</span></li>
<li><code>button</code> elements that are not <span
title="concept-fe-disabled">disabled</span></li>

</ul>
<li><code>input</code> elements whose <code
title="attr-input-type">type</code> attribute is in the <span
title="attr-input-type-submit">Submit Button</span>, <span
title="attr-input-type-image">Image Button</span>, <span
title="attr-input-type-reset">Reset Button</span>, or <span
title="attr-input-type-button">Button</span> state</li>

<li><code>command</code> elements that do not have a <code
title="attr-command-disabled">disabled</code> attribute</li>

<p class="example">For example, if the user is using a keyboard to
push a <code>button</code> element by pressing the space bar, the
element would match this pseudo-class in between the time that the
element received the <code title="event-keydown">keydown</code>
event and the time the element received the <code
title="event-keyup">keyup</code> event.</p>

<p>In addition, the <code title="selector-active">:active</code>
pseudo-class must match any element that the user indicates using
a pointing device while that pointing device is in the "down"
state (e.g. for a mouse, between the time the mouse button is
pressed and the time it is depressed).</p>

<p class="note">This requirement is a <span>willful
violation</span> of the Selectors specification (which only allows
elements to match the <code title="selector-active">:active</code>
pseudo-class when they are activated), motivated by a desire to be
compatible with legacy user agents. <a
href="#refsSELECTORS">[SELECTORS]</a></p>

<p>In addition, the <code title="selector-active">:active</code>
pseudo-class must match any element that has an ancestor that
matches the the <code title="selector-active">:active</code>
pseudo-class.</p>
<li>elements that are <span>specially focusable</span></li>

</ul>

<p class="example">For example, if the user is using a keyboard
to push a <code>button</code> element by pressing the space bar,
the element would match this pseudo-class in between the time
that the element received the <code
title="event-keydown">keydown</code> event and the time the
element received the <code title="event-keyup">keyup</code>
event.</p>

</li>

<li>

<p>An element that the user indicates using a pointing device
while that pointing device is in the "down" state (e.g. for a
mouse, between the time the mouse button is pressed and the time
it is depressed).</p>

</li>

<li>

<p>An element that has a descendant that is currently matching
the the <code title="selector-active">:active</code>
pseudo-class.</p>

</li>

</ul>

</dd>

Expand Down

0 comments on commit c3b5adc

Please sign in to comment.