- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 22 Feb 2012 00:34:43 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv20517
Modified Files:
Overview.html
Log Message:
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)
Index: Overview.html
===================================================================
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:46 UTC