ValidityState
HTML DOM
HTML DOM
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.
Instance properties
Each validity state is represented by a Boolean property. A value of true indicates that the corresponding validation constraint has failed, except for the valid property, which is true when the element's value obeys all constraints.
- badInput
- : A boolean value that is
trueif the user has provided input that the browser is unable to convert. - customError
- : A boolean value indicating whether the element's custom validity message has been set to a non-empty string by calling the element's setCustomValidity() method.
- patternMismatch
- : A boolean value that is
trueif the value does not match the specifiedpattern, andfalseif it does match. Iftrue, the element matches the :invalid CSS pseudo-class. - rangeOverflow
- : A boolean value that is
trueif the value is greater than the maximum specified by themaxattribute, orfalseif it is less than or equal to the maximum. Iftrue, the element matches the :invalid and :out-of-range and CSS pseudo-classes. - rangeUnderflow
- : A boolean value that is
trueif the value is less than the minimum specified by theminattribute, orfalseif it is greater than or equal to the minimum. Iftrue, the element matches the :invalid and :out-of-range CSS pseudo-classes. - stepMismatch
- : A boolean value that is
trueif the value does not fit the rules determined by thestepattribute (that is, it's not evenly divisible by the step value), orfalseif it does fit the step rule. Iftrue, the element matches the :invalid CSS pseudo-class. - tooLong
- : A boolean value that is
trueif the value exceeds the specifiedmaxlengthfor HTMLInputElement or HTMLTextAreaElement objects, orfalseif its length is less than or equal to the maximum length. Note: This property is nevertruein Gecko, because elements' values are prevented from being longer thanmaxlength. Iftrue, the element matches the :invalid and :out-of-range CSS pseudo-classes. - tooShort
- : A boolean value that is
trueif the value fails to meet the specifiedminlengthfor HTMLInputElement or HTMLTextAreaElement objects, orfalseif its length is greater than or equal to the minimum length. Iftrue, the element matches the :invalid and :out-of-range CSS pseudo-classes. - typeMismatch
- : A boolean value that is
trueif the value is not in the required syntax (whentypeisemailorurl), orfalseif the syntax is correct. Iftrue, the element matches the :invalid CSS pseudo-class. - valid
- : A boolean value that is
trueif the element meets all its validation constraints, and is therefore considered to be valid, orfalseif it fails any constraint. Iftrue, the element matches the :valid CSS pseudo-class; the :invalid CSS pseudo-class otherwise. - valueMissing
- : A boolean value that is
trueif the element has arequiredattribute, but no value, orfalseotherwise. Iftrue, the element matches the :invalid CSS pseudo-class.