W3C home > Mailing lists > Public > public-html-diffs@w3.org > February 2012

hixie: 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 (whatwg r7004)

From: poot <cvsmail@w3.org>
Date: Tue, 21 Feb 2012 19:34:55 -0500
To: public-html-diffs@w3.org
Message-Id: <E1S00AZ-0006MV-At@jay.w3.org>
hixie: 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 (whatwg r7004)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5594&r2=1.5595&f=h
http://html5.org/tools/web-apps-tracker?from=7003&to=7004

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5594
retrieving revision 1.5595
diff -u -d -r1.5594 -r1.5595
--- Overview.html	21 Feb 2012 20:57:16 -0000	1.5594
+++ Overview.html	22 Feb 2012 00:34:36 -0000	1.5595
@@ -320,7 +320,7 @@
 
    <h1>HTML5</h1>
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
-   <h2 class="no-num no-toc" id="editor-s-draft-21-february-2012">Editor's Draft 21 February 2012</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-22-february-2012">Editor's Draft 22 February 2012</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -467,7 +467,7 @@
   Group</a> is the W3C working group responsible for this
   specification's progress along the W3C Recommendation
   track.
-  This specification is the 21 February 2012 Editor's Draft.
+  This specification is the 22 February 2012 Editor's Draft.
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
   actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
   group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -36919,6 +36919,9 @@
   steps</a> were run. The <a href="#activation-behavior">activation behavior</a> is to
   <a href="#fire-a-simple-event">fire a simple event</a> that bubbles named <code title="event-change">change</code> at the element. </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>
 
@@ -37037,6 +37040,9 @@
   false. The <a href="#activation-behavior">activation behavior</a> is to <a href="#fire-a-simple-event">fire a
   simple event</a> that bubbles named <code title="event-change">change</code> at the element. .</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
@@ -37282,12 +37288,13 @@
   some such.</span> The element is a <a href="#concept-button" title="concept-button">button</a>, specifically a <a href="#concept-submit-button" title="concept-submit-button">submit button</a>.<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><p>The <code title="attr-fs-formaction"><a href="#attr-fs-formaction">formaction</a></code>, <code title="attr-fs-formenctype"><a href="#attr-fs-formenctype">formenctype</a></code>, <code title="attr-fs-formmethod"><a href="#attr-fs-formmethod">formmethod</a></code>, <code title="attr-fs-formnovalidate"><a href="#attr-fs-formnovalidate">formnovalidate</a></code>, and <code title="attr-fs-formtarget"><a href="#attr-fs-formtarget">formtarget</a></code> attributes are <a href="#attributes-for-form-submission">attributes
   for form submission</a>.<p class="note">The <code title="attr-fs-formnovalidate"><a href="#attr-fs-formnovalidate">formnovalidate</a></code> attribute can
@@ -37434,24 +37441,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
@@ -37579,12 +37591,13 @@
   some such.</span> The element is a <a href="#concept-button" title="concept-button">button</a>.<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>
 
@@ -37651,8 +37664,10 @@
   empty string.</span> The element is a <a href="#concept-button" title="concept-button">button</a>.<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>
@@ -38750,9 +38765,7 @@
   readonly attribute <a href="#nodelist">NodeList</a> <a href="#dom-lfe-labels" title="dom-lfe-labels">labels</a>;
 };</pre>
    </dd>
-  </dl><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>The element is a <a href="#concept-button" title="concept-button">button</a>.<p>The <dfn id="attr-button-type" title="attr-button-type"><code>type</code></dfn>
+  </dl><p>The <code><a href="#the-button-element">button</a></code> element <a href="#represents">represents</a> a button.<p>The element is a <a href="#concept-button" title="concept-button">button</a>.<p>The <dfn id="attr-button-type" title="attr-button-type"><code>type</code></dfn>
   attribute controls the behavior of the button when it is activated.
   It is an <a href="#enumerated-attribute">enumerated attribute</a>. The following table
   lists the keywords and states for the attribute &mdash; the keywords
@@ -38778,10 +38791,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>
 
@@ -41854,16 +41866,16 @@
 
   <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
@@ -43040,8 +43052,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
@@ -43049,6 +43063,7 @@
 
    <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>
+   
 
 
    <dt>If the <code title="attr-command-type"><a href="#attr-command-type">type</a></code> attribute is
@@ -43075,13 +43090,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>
 
   
 
+  <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
   unless they <a href="#the-menu-element" title="menu">form part of a menu</a>.<div class="example">
 
@@ -43378,7 +43398,10 @@
   and toolbars">rebuilding</a> the menu.</p>
 
   </div><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.<p id="facets">Commands are defined to have the following
+  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
+  facets such as the <a href="#command-facet-disabledstate" title="command-facet-DisabledState">Disabled State</a>.<p id="facets">Commands are defined to have the following
   <dfn id="concept-facet" title="concept-facet">facets</dfn>:<dl><dt><dfn id="command-facet-type" title="command-facet-Type">Type</dfn></dt>
 
    <dd>The kind of command: "command", meaning it is a normal command;
@@ -45336,7 +45359,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>
@@ -45371,7 +45394,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>
Received on Wednesday, 22 February 2012 00:34:58 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 22 February 2012 00:34:58 GMT