W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2008

html5/spec Overview.html,1.1452,1.1453

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Sat, 04 Oct 2008 01:21:46 +0000
To: public-html-commits@w3.org
Message-Id: <E1Klvq6-00075O-5R@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27224

Modified Files:
	Overview.html 
Log Message:
WF2: <button>. (whatwg r2280)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1452
retrieving revision 1.1453
diff -u -d -r1.1452 -r1.1453
--- Overview.html	4 Oct 2008 00:25:15 -0000	1.1452
+++ Overview.html	4 Oct 2008 01:21:43 -0000	1.1453
@@ -19395,7 +19395,8 @@
   <a href=#form-owner>form owner</a>. The <code title=attr-fe-name><a href=#attr-fe-name>name</a></code>
   attribute represents the element's name. The <code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code> attribute is used to make
   the control non-interactive and to prevent its value from being
-  submitted.<p>The <dfn id=dom-input-accept title=dom-input-accept><code>accept</code></dfn>, <dfn id=dom-input-alt title=dom-input-alt><code>alt</code></dfn>, <dfn id=dom-input-autocomplete title=dom-input-autocomplete><code>autocomplete</code></dfn>, <dfn id=dom-input-max title=dom-input-max><code>max</code></dfn>, <dfn id=dom-input-min title=dom-input-min><code>min</code></dfn>, <dfn id=dom-input-pattern title=dom-input-pattern><code>pattern</code></dfn>, <dfn id=dom-input-required title=dom-input-required><code>required</code></dfn>, <dfn id=dom-input-size title=dom-input-size><code>size</code></dfn>, <dfn id=dom-input-src title=dom-input-src><code>src</code></dfn>, <dfn id=dom-input-step title=dom-input-step><code>step</code></dfn>, and <dfn id=dom-input-type title=dom-input-type><code>type</code></dfn> DOM attributes must
+  submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
+  attribute controls focus.<p>The <dfn id=dom-input-accept title=dom-input-accept><code>accept</code></dfn>, <dfn id=dom-input-alt title=dom-input-alt><code>alt</code></dfn>, <dfn id=dom-input-autocomplete title=dom-input-autocomplete><code>autocomplete</code></dfn>, <dfn id=dom-input-max title=dom-input-max><code>max</code></dfn>, <dfn id=dom-input-min title=dom-input-min><code>min</code></dfn>, <dfn id=dom-input-pattern title=dom-input-pattern><code>pattern</code></dfn>, <dfn id=dom-input-required title=dom-input-required><code>required</code></dfn>, <dfn id=dom-input-size title=dom-input-size><code>size</code></dfn>, <dfn id=dom-input-src title=dom-input-src><code>src</code></dfn>, <dfn id=dom-input-step title=dom-input-step><code>step</code></dfn>, and <dfn id=dom-input-type title=dom-input-type><code>type</code></dfn> DOM attributes must
   <a href=#reflect>reflect</a> the content attributes with the same names.
   The <dfn id=dom-input-maxlength title=dom-input-maxLength><code>maxLength</code></dfn>
   DOM attribute must <a href=#reflect>reflect</a> the <code title=attr-input-maxlength><a href=#attr-input-maxlength>maxlength</a></code> content attribute. The
@@ -20382,7 +20383,8 @@
   implementation-defined string that means "Submit" or some such.<p>If the element is <i title=concept-input-mutable><a href=#concept-input-mutable>mutable</a></i>,
   the user should allow the user to activate the element.</p><!-- XXX event timing; activation behavior --><p>When the element is activated, if the element has a <a href=#form-owner>form
   owner</a>, the element must <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.<p>The following common <code><a href=#the-input-element>input</a></code> element content
+  owner</a> from the <code><a href=#the-input-element>input</a></code> element.<p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes control the form
+  submission.<p>The following common <code><a href=#the-input-element>input</a></code> element content
   attributes and DOM attributes apply to the element:
   <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>,
   <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>,
@@ -20482,7 +20484,8 @@
   and less than or equal to the rendered width, in CSS pixels, of the
   image. The <var title="">y</var>-component must be greater than or
   equal to zero, and less than or equal to the rendered height, in CSS
-  pixels, of the image.</p><hr><p>The following common <code><a href=#the-input-element>input</a></code> element content
+  pixels, of the image.</p><hr><p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes control the form
+  submission.<p>The following common <code><a href=#the-input-element>input</a></code> element content
   attributes and DOM attributes apply to the element:
   <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>,
   <code title=attr-input-alt><a href=#attr-input-alt>alt</a></code>,
@@ -20676,7 +20679,7 @@
   sections 15.10.7.2 through 15.10.7.4), compiles successfully but the
   resulting regular expression does not match the entirety of the
   element's <a href=#concept-fe-value title=concept-fe-value>value</a>, then the
