[html5] r8210 - [agiow] (0) Add reportValidity(), which is like checkValidity() but triggers the [...]
whatwg at whatwg.org
whatwg at whatwg.org
Thu Oct 3 14:59:28 PDT 2013
Author: ianh
Date: 2013-10-03 14:59:26 -0700 (Thu, 03 Oct 2013)
New Revision: 8210
Modified:
complete.html
index
source
Log:
[agiow] (0) Add reportValidity(), which is like checkValidity() but triggers the browser's error-reporting UI as well
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=17826
Affected topics: DOM APIs, HTML
Modified: complete.html
===================================================================
--- complete.html 2013-10-03 19:25:56 UTC (rev 8209)
+++ complete.html 2013-10-03 21:59:26 UTC (rev 8210)
@@ -25518,6 +25518,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
<a href=#dom-object-caller title=dom-object-caller>legacycaller</a> any (any... arguments);
@@ -26116,7 +26117,7 @@
return the <code><a href=#windowproxy>WindowProxy</a></code> object of the <code><a href=#the-object-element>object</a></code> element's <a href=#nested-browsing-context>nested
browsing context</a>, if it has one; otherwise, it must return null.</p>
- <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-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <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-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
<a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-fae-form><a href=#dom-fae-form>form</a></code> IDL attribute
is part of the element's forms API.</p>
@@ -44427,6 +44428,7 @@
void <a href=#dom-form-submit title=dom-form-submit>submit</a>();
void <a href=#dom-form-reset title=dom-form-reset>reset</a>();
boolean <a href=#dom-form-checkvalidity title=dom-form-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-form-reportvalidity title=dom-form-reportValidity>reportValidity</a>();
};</pre>
</dd>
</dl><!--TOPIC:HTML--><p>The <code><a href=#the-form-element>form</a></code> element <a href=#represents>represents</a> a collection of <a href=#form-associated-element title="form-associated element">form-associated elements</a>, some of which can represent
@@ -44526,6 +44528,14 @@
</dd>
+ <dt><var title="">form</var> . <code title=dom-form-reportValidity><a href=#dom-form-reportvalidity>reportValidity</a></code>()</dt>
+
+ <dd>
+
+ <p>Returns true if the form's controls are all valid; otherwise, returns false and informs the user.</p>
+
+ </dd>
+
</dl><div class=impl>
<p>The <dfn id=dom-form-autocomplete title=dom-form-autocomplete><code>autocomplete</code></dfn> IDL attribute must
@@ -44711,6 +44721,11 @@
<code><a href=#the-form-element>form</a></code> element, and return true if the constraint validation return a <i>positive</i>
result, and false if it returned a <i>negative</i> result.</p>
+ <p>If the <dfn id=dom-form-reportvalidity title=dom-form-reportValidity><code>reportValidity()</code></dfn> method is
+ invoked, the user agent must <a href=#interactively-validate-the-constraints>interactively validate the constraints</a> of the
+ <code><a href=#the-form-element>form</a></code> element, and return true if the constraint validation return a <i>positive</i>
+ result, and false if it returned a <i>negative</i> result.</p>
+
</div>
<!--TOPIC:HTML-->
@@ -44763,6 +44778,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
};</pre>
</dd>
@@ -44809,7 +44825,7 @@
<code><a href=#htmlformcontrolscollection>HTMLFormControlsCollection</a></code> rooted at the <code><a href=#the-fieldset-element>fieldset</a></code> element, whose filter
matches <a href=#category-listed title=category-listed>listed elements</a>.</p>
- <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-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <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-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
<a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-fae-form><a href=#dom-fae-form>form</a></code> and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the element's forms API.</p>
</div>
@@ -45167,6 +45183,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -46493,7 +46510,7 @@
<p>On setting, they must act as if they <a href=#reflect title=reflect>reflected</a> the respective
content attributes of the same name.</p>
- <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> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <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> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
<a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL
attribute provides a list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-textarea/input-select><a href=#dom-textarea/input-select>select()</a></code>, <code title=dom-textarea/input-selectionStart><a href=#dom-textarea/input-selectionstart>selectionStart</a></code>, <code title=dom-textarea/input-selectionEnd><a href=#dom-textarea/input-selectionend>selectionEnd</a></code>, <code title=dom-textarea/input-selectionDirection><a href=#dom-textarea/input-selectiondirection>selectionDirection</a></code>, <code title=dom-textarea/input-setRangeText><a href=#dom-textarea/input-setrangetext>setRangeText()</a></code>, and <code title=dom-textarea/input-setSelectionRange><a href=#dom-textarea/input-setselectionrange>setSelectionRange()</a></code> methods and IDL attributes
expose the element's text selection. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the element's forms API.</p>
@@ -50691,6 +50708,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -50827,7 +50845,7 @@
state">popup menu</a> state; otherwise, the element has no <a href=#designated-pop-up-menu>designated pop-up
menu</a>.</p>
- <hr><p>The <dfn id=dom-button-value title=dom-button-value><code>value</code></dfn> and <dfn id=dom-button-menu title=dom-button-menu><code>menu</code></dfn> IDL attributes must <a href=#reflect>reflect</a> the
+ <hr><!--CLEANUP--><p>The <dfn id=dom-button-value title=dom-button-value><code>value</code></dfn> and <dfn id=dom-button-menu title=dom-button-menu><code>menu</code></dfn> IDL attributes must <a href=#reflect>reflect</a> the
content attributes of the same name.</p>
<p>The <dfn id=dom-button-type title=dom-button-type><code>type</code></dfn> IDL
@@ -50835,7 +50853,7 @@
same name, <a href=#limited-to-only-known-values>limited to only known values</a>.</p>
<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> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
+ attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
<code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the
@@ -50911,6 +50929,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -51226,7 +51245,7 @@
the absence of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute, is either 1 or 4
depending on the presence of the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute.</p>
- <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> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <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> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
<a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL
attribute provides a list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are
part of the element's forms API.</p>
@@ -51772,6 +51791,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -52132,7 +52152,7 @@
value</a>.</p>
<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> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
+ attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
<code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-textarea/input-select><a href=#dom-textarea/input-select>select()</a></code>, <code title=dom-textarea/input-selectionStart><a href=#dom-textarea/input-selectionstart>selectionStart</a></code>,
@@ -52238,6 +52258,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -52454,7 +52475,7 @@
attribute must return the value "<code title="">keygen</code>".</p>
<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> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
+ attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
<code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the
@@ -52529,6 +52550,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -52641,7 +52663,7 @@
IDL attribute must <a href=#reflect>reflect</a> the <code title=attr-output-for><a href=#attr-output-for>for</a></code> content attribute.</p>
<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> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
+ attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
<code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fae-form><a href=#dom-fae-form>form</a></code> and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the
@@ -53188,6 +53210,7 @@
</div>
+<!--CLEANUP-->
<h4 id=form-control-infrastructure><span class=secno>4.10.18 </span>Form control infrastructure</h4>
@@ -55468,6 +55491,15 @@
</dd>
+ <dt><var title="">valid</var> = <var title="">element</var> . <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity</a></code>()</dt>
+
+ <dd>
+
+ <p>Returns true if the element's value has no validity problems; otherwise, returns
+ false, fires an <code title=event-invalid>invalid</code> event at the element, and (if the event isn't canceled) reports the problem to the user.</p>
+
+ </dd>
+
<dt><var title="">element</var> . <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code></dt>
<dd>
@@ -55477,7 +55509,7 @@
</dd>
- </dl><div class=impl>
+ </dl><!--CLEANUP--><div class=impl>
<p>The <dfn id=dom-cva-willvalidate title=dom-cva-willValidate><code>willValidate</code></dfn>
attribute must return true if an element is a <a href=#candidate-for-constraint-validation>candidate for
@@ -55584,6 +55616,18 @@
false. Otherwise, it must only return true without doing anything
else.</p>
+ <p>When the <dfn id=dom-cva-reportvalidity title=dom-cva-reportValidity><code>reportValidity()</code></dfn> method is
+ invoked, if the element is a <a href=#candidate-for-constraint-validation>candidate for constraint validation</a> and does not <a href=#concept-fv-valid title=concept-fv-valid>satisfy its constraints</a>, the user agent must: <a href=#fire-a-simple-event>fire a simple
+ event</a> named <code title=event-invalid>invalid</code> that is cancelable at the element,
+ and if that event is not canceled, report the problems with the constraints of that element to the
+ user; then, return false. Otherwise, it must only return true without doing anything else. When
+ reporting the problem with the constraints to the user, the user agent may run the <a href=#focusing-steps>focusing
+ steps</a> for that element, and may change the scrolling position of the document, or perform
+ some other action that brings the element to the user's attention. User agents may report more
+ than one constraint violation, if the element suffers from multiple problems at once. If the
+ element is not <a href=#being-rendered>being rendered</a>, then the user agent may, instead of notifying the
+ user, report a script error.</p>
+
<p>The <dfn id=dom-cva-validationmessage title=dom-cva-validationMessage><code>validationMessage</code></dfn>
attribute must return the empty string if the element is not a
<a href=#candidate-for-constraint-validation>candidate for constraint validation</a> or if it is one but
Modified: index
===================================================================
--- index 2013-10-03 19:25:56 UTC (rev 8209)
+++ index 2013-10-03 21:59:26 UTC (rev 8210)
@@ -25518,6 +25518,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
<a href=#dom-object-caller title=dom-object-caller>legacycaller</a> any (any... arguments);
@@ -26116,7 +26117,7 @@
return the <code><a href=#windowproxy>WindowProxy</a></code> object of the <code><a href=#the-object-element>object</a></code> element's <a href=#nested-browsing-context>nested
browsing context</a>, if it has one; otherwise, it must return null.</p>
- <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-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <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-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
<a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-fae-form><a href=#dom-fae-form>form</a></code> IDL attribute
is part of the element's forms API.</p>
@@ -44427,6 +44428,7 @@
void <a href=#dom-form-submit title=dom-form-submit>submit</a>();
void <a href=#dom-form-reset title=dom-form-reset>reset</a>();
boolean <a href=#dom-form-checkvalidity title=dom-form-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-form-reportvalidity title=dom-form-reportValidity>reportValidity</a>();
};</pre>
</dd>
</dl><!--TOPIC:HTML--><p>The <code><a href=#the-form-element>form</a></code> element <a href=#represents>represents</a> a collection of <a href=#form-associated-element title="form-associated element">form-associated elements</a>, some of which can represent
@@ -44526,6 +44528,14 @@
</dd>
+ <dt><var title="">form</var> . <code title=dom-form-reportValidity><a href=#dom-form-reportvalidity>reportValidity</a></code>()</dt>
+
+ <dd>
+
+ <p>Returns true if the form's controls are all valid; otherwise, returns false and informs the user.</p>
+
+ </dd>
+
</dl><div class=impl>
<p>The <dfn id=dom-form-autocomplete title=dom-form-autocomplete><code>autocomplete</code></dfn> IDL attribute must
@@ -44711,6 +44721,11 @@
<code><a href=#the-form-element>form</a></code> element, and return true if the constraint validation return a <i>positive</i>
result, and false if it returned a <i>negative</i> result.</p>
+ <p>If the <dfn id=dom-form-reportvalidity title=dom-form-reportValidity><code>reportValidity()</code></dfn> method is
+ invoked, the user agent must <a href=#interactively-validate-the-constraints>interactively validate the constraints</a> of the
+ <code><a href=#the-form-element>form</a></code> element, and return true if the constraint validation return a <i>positive</i>
+ result, and false if it returned a <i>negative</i> result.</p>
+
</div>
<!--TOPIC:HTML-->
@@ -44763,6 +44778,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
};</pre>
</dd>
@@ -44809,7 +44825,7 @@
<code><a href=#htmlformcontrolscollection>HTMLFormControlsCollection</a></code> rooted at the <code><a href=#the-fieldset-element>fieldset</a></code> element, whose filter
matches <a href=#category-listed title=category-listed>listed elements</a>.</p>
- <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-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <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-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
<a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-fae-form><a href=#dom-fae-form>form</a></code> and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the element's forms API.</p>
</div>
@@ -45167,6 +45183,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -46493,7 +46510,7 @@
<p>On setting, they must act as if they <a href=#reflect title=reflect>reflected</a> the respective
content attributes of the same name.</p>
- <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> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <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> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
<a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL
attribute provides a list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-textarea/input-select><a href=#dom-textarea/input-select>select()</a></code>, <code title=dom-textarea/input-selectionStart><a href=#dom-textarea/input-selectionstart>selectionStart</a></code>, <code title=dom-textarea/input-selectionEnd><a href=#dom-textarea/input-selectionend>selectionEnd</a></code>, <code title=dom-textarea/input-selectionDirection><a href=#dom-textarea/input-selectiondirection>selectionDirection</a></code>, <code title=dom-textarea/input-setRangeText><a href=#dom-textarea/input-setrangetext>setRangeText()</a></code>, and <code title=dom-textarea/input-setSelectionRange><a href=#dom-textarea/input-setselectionrange>setSelectionRange()</a></code> methods and IDL attributes
expose the element's text selection. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the element's forms API.</p>
@@ -50691,6 +50708,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -50827,7 +50845,7 @@
state">popup menu</a> state; otherwise, the element has no <a href=#designated-pop-up-menu>designated pop-up
menu</a>.</p>
- <hr><p>The <dfn id=dom-button-value title=dom-button-value><code>value</code></dfn> and <dfn id=dom-button-menu title=dom-button-menu><code>menu</code></dfn> IDL attributes must <a href=#reflect>reflect</a> the
+ <hr><!--CLEANUP--><p>The <dfn id=dom-button-value title=dom-button-value><code>value</code></dfn> and <dfn id=dom-button-menu title=dom-button-menu><code>menu</code></dfn> IDL attributes must <a href=#reflect>reflect</a> the
content attributes of the same name.</p>
<p>The <dfn id=dom-button-type title=dom-button-type><code>type</code></dfn> IDL
@@ -50835,7 +50853,7 @@
same name, <a href=#limited-to-only-known-values>limited to only known values</a>.</p>
<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> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
+ attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
<code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the
@@ -50911,6 +50929,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -51226,7 +51245,7 @@
the absence of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute, is either 1 or 4
depending on the presence of the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute.</p>
- <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> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <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> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
<a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL
attribute provides a list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are
part of the element's forms API.</p>
@@ -51772,6 +51791,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -52132,7 +52152,7 @@
value</a>.</p>
<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> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
+ attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
<code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-textarea/input-select><a href=#dom-textarea/input-select>select()</a></code>, <code title=dom-textarea/input-selectionStart><a href=#dom-textarea/input-selectionstart>selectionStart</a></code>,
@@ -52238,6 +52258,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -52454,7 +52475,7 @@
attribute must return the value "<code title="">keygen</code>".</p>
<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> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
+ attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
<code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the
@@ -52529,6 +52550,7 @@
readonly attribute <a href=#validitystate>ValidityState</a> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidity title=dom-cva-checkValidity>checkValidity</a>();
+ boolean <a href=#dom-cva-reportvalidity title=dom-cva-reportValidity>reportValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(DOMString error);
readonly attribute <a href=#nodelist>NodeList</a> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
@@ -52641,7 +52663,7 @@
IDL attribute must <a href=#reflect>reflect</a> the <code title=attr-output-for><a href=#attr-output-for>for</a></code> content attribute.</p>
<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> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
+ attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code>, <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity()</a></code>, and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
<code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fae-form><a href=#dom-fae-form>form</a></code> and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the
@@ -53188,6 +53210,7 @@
</div>
+<!--CLEANUP-->
<h4 id=form-control-infrastructure><span class=secno>4.10.18 </span>Form control infrastructure</h4>
@@ -55468,6 +55491,15 @@
</dd>
+ <dt><var title="">valid</var> = <var title="">element</var> . <code title=dom-cva-reportValidity><a href=#dom-cva-reportvalidity>reportValidity</a></code>()</dt>
+
+ <dd>
+
+ <p>Returns true if the element's value has no validity problems; otherwise, returns
+ false, fires an <code title=event-invalid>invalid</code> event at the element, and (if the event isn't canceled) reports the problem to the user.</p>
+
+ </dd>
+
<dt><var title="">element</var> . <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code></dt>
<dd>
@@ -55477,7 +55509,7 @@
</dd>
- </dl><div class=impl>
+ </dl><!--CLEANUP--><div class=impl>
<p>The <dfn id=dom-cva-willvalidate title=dom-cva-willValidate><code>willValidate</code></dfn>
attribute must return true if an element is a <a href=#candidate-for-constraint-validation>candidate for
@@ -55584,6 +55616,18 @@
false. Otherwise, it must only return true without doing anything
else.</p>
+ <p>When the <dfn id=dom-cva-reportvalidity title=dom-cva-reportValidity><code>reportValidity()</code></dfn> method is
+ invoked, if the element is a <a href=#candidate-for-constraint-validation>candidate for constraint validation</a> and does not <a href=#concept-fv-valid title=concept-fv-valid>satisfy its constraints</a>, the user agent must: <a href=#fire-a-simple-event>fire a simple
+ event</a> named <code title=event-invalid>invalid</code> that is cancelable at the element,
+ and if that event is not canceled, report the problems with the constraints of that element to the
+ user; then, return false. Otherwise, it must only return true without doing anything else. When
+ reporting the problem with the constraints to the user, the user agent may run the <a href=#focusing-steps>focusing
+ steps</a> for that element, and may change the scrolling position of the document, or perform
+ some other action that brings the element to the user's attention. User agents may report more
+ than one constraint violation, if the element suffers from multiple problems at once. If the
+ element is not <a href=#being-rendered>being rendered</a>, then the user agent may, instead of notifying the
+ user, report a script error.</p>
+
<p>The <dfn id=dom-cva-validationmessage title=dom-cva-validationMessage><code>validationMessage</code></dfn>
attribute must return the empty string if the element is not a
<a href=#candidate-for-constraint-validation>candidate for constraint validation</a> or if it is one but
Modified: source
===================================================================
--- source 2013-10-03 19:25:56 UTC (rev 8209)
+++ source 2013-10-03 21:59:26 UTC (rev 8210)
@@ -26894,6 +26894,7 @@
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidity">checkValidity</span>();
+ boolean <span title="dom-cva-reportValidity">reportValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(DOMString error);
<span title="dom-object-caller">legacycaller</span> any (any... arguments);
@@ -27564,7 +27565,8 @@
<p>The <code title="dom-cva-willValidate">willValidate</code>, <code
title="dom-cva-validity">validity</code>, and <code
title="dom-cva-validationMessage">validationMessage</code> attributes, and the <code
- title="dom-cva-checkValidity">checkValidity()</code> and <code
+ title="dom-cva-checkValidity">checkValidity()</code>, <code
+ title="dom-cva-reportValidity">reportValidity()</code>, and <code
title="dom-cva-setCustomValidity">setCustomValidity()</code> methods, are part of the
<span>constraint validation API</span>. The <code title="dom-fae-form">form</code> IDL attribute
is part of the element's forms API.</p>
@@ -48639,6 +48641,7 @@
void <span title="dom-form-submit">submit</span>();
void <span title="dom-form-reset">reset</span>();
boolean <span title="dom-form-checkValidity">checkValidity</span>();
+ boolean <span title="dom-form-reportValidity">reportValidity</span>();
};</pre>
</dd>
</dl><!--TOPIC:HTML-->
@@ -48752,6 +48755,14 @@
</dd>
+ <dt><var title="">form</var> . <code title="dom-form-reportValidity">reportValidity</code>()</dt>
+
+ <dd>
+
+ <p>Returns true if the form's controls are all valid; otherwise, returns false and informs the user.</p>
+
+ </dd>
+
</dl>
<div class="impl">
@@ -48980,6 +48991,11 @@
<code>form</code> element, and return true if the constraint validation return a <i>positive</i>
result, and false if it returned a <i>negative</i> result.</p>
+ <p>If the <dfn title="dom-form-reportValidity"><code>reportValidity()</code></dfn> method is
+ invoked, the user agent must <span>interactively validate the constraints</span> of the
+ <code>form</code> element, and return true if the constraint validation return a <i>positive</i>
+ result, and false if it returned a <i>negative</i> result.</p>
+
</div>
<!--TOPIC:HTML-->
@@ -49031,6 +49047,7 @@
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidity">checkValidity</span>();
+ boolean <span title="dom-cva-reportValidity">reportValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(DOMString error);
};</pre>
</dd>
@@ -49087,7 +49104,8 @@
<p>The <code title="dom-cva-willValidate">willValidate</code>, <code
title="dom-cva-validity">validity</code>, and <code
title="dom-cva-validationMessage">validationMessage</code> attributes, and the <code
- title="dom-cva-checkValidity">checkValidity()</code> and <code
+ title="dom-cva-checkValidity">checkValidity()</code>, <code
+ title="dom-cva-reportValidity">reportValidity()</code>, and <code
title="dom-cva-setCustomValidity">setCustomValidity()</code> methods, are part of the
<span>constraint validation API</span>. The <code title="dom-fae-form">form</code> and <code
title="dom-fe-name">name</code> IDL attributes are part of the element's forms API.</p>
@@ -49466,6 +49484,7 @@
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidity">checkValidity</span>();
+ boolean <span title="dom-cva-reportValidity">reportValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(DOMString error);
readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
@@ -50959,7 +50978,8 @@
<p>The <code title="dom-cva-willValidate">willValidate</code>, <code
title="dom-cva-validity">validity</code>, and <code
title="dom-cva-validationMessage">validationMessage</code> IDL attributes, and the <code
- title="dom-cva-checkValidity">checkValidity()</code> and <code
+ title="dom-cva-checkValidity">checkValidity()</code>, <code
+ title="dom-cva-reportValidity">reportValidity()</code>, and <code
title="dom-cva-setCustomValidity">setCustomValidity()</code> methods, are part of the
<span>constraint validation API</span>. The <code title="dom-lfe-labels">labels</code> IDL
attribute provides a list of the element's <code>label</code>s. The <code
@@ -55609,6 +55629,7 @@
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidity">checkValidity</span>();
+ boolean <span title="dom-cva-reportValidity">reportValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(DOMString error);
readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
@@ -55793,6 +55814,7 @@
<hr>
+<!--CLEANUP-->
<p>The <dfn title="dom-button-value"><code>value</code></dfn> and <dfn
title="dom-button-menu"><code>menu</code></dfn> IDL attributes must <span>reflect</span> the
content attributes of the same name.</p>
@@ -55805,7 +55827,8 @@
title="dom-cva-validity">validity</code>, and <code
title="dom-cva-validationMessage">validationMessage</code> IDL
attributes, and the <code
- title="dom-cva-checkValidity">checkValidity()</code> and <code
+ title="dom-cva-checkValidity">checkValidity()</code>, <code
+ title="dom-cva-reportValidity">reportValidity()</code>, and <code
title="dom-cva-setCustomValidity">setCustomValidity()</code>
methods, are part of the <span>constraint validation API</span>. The
<code title="dom-lfe-labels">labels</code> IDL attribute provides a
@@ -55885,6 +55908,7 @@
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidity">checkValidity</span>();
+ boolean <span title="dom-cva-reportValidity">reportValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(DOMString error);
readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
@@ -56263,7 +56287,8 @@
<p>The <code title="dom-cva-willValidate">willValidate</code>, <code
title="dom-cva-validity">validity</code>, and <code
title="dom-cva-validationMessage">validationMessage</code> IDL attributes, and the <code
- title="dom-cva-checkValidity">checkValidity()</code> and <code
+ title="dom-cva-checkValidity">checkValidity()</code>, <code
+ title="dom-cva-reportValidity">reportValidity()</code>, and <code
title="dom-cva-setCustomValidity">setCustomValidity()</code> methods, are part of the
<span>constraint validation API</span>. The <code title="dom-lfe-labels">labels</code> IDL
attribute provides a list of the element's <code>label</code>s. The <code
@@ -56840,6 +56865,7 @@
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidity">checkValidity</span>();
+ boolean <span title="dom-cva-reportValidity">reportValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(DOMString error);
readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
@@ -57285,7 +57311,8 @@
title="dom-cva-validity">validity</code>, and <code
title="dom-cva-validationMessage">validationMessage</code> IDL
attributes, and the <code
- title="dom-cva-checkValidity">checkValidity()</code> and <code
+ title="dom-cva-checkValidity">checkValidity()</code>, <code
+ title="dom-cva-reportValidity">reportValidity()</code>, and <code
title="dom-cva-setCustomValidity">setCustomValidity()</code>
methods, are part of the <span>constraint validation API</span>. The
<code title="dom-lfe-labels">labels</code> IDL attribute provides a
@@ -57399,6 +57426,7 @@
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidity">checkValidity</span>();
+ boolean <span title="dom-cva-reportValidity">reportValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(DOMString error);
readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
@@ -57670,7 +57698,8 @@
title="dom-cva-validity">validity</code>, and <code
title="dom-cva-validationMessage">validationMessage</code> IDL
attributes, and the <code
- title="dom-cva-checkValidity">checkValidity()</code> and <code
+ title="dom-cva-checkValidity">checkValidity()</code>, <code
+ title="dom-cva-reportValidity">reportValidity()</code>, and <code
title="dom-cva-setCustomValidity">setCustomValidity()</code>
methods, are part of the <span>constraint validation API</span>. The
<code title="dom-lfe-labels">labels</code> IDL attribute provides a
@@ -57749,6 +57778,7 @@
readonly attribute <span>ValidityState</span> <span title="dom-cva-validity">validity</span>;
readonly attribute DOMString <span title="dom-cva-validationMessage">validationMessage</span>;
boolean <span title="dom-cva-checkValidity">checkValidity</span>();
+ boolean <span title="dom-cva-reportValidity">reportValidity</span>();
void <span title="dom-cva-setCustomValidity">setCustomValidity</span>(DOMString error);
readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
@@ -57884,7 +57914,8 @@
title="dom-cva-validity">validity</code>, and <code
title="dom-cva-validationMessage">validationMessage</code> IDL
attributes, and the <code
- title="dom-cva-checkValidity">checkValidity()</code> and <code
+ title="dom-cva-checkValidity">checkValidity()</code>, <code
+ title="dom-cva-reportValidity">reportValidity()</code>, and <code
title="dom-cva-setCustomValidity">setCustomValidity()</code>
methods, are part of the <span>constraint validation API</span>. The
<code title="dom-lfe-labels">labels</code> IDL attribute provides a
@@ -58484,6 +58515,7 @@
</div>
+<!--CLEANUP-->
<h4>Form control infrastructure</h4>
@@ -61216,6 +61248,16 @@
</dd>
+ <dt><var title="">valid</var> = <var title="">element</var> . <code title="dom-cva-reportValidity">reportValidity</code>()</dt>
+
+ <dd>
+
+ <p>Returns true if the element's value has no validity problems; otherwise, returns
+ false, fires an <code
+ title="event-invalid">invalid</code> event at the element, and (if the event isn't canceled) reports the problem to the user.</p>
+
+ </dd>
+
<dt><var title="">element</var> . <code title="dom-cva-validationMessage">validationMessage</code></dt>
<dd>
@@ -61227,6 +61269,7 @@
</dl>
+<!--CLEANUP-->
<div class="impl">
<p>The <dfn
@@ -61345,6 +61388,19 @@
false. Otherwise, it must only return true without doing anything
else.</p>
+ <p>When the <dfn title="dom-cva-reportValidity"><code>reportValidity()</code></dfn> method is
+ invoked, if the element is a <span>candidate for constraint validation</span> and does not <span
+ title="concept-fv-valid">satisfy its constraints</span>, the user agent must: <span>fire a simple
+ event</span> named <code title="event-invalid">invalid</code> that is cancelable at the element,
+ and if that event is not canceled, report the problems with the constraints of that element to the
+ user; then, return false. Otherwise, it must only return true without doing anything else. When
+ reporting the problem with the constraints to the user, the user agent may run the <span>focusing
+ steps</span> for that element, and may change the scrolling position of the document, or perform
+ some other action that brings the element to the user's attention. User agents may report more
+ than one constraint violation, if the element suffers from multiple problems at once. If the
+ element is not <span>being rendered</span>, then the user agent may, instead of notifying the
+ user, report a script error.</p>
+
<p>The <dfn
title="dom-cva-validationMessage"><code>validationMessage</code></dfn>
attribute must return the empty string if the element is not a
More information about the Commit-Watchers
mailing list