ValidityState

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

プロパティ

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

badInput 読取専用
Boolean で、 true はブラウザーが処理できない入力値をユーザーが入力したことを示します。
customError 読取専用
Boolean で、その要素のカスタム検証メッセージが setCustomValidity() (en-US) メソッドによって空でない文字列に設定されているかどうかを示します。
patternMismatch 読取専用
Boolean で、 true は値が pattern の指定と一致しないことを示し、 false は一致することを示します。 true の場合、その要素は CSS の :invalid 擬似クラスに一致します。
rangeOverflow (en-US) 読取専用
Boolean で、 true は値が max 属性で指定された最大値を超えていることを示し、 false はその最大値以下である場合を示します。 true の場合、その要素は CSS の :invalid および :out-of-range の各擬似クラスに一致します。
rangeUnderflow (en-US) 読取専用
Boolean で、 true は値が min 属性で指定された最小値未満であることを示し、 false はその最小値以上であることを示します。 true の場合、その要素は CSS の :invalid および :out-of-range の各擬似クラスに一致します。
stepMismatch (en-US) 読取専用
Boolean で、 true は値が step 属性で決められた規則に合わないこと (つまり、step の値で割り切れないこと) を示し、 false は刻みの規則に合っていることを示します。 true の場合、その要素は CSS の :invalid および :out-of-range の各擬似クラスに一致します。
tooLong 読取専用
Boolean で、 true は値が HTMLInputElement または HTMLTextAreaElement オブジェクトの maxlength で指定された長さを超えていることを示し、 false は長さがその最長値以下であることを示します。 注: Gecko ではこのプロパティが true になることはありません。要素の値の長さが maxlength を超えないようになっているからです。 true の場合、その要素は CSS の :invalid および :out-of-range の各擬似クラスに一致します。
tooShort (en-US) 読取専用
Boolean で、 true は値が HTMLInputElement または HTMLTextAreaElement オブジェクトの minlength で指定された長さに満たないことを示し、 false は長さがその最短値以上であることを示します。 true の場合、その要素は CSS の :invalid および :out-of-range の各擬似クラスに一致します。
typeMismatch (en-US) 読取専用
Boolean で、 true は値が (typeemail または url の場合に) 要求された構文に合っていないことを示し、false は構文が正しいことを示します。 true の場合、その要素は CSS の :invalid 擬似クラスに一致します。
valid 読取専用
Boolean で、 true はその要素がすべての制約検証に適合し、合格したとみられることを示し、 false はいずれかの制約に適合しなかったことを示します。 true の場合、 CSS の :valid 擬似クラスに一致します。それ以外の場合は CSS の :invalid 擬似クラスに一致します。
valueMissing 読取専用
Boolean で、 true はその要素に required 属性があるものの、値がないことを示し、 false はそうではないことを示します。 true の場合、その要素は CSS の :invalid 擬似クラスに一致します。

仕様書

仕様書 状態 備考
HTML Living Standard
ValidityState の定義
現行の標準 現行の標準
HTML 5.1
ValidityState の定義
勧告 前回のスナップショット HTML5 から変更なし
HTML5
ValidityState の定義
勧告 このインターフェイスを含む HTML Living Standard の最初のスナップショット

ブラウザーの互換性

BCD tables only load in the browser

関連情報