- From: poot <cvsmail@w3.org>
- Date: 2012年2月21日 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 — 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 UTC