[html5] r7004 - [giow] (2) Fix 'activation behavior' definitions for form controls so that .clic [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue Feb 21 16:34:32 PST 2012
Author: ianh
Date: 2012-02-21 16:34:31 -0800 (Tue, 21 Feb 2012)
New Revision: 7004
Modified:
complete.html
index
source
Log:
[giow] (2) Fix 'activation behavior' definitions for form controls so that .click() doesn't do anything on them if they're disabled; fix definition of default submit buttons so that they are more predictable; unhide some v2COMMAND text that is now applicable again
Affected topics: HTML
Modified: complete.html
===================================================================
--- complete.html 2012-02-21 20:57:10 UTC (rev 7003)
+++ complete.html 2012-02-22 00:34:31 UTC (rev 7004)
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 21 February 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 22 February 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -46299,6 +46299,9 @@
cancelable. Once this fires, the control is checked, end of story.
--></p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p><strong>Constraint validation</strong>: If the element is <i title=concept-input-required><a href=#concept-input-required>required</a></i> and its <a href=#concept-fe-checked title=concept-fe-checked>checkedness</a> is false, then the
element is <a href=#suffering-from-being-missing>suffering from being missing</a>.</p>
@@ -46436,6 +46439,9 @@
cancelable. Once this fires, the control is checked, end of story.
-->.</p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p><strong>Constraint validation</strong>: If an element in the
<i><a href=#radio-button-group>radio button group</a></i> is <i title=concept-input-required><a href=#concept-input-required>required</a></i>, and all of the
<code><a href=#the-input-element>input</a></code> elements in the <i><a href=#radio-button-group>radio button group</a></i> have a
@@ -46724,12 +46730,13 @@
<div class=impl>
<p>If the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>,
- the user agent should allow the user to activate the element.</p>
+ then the element's <a href=#activation-behavior>activation behavior</a> is as follows:
+ if the element has a <a href=#form-owner>form owner</a>, <a href=#concept-form-submit title=concept-form-submit>submit</a> the <a href=#form-owner>form
+ owner</a> from the <code><a href=#the-input-element>input</a></code> element; otherwise, do
+ nothing.</p>
- <p>The element's <a href=#activation-behavior>activation behavior</a>, if the element
- has a <a href=#form-owner>form owner</a>, is to <a href=#concept-form-submit title=concept-form-submit>submit</a> the <a href=#form-owner>form
- owner</a> from the <code><a href=#the-input-element>input</a></code> element; otherwise, it is
- to do nothing.</p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
</div>
@@ -46903,24 +46910,29 @@
element <a href=#represents>represents</a> a control for selecting a <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a> from
the image specified by the <code title=attr-input-src><a href=#attr-input-src>src</a></code>
attribute; if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>, the user agent should
- allow the user to select this <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a>. The
- <a href=#activation-behavior>activation behavior</a> in this case consists of taking the
- user's selected <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a>, and
- then, if the element has a <a href=#form-owner>form owner</a>, <a href=#concept-form-submit title=concept-form-submit>submitting</a> the <code><a href=#the-input-element>input</a></code>
- element's <a href=#form-owner>form owner</a> from the <code><a href=#the-input-element>input</a></code>
- element. If the user activates the control without explicitly
- selecting a coordinate, then the coordinate (0,0) must be
- assumed.</p>
+ allow the user to select this <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a>, and
+ the element's <a href=#activation-behavior>activation behavior</a> is as follows: if the
+ element has a <a href=#form-owner>form owner</a>, take the user's selected
+ <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a>,
+ and <a href=#concept-form-submit title=concept-form-submit>submit</a> the
+ <code><a href=#the-input-element>input</a></code> element's <a href=#form-owner>form owner</a> from the
+ <code><a href=#the-input-element>input</a></code> element. If the user activates the control
+ without explicitly selecting a coordinate, then the coordinate (0,0)
+ must be assumed.</p>
<p>Otherwise, the element <a href=#represents>represents</a> a submit button
- whose label is given by the value of the <code title=attr-input-alt><a href=#attr-input-alt>alt</a></code> attribute; if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>, the user agent should
- allow the user to activate the button. The <a href=#activation-behavior>activation
- behavior</a> in this case consists of setting the <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected
- coordinate</a> to (0,0), and then, if the element has a
- <a href=#form-owner>form owner</a>, <a href=#concept-form-submit title=concept-form-submit>submitting</a> the <code><a href=#the-input-element>input</a></code>
+ whose label is given by the value of the <code title=attr-input-alt><a href=#attr-input-alt>alt</a></code> attribute; if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>, then the element's
+ <a href=#activation-behavior>activation behavior</a> is as follows: if the element has a
+ <a href=#form-owner>form owner</a>, set the <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected
+ coordinate</a> to (0,0), and <a href=#concept-form-submit title=concept-form-submit>submit</a> the <code><a href=#the-input-element>input</a></code>
element's <a href=#form-owner>form owner</a> from the <code><a href=#the-input-element>input</a></code>
element.</p>
+ <p>In either case, if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i> but has no <a href=#form-owner>form
+ owner</a>, then its <a href=#activation-behavior>activation behavior</a> must be to
+ do nothing. If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p>The <dfn id=concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected
coordinate</dfn> must consist of an <var title="">x</var>-component
and a <var title="">y</var>-component. The coordinates represent the
@@ -47067,12 +47079,13 @@
<div class=impl>
<p>If the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>,
- the user agent should allow the user to activate the element.</p>
-
- <p>The element's <a href=#activation-behavior>activation behavior</a>, if the element
+ then the element's <a href=#activation-behavior>activation behavior</a>, if the element
has a <a href=#form-owner>form owner</a>, is to <a href=#concept-form-reset title=concept-form-reset>reset</a> the <a href=#form-owner>form owner</a>;
otherwise, it is to do nothing.</p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p><strong>Constraint validation</strong>: The element is
<a href=#barred-from-constraint-validation>barred from constraint validation</a>.</p>
@@ -47150,9 +47163,11 @@
<div class=impl>
<p>If the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>,
- the user agent should allow the user to activate the element. The
- element's <a href=#activation-behavior>activation behavior</a> is to do nothing.</p>
+ the element's <a href=#activation-behavior>activation behavior</a> is to do nothing.</p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p><strong>Constraint validation</strong>: The element is
<a href=#barred-from-constraint-validation>barred from constraint validation</a>.</p>
@@ -48433,9 +48448,7 @@
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
- </dl><!--TOPIC:HTML--><p>The <code><a href=#the-button-element>button</a></code> element <a href=#represents>represents</a> a
- button. <span class=impl>If the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent
- should allow the user to activate the button.</span></p>
+ </dl><!--TOPIC:HTML--><p>The <code><a href=#the-button-element>button</a></code> element <a href=#represents>represents</a> a button.</p>
<p>The element is a <a href=#concept-button title=concept-button>button</a>.</p>
@@ -48471,10 +48484,9 @@
the <a href=#attr-button-type-button-state title=attr-button-type-button-state>Button</a> state,
the element is <a href=#barred-from-constraint-validation>barred from constraint validation</a>.</p>
- <p>If the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, the <a href=#activation-behavior>activation
- behavior</a> of the <code><a href=#the-button-element>button</a></code> element is to run the
- steps defined in the following list for the current state of the
- element's <code title=attr-button-type><a href=#attr-button-type>type</a></code> attribute.</p>
+ <p>When a <code><a href=#the-button-element>button</a></code> element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, its <a href=#activation-behavior>activation
+ behavior</a> element is to run the steps defined in the following
+ list for the current state of the element's <code title=attr-button-type><a href=#attr-button-type>type</a></code> attribute:</p>
<dl><dt> <dfn id=attr-button-type-submit-state title=attr-button-type-submit-state>Submit Button</dfn> </dt>
@@ -52063,17 +52075,17 @@
<h5 id=implicit-submission><span class=secno>4.10.22.2 </span>Implicit submission</h5>
- <p>User agents may establish a <a href=#concept-button title=concept-button>button</a> in each form as being the
- form's <dfn id=default-button>default button</dfn>. This should be the first <a href=#concept-submit-button title=concept-submit-button>submit button</a> in <a href=#tree-order>tree
- order</a> whose <a href=#form-owner>form owner</a> is that <code><a href=#the-form-element>form</a></code>
- element, but user agents may pick another button if another would be
- more appropriate for the platform. If the platform supports letting
- the user submit a form implicitly (for example, on some platforms
- hitting the "enter" key while a text field is focused implicitly
- submits the form), then doing so must cause the form's <a href=#default-button>default
- button</a>'s <a href=#activation-behavior>activation behavior</a>, if any, to be
- run.</p>
+ <p>A <code><a href=#the-form-element>form</a></code> element's <dfn id=default-button>default button</dfn> is the
+ first <a href=#concept-submit-button title=concept-submit-button>submit button</a> in
+ <a href=#tree-order>tree order</a> whose <a href=#form-owner>form owner</a> is that
+ <code><a href=#the-form-element>form</a></code> element.</p>
+ <p>If the platform supports letting the user submit a form
+ implicitly (for example, on some platforms hitting the "enter" key
+ while a text field is focused implicitly submits the form), then
+ doing so must cause the form's <a href=#default-button>default button</a>'s
+ <a href=#activation-behavior>activation behavior</a>, if any, to be run.</p>
+
<p class=note>Consequently, if the <a href=#default-button>default button</a> is
<a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, the form is not
submitted when such an implicit submission mechanism is used. (A
@@ -53398,8 +53410,10 @@
IDL attribute must return the <a href=#master-command>master command</a>, if any,
or null otherwise.</p>
- <hr><p>The element's <a href=#activation-behavior>activation behavior</a> depends on the
- element's <code title=attr-command-type><a href=#attr-command-type>type</a></code> and <code title=attr-command-command><a href=#attr-command-command>command</a></code> attributes, as
+ <hr><p>If the element's <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a> is false
+ (enabled) then the element's <a href=#activation-behavior>activation behavior</a>
+ depends on the element's <code title=attr-command-type><a href=#attr-command-type>type</a></code>
+ and <code title=attr-command-command><a href=#attr-command-command>command</a></code> attributes, as
follows:</p>
<dl class=switch><dt>If the element has a <a href=#master-command>master command</a> set by its
@@ -53407,6 +53421,8 @@
<dd><p>The user agent must <a href=#run-synthetic-click-activation-steps>run synthetic click activation
steps</a> on the element's <a href=#master-command>master command</a>.</dd>
+ <!-- we know it has a defined <span>activation behavior</span> if
+ we get here -->
<dt>If the <code title=attr-command-type><a href=#attr-command-type>type</a></code> attribute is
@@ -53433,17 +53449,18 @@
<dt>Otherwise</dt>
- <dd><p>The element has no <a href=#activation-behavior>activation behavior</a>.</dd>
+ <dd><p>The element's <a href=#activation-behavior>activation behavior</a> is to do
+ nothing.</dd>
</dl><p class=note>Firing a synthetic <code title=event-click><a href=#event-click>click</a></code> event at the element does not cause
any of the actions described above to happen.</p>
- <!-- v2COMMAND: the command="" attribute to make a <command> element
- reflect the state of another command, so that the script can update
- one place in the page and have context menus, toolbars, shortcuts,
- etc, automatically update. Once we add this, expose the Triggers
- facet again. -->
+ <!-- v2COMMAND: Expose the Triggers facet again. -->
+ <p>If the element's <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a> is true
+ (disabled) then the element has no <a href=#activation-behavior>activation
+ behavior</a>.</p>
+
</div>
<p class=note><code><a href=#the-command-element>command</a></code> elements are not rendered
@@ -53826,10 +53843,10 @@
<h4 id=commands><span class=secno>4.11.5 </span>Commands</h4>
<p>A <dfn id=concept-command title=concept-command>command</dfn> is the abstraction
- behind menu items, buttons, and links.<!--v2COMMAND: Once a command
+ behind menu items, buttons, and links. Once a command
is defined, other parts of the interface can refer to the same
command, allowing many access points to a single feature to share
- aspects such as the disabled state.--></p>
+ facets such as the <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a>.</p>
<p id=facets>Commands are defined to have the following
<dfn id=concept-facet title=concept-facet>facets</dfn>:</p>
@@ -56689,7 +56706,7 @@
<li><code><a href=#the-li-element>li</a></code> elements that are children of
<code><a href=#the-menu-element>menu</a></code> elements, and that have a child element that
defines a <a href=#concept-command title=concept-command>command</a>, if the
- first such element's <a href=#command-facet-disabledstate title=command-facet-disabledstate>Disabled State</a> facet
+ first such element's <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a> facet
is false (not disabled)</li>
<li><code><a href=#the-fieldset-element>fieldset</a></code> elements that do not have a <code title=attr-fieldset-disabled><a href=#attr-fieldset-disabled>disabled</a></code> attribute</li>
@@ -56724,7 +56741,7 @@
<li><code><a href=#the-li-element>li</a></code> elements that are children of
<code><a href=#the-menu-element>menu</a></code> elements, and that have a child element that
defines a <a href=#concept-command title=concept-command>command</a>, if the
- first such element's <a href=#command-facet-disabledstate title=command-facet-disabledstate>Disabled State</a> facet
+ first such element's <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a> facet
is true (disabled)</li>
<li><code><a href=#the-fieldset-element>fieldset</a></code> elements that have a <code title=attr-fieldset-disabled><a href=#attr-fieldset-disabled>disabled</a></code> attribute</li>
Modified: index
===================================================================
--- index 2012-02-21 20:57:10 UTC (rev 7003)
+++ index 2012-02-22 00:34:31 UTC (rev 7004)
@@ -240,7 +240,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 21 February 2012</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 22 February 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -46299,6 +46299,9 @@
cancelable. Once this fires, the control is checked, end of story.
--></p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p><strong>Constraint validation</strong>: If the element is <i title=concept-input-required><a href=#concept-input-required>required</a></i> and its <a href=#concept-fe-checked title=concept-fe-checked>checkedness</a> is false, then the
element is <a href=#suffering-from-being-missing>suffering from being missing</a>.</p>
@@ -46436,6 +46439,9 @@
cancelable. Once this fires, the control is checked, end of story.
-->.</p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p><strong>Constraint validation</strong>: If an element in the
<i><a href=#radio-button-group>radio button group</a></i> is <i title=concept-input-required><a href=#concept-input-required>required</a></i>, and all of the
<code><a href=#the-input-element>input</a></code> elements in the <i><a href=#radio-button-group>radio button group</a></i> have a
@@ -46724,12 +46730,13 @@
<div class=impl>
<p>If the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>,
- the user agent should allow the user to activate the element.</p>
+ then the element's <a href=#activation-behavior>activation behavior</a> is as follows:
+ if the element has a <a href=#form-owner>form owner</a>, <a href=#concept-form-submit title=concept-form-submit>submit</a> the <a href=#form-owner>form
+ owner</a> from the <code><a href=#the-input-element>input</a></code> element; otherwise, do
+ nothing.</p>
- <p>The element's <a href=#activation-behavior>activation behavior</a>, if the element
- has a <a href=#form-owner>form owner</a>, is to <a href=#concept-form-submit title=concept-form-submit>submit</a> the <a href=#form-owner>form
- owner</a> from the <code><a href=#the-input-element>input</a></code> element; otherwise, it is
- to do nothing.</p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
</div>
@@ -46903,24 +46910,29 @@
element <a href=#represents>represents</a> a control for selecting a <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a> from
the image specified by the <code title=attr-input-src><a href=#attr-input-src>src</a></code>
attribute; if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>, the user agent should
- allow the user to select this <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a>. The
- <a href=#activation-behavior>activation behavior</a> in this case consists of taking the
- user's selected <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a>, and
- then, if the element has a <a href=#form-owner>form owner</a>, <a href=#concept-form-submit title=concept-form-submit>submitting</a> the <code><a href=#the-input-element>input</a></code>
- element's <a href=#form-owner>form owner</a> from the <code><a href=#the-input-element>input</a></code>
- element. If the user activates the control without explicitly
- selecting a coordinate, then the coordinate (0,0) must be
- assumed.</p>
+ allow the user to select this <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a>, and
+ the element's <a href=#activation-behavior>activation behavior</a> is as follows: if the
+ element has a <a href=#form-owner>form owner</a>, take the user's selected
+ <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>coordinate</a>,
+ and <a href=#concept-form-submit title=concept-form-submit>submit</a> the
+ <code><a href=#the-input-element>input</a></code> element's <a href=#form-owner>form owner</a> from the
+ <code><a href=#the-input-element>input</a></code> element. If the user activates the control
+ without explicitly selecting a coordinate, then the coordinate (0,0)
+ must be assumed.</p>
<p>Otherwise, the element <a href=#represents>represents</a> a submit button
- whose label is given by the value of the <code title=attr-input-alt><a href=#attr-input-alt>alt</a></code> attribute; if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>, the user agent should
- allow the user to activate the button. The <a href=#activation-behavior>activation
- behavior</a> in this case consists of setting the <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected
- coordinate</a> to (0,0), and then, if the element has a
- <a href=#form-owner>form owner</a>, <a href=#concept-form-submit title=concept-form-submit>submitting</a> the <code><a href=#the-input-element>input</a></code>
+ whose label is given by the value of the <code title=attr-input-alt><a href=#attr-input-alt>alt</a></code> attribute; if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>, then the element's
+ <a href=#activation-behavior>activation behavior</a> is as follows: if the element has a
+ <a href=#form-owner>form owner</a>, set the <a href=#concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected
+ coordinate</a> to (0,0), and <a href=#concept-form-submit title=concept-form-submit>submit</a> the <code><a href=#the-input-element>input</a></code>
element's <a href=#form-owner>form owner</a> from the <code><a href=#the-input-element>input</a></code>
element.</p>
+ <p>In either case, if the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i> but has no <a href=#form-owner>form
+ owner</a>, then its <a href=#activation-behavior>activation behavior</a> must be to
+ do nothing. If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p>The <dfn id=concept-input-type-image-coordinate title=concept-input-type-image-coordinate>selected
coordinate</dfn> must consist of an <var title="">x</var>-component
and a <var title="">y</var>-component. The coordinates represent the
@@ -47067,12 +47079,13 @@
<div class=impl>
<p>If the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>,
- the user agent should allow the user to activate the element.</p>
-
- <p>The element's <a href=#activation-behavior>activation behavior</a>, if the element
+ then the element's <a href=#activation-behavior>activation behavior</a>, if the element
has a <a href=#form-owner>form owner</a>, is to <a href=#concept-form-reset title=concept-form-reset>reset</a> the <a href=#form-owner>form owner</a>;
otherwise, it is to do nothing.</p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p><strong>Constraint validation</strong>: The element is
<a href=#barred-from-constraint-validation>barred from constraint validation</a>.</p>
@@ -47150,9 +47163,11 @@
<div class=impl>
<p>If the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>,
- the user agent should allow the user to activate the element. The
- element's <a href=#activation-behavior>activation behavior</a> is to do nothing.</p>
+ the element's <a href=#activation-behavior>activation behavior</a> is to do nothing.</p>
+ <p>If the element is <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>, it has no
+ <a href=#activation-behavior>activation behavior</a>.</p>
+
<p><strong>Constraint validation</strong>: The element is
<a href=#barred-from-constraint-validation>barred from constraint validation</a>.</p>
@@ -48433,9 +48448,7 @@
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
- </dl><!--TOPIC:HTML--><p>The <code><a href=#the-button-element>button</a></code> element <a href=#represents>represents</a> a
- button. <span class=impl>If the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent
- should allow the user to activate the button.</span></p>
+ </dl><!--TOPIC:HTML--><p>The <code><a href=#the-button-element>button</a></code> element <a href=#represents>represents</a> a button.</p>
<p>The element is a <a href=#concept-button title=concept-button>button</a>.</p>
@@ -48471,10 +48484,9 @@
the <a href=#attr-button-type-button-state title=attr-button-type-button-state>Button</a> state,
the element is <a href=#barred-from-constraint-validation>barred from constraint validation</a>.</p>
- <p>If the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, the <a href=#activation-behavior>activation
- behavior</a> of the <code><a href=#the-button-element>button</a></code> element is to run the
- steps defined in the following list for the current state of the
- element's <code title=attr-button-type><a href=#attr-button-type>type</a></code> attribute.</p>
+ <p>When a <code><a href=#the-button-element>button</a></code> element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, its <a href=#activation-behavior>activation
+ behavior</a> element is to run the steps defined in the following
+ list for the current state of the element's <code title=attr-button-type><a href=#attr-button-type>type</a></code> attribute:</p>
<dl><dt> <dfn id=attr-button-type-submit-state title=attr-button-type-submit-state>Submit Button</dfn> </dt>
@@ -52063,17 +52075,17 @@
<h5 id=implicit-submission><span class=secno>4.10.22.2 </span>Implicit submission</h5>
- <p>User agents may establish a <a href=#concept-button title=concept-button>button</a> in each form as being the
- form's <dfn id=default-button>default button</dfn>. This should be the first <a href=#concept-submit-button title=concept-submit-button>submit button</a> in <a href=#tree-order>tree
- order</a> whose <a href=#form-owner>form owner</a> is that <code><a href=#the-form-element>form</a></code>
- element, but user agents may pick another button if another would be
- more appropriate for the platform. If the platform supports letting
- the user submit a form implicitly (for example, on some platforms
- hitting the "enter" key while a text field is focused implicitly
- submits the form), then doing so must cause the form's <a href=#default-button>default
- button</a>'s <a href=#activation-behavior>activation behavior</a>, if any, to be
- run.</p>
+ <p>A <code><a href=#the-form-element>form</a></code> element's <dfn id=default-button>default button</dfn> is the
+ first <a href=#concept-submit-button title=concept-submit-button>submit button</a> in
+ <a href=#tree-order>tree order</a> whose <a href=#form-owner>form owner</a> is that
+ <code><a href=#the-form-element>form</a></code> element.</p>
+ <p>If the platform supports letting the user submit a form
+ implicitly (for example, on some platforms hitting the "enter" key
+ while a text field is focused implicitly submits the form), then
+ doing so must cause the form's <a href=#default-button>default button</a>'s
+ <a href=#activation-behavior>activation behavior</a>, if any, to be run.</p>
+
<p class=note>Consequently, if the <a href=#default-button>default button</a> is
<a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, the form is not
submitted when such an implicit submission mechanism is used. (A
@@ -53398,8 +53410,10 @@
IDL attribute must return the <a href=#master-command>master command</a>, if any,
or null otherwise.</p>
- <hr><p>The element's <a href=#activation-behavior>activation behavior</a> depends on the
- element's <code title=attr-command-type><a href=#attr-command-type>type</a></code> and <code title=attr-command-command><a href=#attr-command-command>command</a></code> attributes, as
+ <hr><p>If the element's <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a> is false
+ (enabled) then the element's <a href=#activation-behavior>activation behavior</a>
+ depends on the element's <code title=attr-command-type><a href=#attr-command-type>type</a></code>
+ and <code title=attr-command-command><a href=#attr-command-command>command</a></code> attributes, as
follows:</p>
<dl class=switch><dt>If the element has a <a href=#master-command>master command</a> set by its
@@ -53407,6 +53421,8 @@
<dd><p>The user agent must <a href=#run-synthetic-click-activation-steps>run synthetic click activation
steps</a> on the element's <a href=#master-command>master command</a>.</dd>
+ <!-- we know it has a defined <span>activation behavior</span> if
+ we get here -->
<dt>If the <code title=attr-command-type><a href=#attr-command-type>type</a></code> attribute is
@@ -53433,17 +53449,18 @@
<dt>Otherwise</dt>
- <dd><p>The element has no <a href=#activation-behavior>activation behavior</a>.</dd>
+ <dd><p>The element's <a href=#activation-behavior>activation behavior</a> is to do
+ nothing.</dd>
</dl><p class=note>Firing a synthetic <code title=event-click><a href=#event-click>click</a></code> event at the element does not cause
any of the actions described above to happen.</p>
- <!-- v2COMMAND: the command="" attribute to make a <command> element
- reflect the state of another command, so that the script can update
- one place in the page and have context menus, toolbars, shortcuts,
- etc, automatically update. Once we add this, expose the Triggers
- facet again. -->
+ <!-- v2COMMAND: Expose the Triggers facet again. -->
+ <p>If the element's <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a> is true
+ (disabled) then the element has no <a href=#activation-behavior>activation
+ behavior</a>.</p>
+
</div>
<p class=note><code><a href=#the-command-element>command</a></code> elements are not rendered
@@ -53826,10 +53843,10 @@
<h4 id=commands><span class=secno>4.11.5 </span>Commands</h4>
<p>A <dfn id=concept-command title=concept-command>command</dfn> is the abstraction
- behind menu items, buttons, and links.<!--v2COMMAND: Once a command
+ behind menu items, buttons, and links. Once a command
is defined, other parts of the interface can refer to the same
command, allowing many access points to a single feature to share
- aspects such as the disabled state.--></p>
+ facets such as the <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a>.</p>
<p id=facets>Commands are defined to have the following
<dfn id=concept-facet title=concept-facet>facets</dfn>:</p>
@@ -56689,7 +56706,7 @@
<li><code><a href=#the-li-element>li</a></code> elements that are children of
<code><a href=#the-menu-element>menu</a></code> elements, and that have a child element that
defines a <a href=#concept-command title=concept-command>command</a>, if the
- first such element's <a href=#command-facet-disabledstate title=command-facet-disabledstate>Disabled State</a> facet
+ first such element's <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a> facet
is false (not disabled)</li>
<li><code><a href=#the-fieldset-element>fieldset</a></code> elements that do not have a <code title=attr-fieldset-disabled><a href=#attr-fieldset-disabled>disabled</a></code> attribute</li>
@@ -56724,7 +56741,7 @@
<li><code><a href=#the-li-element>li</a></code> elements that are children of
<code><a href=#the-menu-element>menu</a></code> elements, and that have a child element that
defines a <a href=#concept-command title=concept-command>command</a>, if the
- first such element's <a href=#command-facet-disabledstate title=command-facet-disabledstate>Disabled State</a> facet
+ first such element's <a href=#command-facet-disabledstate title=command-facet-DisabledState>Disabled State</a> facet
is true (disabled)</li>
<li><code><a href=#the-fieldset-element>fieldset</a></code> elements that have a <code title=attr-fieldset-disabled><a href=#attr-fieldset-disabled>disabled</a></code> attribute</li>
Modified: source
===================================================================
--- source 2012-02-21 20:57:10 UTC (rev 7003)
+++ source 2012-02-22 00:34:31 UTC (rev 7004)
@@ -53890,6 +53890,10 @@
cancelable. Once this fires, the control is checked, end of story.
--></p>
+ <p>If the element is <i
+ title="concept-input-immutable">immutable</i>, it has no
+ <span>activation behavior</span>.</p>
+
<p><strong>Constraint validation</strong>: If the element is <i
title="concept-input-required">required</i> and its <span
title="concept-fe-checked">checkedness</span> is false, then the
@@ -54054,6 +54058,10 @@
cancelable. Once this fires, the control is checked, end of story.
-->.</p>
+ <p>If the element is <i
+ title="concept-input-immutable">immutable</i>, it has no
+ <span>activation behavior</span>.</p>
+
<p><strong>Constraint validation</strong>: If an element in the
<i>radio button group</i> is <i
title="concept-input-required">required</i>, and all of the
@@ -54363,14 +54371,16 @@
<div class="impl">
<p>If the element is <i title="concept-input-mutable">mutable</i>,
- the user agent should allow the user to activate the element.</p>
-
- <p>The element's <span>activation behavior</span>, if the element
- has a <span>form owner</span>, is to <span
+ then the element's <span>activation behavior</span> is as follows:
+ if the element has a <span>form owner</span>, <span
title="concept-form-submit">submit</span> the <span>form
- owner</span> from the <code>input</code> element; otherwise, it is
- to do nothing.</p>
+ owner</span> from the <code>input</code> element; otherwise, do
+ nothing.</p>
+ <p>If the element is <i
+ title="concept-input-immutable">immutable</i>, it has no
+ <span>activation behavior</span>.</p>
+
</div>
<p>The <code title="attr-fs-formaction">formaction</code>, <code
@@ -54587,30 +54597,35 @@
attribute; if the element is <i
title="concept-input-mutable">mutable</i>, the user agent should
allow the user to select this <span
- title="concept-input-type-image-coordinate">coordinate</span>. The
- <span>activation behavior</span> in this case consists of taking the
- user's selected <span
title="concept-input-type-image-coordinate">coordinate</span>, and
- then, if the element has a <span>form owner</span>, <span
- title="concept-form-submit">submitting</span> the <code>input</code>
- element's <span>form owner</span> from the <code>input</code>
- element. If the user activates the control without explicitly
- selecting a coordinate, then the coordinate (0,0) must be
- assumed.</p>
+ the element's <span>activation behavior</span> is as follows: if the
+ element has a <span>form owner</span>, take the user's selected
+ <span title="concept-input-type-image-coordinate">coordinate</span>,
+ and <span title="concept-form-submit">submit</span> the
+ <code>input</code> element's <span>form owner</span> from the
+ <code>input</code> element. If the user activates the control
+ without explicitly selecting a coordinate, then the coordinate (0,0)
+ must be assumed.</p>
<p>Otherwise, the element <span>represents</span> a submit button
whose label is given by the value of the <code
title="attr-input-alt">alt</code> attribute; if the element is <i
- title="concept-input-mutable">mutable</i>, the user agent should
- allow the user to activate the button. The <span>activation
- behavior</span> in this case consists of setting the <span
+ title="concept-input-mutable">mutable</i>, then the element's
+ <span>activation behavior</span> is as follows: if the element has a
+ <span>form owner</span>, set the <span
title="concept-input-type-image-coordinate">selected
- coordinate</span> to (0,0), and then, if the element has a
- <span>form owner</span>, <span
- title="concept-form-submit">submitting</span> the <code>input</code>
+ coordinate</span> to (0,0), and <span
+ title="concept-form-submit">submit</span> the <code>input</code>
element's <span>form owner</span> from the <code>input</code>
element.</p>
+ <p>In either case, if the element is <i
+ title="concept-input-mutable">mutable</i> but has no <span>form
+ owner</span>, then its <span>activation behavior</span> must be to
+ do nothing. If the element is <i
+ title="concept-input-immutable">immutable</i>, it has no
+ <span>activation behavior</span>.</p>
+
<p>The <dfn title="concept-input-type-image-coordinate">selected
coordinate</dfn> must consist of an <var title="">x</var>-component
and a <var title="">y</var>-component. The coordinates represent the
@@ -54789,13 +54804,15 @@
<div class="impl">
<p>If the element is <i title="concept-input-mutable">mutable</i>,
- the user agent should allow the user to activate the element.</p>
-
- <p>The element's <span>activation behavior</span>, if the element
+ then the element's <span>activation behavior</span>, if the element
has a <span>form owner</span>, is to <span
title="concept-form-reset">reset</span> the <span>form owner</span>;
otherwise, it is to do nothing.</p>
+ <p>If the element is <i
+ title="concept-input-immutable">immutable</i>, it has no
+ <span>activation behavior</span>.</p>
+
<p><strong>Constraint validation</strong>: The element is
<span>barred from constraint validation</span>.</p>
@@ -54879,9 +54896,12 @@
<div class="impl">
<p>If the element is <i title="concept-input-mutable">mutable</i>,
- the user agent should allow the user to activate the element. The
- element's <span>activation behavior</span> is to do nothing.</p>
+ the element's <span>activation behavior</span> is to do nothing.</p>
+ <p>If the element is <i
+ title="concept-input-immutable">immutable</i>, it has no
+ <span>activation behavior</span>.</p>
+
<p><strong>Constraint validation</strong>: The element is
<span>barred from constraint validation</span>.</p>
@@ -56381,10 +56401,7 @@
</dd>
</dl><!--TOPIC:HTML-->
- <p>The <code>button</code> element <span>represents</span> a
- button. <span class="impl">If the element is not <span
- title="concept-fe-disabled">disabled</span>, then the user agent
- should allow the user to activate the button.</span></p>
+ <p>The <code>button</code> element <span>represents</span> a button.</p>
<p>The element is a <span title="concept-button">button</span>.</p>
@@ -56433,11 +56450,11 @@
the <span title="attr-button-type-button-state">Button</span> state,
the element is <span>barred from constraint validation</span>.</p>
- <p>If the element is not <span
- title="concept-fe-disabled">disabled</span>, the <span>activation
- behavior</span> of the <code>button</code> element is to run the
- steps defined in the following list for the current state of the
- element's <code title="attr-button-type">type</code> attribute.</p>
+ <p>When a <code>button</code> element is not <span
+ title="concept-fe-disabled">disabled</span>, its <span>activation
+ behavior</span> element is to run the steps defined in the following
+ list for the current state of the element's <code
+ title="attr-button-type">type</code> attribute:</p>
<dl>
@@ -60672,19 +60689,17 @@
<h5>Implicit submission</h5>
- <p>User agents may establish a <span
- title="concept-button">button</span> in each form as being the
- form's <dfn>default button</dfn>. This should be the first <span
- title="concept-submit-button">submit button</span> in <span>tree
- order</span> whose <span>form owner</span> is that <code>form</code>
- element, but user agents may pick another button if another would be
- more appropriate for the platform. If the platform supports letting
- the user submit a form implicitly (for example, on some platforms
- hitting the "enter" key while a text field is focused implicitly
- submits the form), then doing so must cause the form's <span>default
- button</span>'s <span>activation behavior</span>, if any, to be
- run.</p>
+ <p>A <code>form</code> element's <dfn>default button</dfn> is the
+ first <span title="concept-submit-button">submit button</span> in
+ <span>tree order</span> whose <span>form owner</span> is that
+ <code>form</code> element.</p>
+ <p>If the platform supports letting the user submit a form
+ implicitly (for example, on some platforms hitting the "enter" key
+ while a text field is focused implicitly submits the form), then
+ doing so must cause the form's <span>default button</span>'s
+ <span>activation behavior</span>, if any, to be run.</p>
+
<p class="note">Consequently, if the <span>default button</span> is
<span title="concept-fe-disabled">disabled</span>, the form is not
submitted when such an implicit submission mechanism is used. (A
@@ -62320,9 +62335,11 @@
<hr>
- <p>The element's <span>activation behavior</span> depends on the
- element's <code title="attr-command-type">type</code> and <code
- title="attr-command-command">command</code> attributes, as
+ <p>If the element's <span
+ title="command-facet-DisabledState">Disabled State</span> is false
+ (enabled) then the element's <span>activation behavior</span>
+ depends on the element's <code title="attr-command-type">type</code>
+ and <code title="attr-command-command">command</code> attributes, as
follows:</p>
<dl class="switch">
@@ -62332,6 +62349,8 @@
<dd><p>The user agent must <span>run synthetic click activation
steps</span> on the element's <span>master command</span>.</p></dd>
+ <!-- we know it has a defined <span>activation behavior</span> if
+ we get here -->
<dt>If the <code title="attr-command-type">type</code> attribute is
@@ -62367,7 +62386,8 @@
<dt>Otherwise</dt>
- <dd><p>The element has no <span>activation behavior</span>.</p></dd>
+ <dd><p>The element's <span>activation behavior</span> is to do
+ nothing.</p></dd>
</dl>
@@ -62375,12 +62395,13 @@
title="event-click">click</code> event at the element does not cause
any of the actions described above to happen.</p>
- <!-- v2COMMAND: the command="" attribute to make a <command> element
- reflect the state of another command, so that the script can update
- one place in the page and have context menus, toolbars, shortcuts,
- etc, automatically update. Once we add this, expose the Triggers
- facet again. -->
+ <!-- v2COMMAND: Expose the Triggers facet again. -->
+ <p>If the element's <span
+ title="command-facet-DisabledState">Disabled State</span> is true
+ (disabled) then the element has no <span>activation
+ behavior</span>.</p>
+
</div>
<p class="note"><code>command</code> elements are not rendered
@@ -62809,10 +62830,10 @@
<h4 id="commands">Commands</h4>
<p>A <dfn title="concept-command">command</dfn> is the abstraction
- behind menu items, buttons, and links.<!--v2COMMAND: Once a command
+ behind menu items, buttons, and links. Once a command
is defined, other parts of the interface can refer to the same
command, allowing many access points to a single feature to share
- aspects such as the disabled state.--></p>
+ facets such as the <span title="command-facet-DisabledState">Disabled State</span>.</p>
<p id="facets">Commands are defined to have the following
<dfn title="concept-facet">facets</dfn>:</p>
@@ -66082,7 +66103,7 @@
<code>menu</code> elements, and that have a child element that
defines a <span title="concept-command">command</span>, if the
first such element's <span
- title="command-facet-disabledstate">Disabled State</span> facet
+ title="command-facet-DisabledState">Disabled State</span> facet
is false (not disabled)</li>
<li><code>fieldset</code> elements that do not have a <code
@@ -66130,7 +66151,7 @@
<code>menu</code> elements, and that have a child element that
defines a <span title="concept-command">command</span>, if the
first such element's <span
- title="command-facet-disabledstate">Disabled State</span> facet
+ title="command-facet-DisabledState">Disabled State</span> facet
is true (disabled)</li>
<li><code>fieldset</code> elements that have a <code
More information about the Commit-Watchers
mailing list