ValidityState
ValidityState インターフェイスは、制約の検証に関して、要素が取りうる妥当性の状態を表します。要素の値が不正な場合、なぜ検証に失敗したのかを知る手がかりにもなります。
インスタンスプロパティ
下記のプロパティはどれも論理値を返します。true は指定された検証が失敗したことを表します。ただし valid プロパティだけは例外で、 true が要素の値がすべての制約に適合していることを表します。
badInput読取専用-
論理値で、
trueはブラウザーが処理できない入力値をユーザーが入力したことを示します。 customError読取専用-
論理値で、その要素のカスタム検証メッセージが
setCustomValidity()メソッドによって空でない文字列に設定されているかどうかを示します。 patternMismatch読取専用-
論理値で、
trueは値がpatternの指定と一致しないことを示し、falseは一致することを示します。trueの場合、その要素は CSS の:invalid擬似クラスに一致します。 rangeOverflow読取専用-
論理値で、
trueは値がmax属性で指定された最大値を超えていることを示し、falseはその最大値以下である場合を示します。trueの場合、その要素は CSS の:invalidおよび:out-of-rangeの各擬似クラスに一致します。 rangeUnderflow読取専用-
論理値で、
trueは値がmin属性で指定された最小値未満であることを示し、falseはその最小値以上であることを示します。trueの場合、その要素は CSS の:invalidおよび:out-of-rangeの各擬似クラスに一致します。 stepMismatch読取専用-
論理値で、
trueは値がstep属性で決められた規則に合わないこと (つまり、step の値で割り切れないこと) を示し、falseは刻みの規則に合っていることを示します。trueの場合、その要素は CSS の:invalidおよび:out-of-rangeの各擬似クラスに一致します。 tooLong読取専用-
論理値で、
trueは値がHTMLInputElementまたはHTMLTextAreaElementオブジェクトのmaxlengthで指定された長さを超えていることを示し、falseは長さがその最長値以下であることを示します。 注: Gecko ではこのプロパティがtrueになることはありません。要素の値の長さがmaxlengthを超えないようになっているからです。trueの場合、その要素は CSS の:invalidおよび:out-of-rangeの各擬似クラスに一致します。 tooShort読取専用-
論理値で、
trueは値がHTMLInputElementまたはHTMLTextAreaElementオブジェクトのminlengthで指定された長さに満たないことを示し、falseは長さがその最短値以上であることを示します。trueの場合、その要素は CSS の:invalidおよび:out-of-rangeの各擬似クラスに一致します。 typeMismatch読取専用-
論理値で、
trueは値が (typeがemailまたはurlの場合に) 要求された構文に合っていないことを示し、falseは構文が正しいことを示します。trueの場合、その要素は CSS の:invalid擬似クラスに一致します。 valid読取専用-
論理値で、
trueはその要素がすべての制約検証に適合し、合格したとみられることを示し、falseはいずれかの制約に適合しなかったことを示します。trueの場合、 CSS の:valid擬似クラスに一致します。それ以外の場合は CSS の:invalid擬似クラスに一致します。 valueMissing読取専用-
論理値で、
trueはその要素にrequired属性があるものの、値がないことを示し、falseはそうではないことを示します。trueの場合、その要素は CSS の:invalid擬似クラスに一致します。
仕様書
| Specification |
|---|
| HTML Standard # the-constraint-validation-api:validitystate-3 |
ブラウザーの互換性
BCD tables only load in the browser