-  element is <span>suffering from a pattern mismatch</span>. <a href=#references>[ECMA262]</a><p class=note>This implies that the regular expression language
+  element is <a href=#suffering-from-a-pattern-mismatch>suffering from a pattern mismatch</a>. <a href=#references>[ECMA262]</a><p class=note>This implies that the regular expression language
   used for this attribute is the same as that defined in ECMA 262,
   except that the <code title=attr-input-pattern><a href=#attr-input-pattern>pattern</a></code>
   attribute must match the entire value, not just any subset (somewhat
@@ -20885,8 +20888,8 @@
    <dd><code title=attr-fs-method><a href=#attr-fs-method>method</a></code></dd>
    <dd><code title=attr-fe-name><a href=#attr-fe-name>name</a></code></dd>
    <dd><code title=attr-fs-target><a href=#attr-fs-target>target</a></code></dd>
-   <dd><code title=attr-button-type>type</code></dd>
-   <dd><code title=attr-button-value>value</code></dd>
+   <dd><code title=attr-button-type><a href=#attr-button-type>type</a></code></dd>
+   <dd><code title=attr-button-value><a href=#attr-button-value>value</a></code></dd>
    <dt>DOM interface:</dt>
    <dd>
 <pre class=idl>interface <dfn id=htmlbuttonelement>HTMLButtonElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
@@ -20910,12 +20913,61 @@
   void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(in DOMString error);
 };</pre>
    </dd> 
-  </dl><p class=XXX>...<p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to
+  </dl><p>The <code><a href=#the-button-element>button</a></code> element represents a button. 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.<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
+  in the left column map to the states in the cell in the second
+  column on the same row as the keyword.<table><thead><tr><th> Keyword
+     <th> State
+     <th> Brief description
+   <tbody><tr><td><dfn id=attr-button-type-submit title=attr-button-type-submit><code>submit</code></dfn>
+     <td><a href=#attr-button-type-submit-state title=attr-button-type-submit-state>Submit Button</a>
+     <td>Submits the form.
+    <tr><td><dfn id=attr-button-type-reset title=attr-button-type-reset><code>reset</code></dfn>
+     <td><a href=#attr-button-type-reset-state title=attr-button-type-reset-state>Reset Button</a>
+     <td>Resets the form.
+    <tr><td><dfn id=attr-button-type-button title=attr-button-type-button><code>button</code></dfn>
+     <td><a href=#attr-button-type-button-state title=attr-button-type-button-state>Button</a>
+     <td>Does nothing.
+  </table><p>The <i>missing value default</i> is the <a href=#attr-button-type-submit-state title=attr-button-type-submit-state>Submit Button</a>
+  state.<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.<dl><dt> <dfn id=attr-button-type-submit-state title=attr-button-type-submit-state>Submit Button</dfn> </dt>
+
+   <dd><p>If the element has a <a href=#form-owner>form owner</a>, the element
+   must <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-button-element>button</a></code> element.</dd>
+
+   <dt> <dfn id=attr-button-type-reset-state title=attr-button-type-reset-state>Reset Button</dfn> </dt>
+
+   <dd><p>If the element has a <a href=#form-owner>form owner</a>, the element
+   must <a href=#concept-form-reset title=concept-form-reset>reset</a> the <a href=#form-owner>form
+   owner</a>.</dd>
+
+   <dt> <dfn id=attr-button-type-button-state title=attr-button-type-button-state>Button</dfn>
+
+   <dd><p>Do nothing.</dd>
+
+  </dl><p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to
   explicitly associate the <code><a href=#the-button-element>button</a></code> element with its
   <a href=#form-owner>form owner</a>. The <code title=attr-fe-name><a href=#attr-fe-name>name</a></code>
   attribute represents the element's name. The <code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code> attribute is used to make
   the control non-interactive and to prevent its value from being
-  submitted.<p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>,
+  submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
+  attribute controls focus.
+  The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes  control
+  the form submission.<p>The <dfn id=attr-button-value title=attr-button-value><code>value</code></dfn>
+  attribute gives the element's value for the purposes of form
+  submission. The <code title=attr-button-value><a href=#attr-button-value>value</a></code>
+  attribute must not be present unless the <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is present. The
+  element's <a href=#concept-fe-value title=concept-fe-value>value</a> is the value
+  of the element's <code title=attr-button-value><a href=#attr-button-value>value</a></code>
+  attribute, if there is one, or the empty string otherwise.<p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>,
   <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code>, and <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code>
   attributes, and the <code title=dom-cva-checkValidatity><a href=#dom-cva-checkvalidatity>checkValidity()</a></code> and
   <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
@@ -21240,6 +21292,7 @@
   validation</dfn>. (For example, an element is <a href=#barred-from-constraint-validation>barred from
   constraint validation</a> if it is an <code><a href=#the-output-element>output</a></code> or
   <code><a href=#the-fieldset-element>fieldset</a></code> element.)<p class=XXX>An element <dfn id=concept-fv-valid title=concept-fv-valid>satisfies its constraints</dfn> if ...<p class=XXX>... <dfn id=suffering-from-being-missing>suffering from being missing</dfn><p class=XXX>... <dfn id=suffering-from-a-type-mismatch>suffering from a type
+  mismatch</dfn><p class=XXX>... <dfn id=suffering-from-a-pattern-mismatch>suffering from a pattern
   mismatch</dfn><p class=XXX>... <dfn id=suffering-from-being-too-long>suffering from being too
   long</dfn><p class=XXX>... <dfn id=suffering-from-an-underflow>suffering from an underflow</dfn><p class=XXX>... <dfn id=suffering-from-an-overflow>suffering from an overflow</dfn><p class=XXX>... <dfn id=suffering-from-a-step-mismatch>suffering from a step
   mismatch</dfn><h5 id=constraint-validation><span class=secno>4.10.15.2 </span>Constraint validation</h5><p>When the user agent is required to <dfn id=statically-validate-the-constraints>statically validate the
Received on Saturday, 4 October 2008 01:22:27 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:33:00 GMT