ValidityState

ValidityState インターフェイスは、制約の検証に関して、要素が持つことになる妥当性の状態を表します。要素の値が不正な場合に、なぜ検証に失敗するのかを知る手がかりにもなります。

プロパティ

下記のプロパティはどれも真偽値を返します。true は指定された検証が失敗したことを表します。ただし valid プロパティの true だけは、要素の値が全ての制約に適合していることを表します。

ValidityState.badInput 読取専用

入力値をブラウザが処理できないことを示す Boolean です。

ValidityState.customError 読取専用

その要素のカスタム検証メッセージが、 setCustomValidity() メソッドによって空文字以外に設定されていることを示す Boolean です。

ValidityState.patternMismatch 読取専用

値が、指定された pattern と一致しないことを示す Boolean です。

ValidityState.rangeOverflow 読取専用

値が、 max 属性で指定された最大値を超えていることを示す Boolean です。

ValidityState.rangeUnderflow 読取専用

値が、min 属性で指定された最小値を下回っていることを示す Boolean です。

ValidityState.stepMismatch 読取専用

値が、step 属性で決められた規則に合わないことを示す Boolean です。(つまり、step の値で割り切れないことを表します)

ValidityState.tooLong 読取専用

値が、HTMLInputElement や HTMLTextAreaElement オブジェクトの maxlength を超えていることを示す Boolean です。
注: Gecko では maxlength より長い値はそもそも入力できないので、true になることは決してありません。

ValidityState.tooShort 読取専用

値が、HTMLInputElement や HTMLTextAreaElement オブジェクトの minlength を下回っていることを示す Boolean です。

ValidityState.typeMismatch 読取専用

値が、(type が email や url の場合に)求められる構文規則に従っていないことを示す Boolean です。

ValidityState.valid 読取専用

要素が全ての制約の検証に適合し、有効であることを示す Boolean です。

ValidityState.valueMissing 読取専用

required 属性が指定されているのに要素の値がないことを示す Boolean です。

仕様

ブラウザー実装状況

関連情報

• 制約の検証
• フォームデータの検証