{{APIRef}} {{gecko_minversion_header("2.0")}}
The ValidityState
interface represents the validity states that an element can be in, with respect to constraint validation. Together, they help explain why an element's value fails to validate, if it's not valid.
Properties
For each of these Boolean properties, a value of true
indicates that the specified reason validation may have failed is true, with the exception of the valid property, which is true
if the element's value obeys all constraints.
Name | Type | Description |
---|---|---|
customError |
Boolean | The element's custom validity message has been set to a non-empty string by calling the element's setCustomValidity() method. |
badInput |
Boolean | The element has incomplete input and the user agent does not think the user ought to be able to submit the form in its current state. |
patternMismatch |
Boolean | The value does not match the specified {{htmlattrxref("pattern", "input")}}. |
rangeOverflow |
Boolean | The value is greater than the maximum specified by the {{htmlattrxref("max", "input")}} attribute. |
rangeUnderflow |
Boolean | The value is less than the minimum specified by the {{htmlattrxref("min", "input")}} attribute. |
stepMismatch |
Boolean | The value does not fit the rules determined by the {{htmlattrxref("step", "input")}} attribute (that is, it's not evenly divisible by the step value). |
tooLong |
Boolean |
The value exceeds the specified
Note: This will never be
true in Gecko, because elements' values are prevented from being longer than maxlength . |
typeMismatch |
Boolean | The value is not in the required syntax (when {{htmlattrxref("type", "input")}} is email or url ). |
valid |
Boolean | The element meets all constraint validations, and is therefore considered to be valid. |
valueMissing |
Boolean | The element has a {{htmlattrxref("required", "input")}} attribute, but no value. |