HTMLButtonElement: validity プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2018.

validityHTMLButtonElement インターフェイスの読み取り専用プロパティで、この要素の有効状態を表す ValidityState オブジェクトを返します。

ValidityState オブジェクトです。

次の例は、 <button>customError が設定されている場合、不正な状態にあることを示しています。この状態では、validityStatevalidity プロパティは false ですが、checkValidity() は、ボタンの type"submit" でない場合、制約検証の対象ではないため、true を返します。

js
const button = document.getElementById("myButton");
button.setCustomValidity("This button is invalid.");
const validityState = button.validity;
console.log(validityState.valid); // false
console.log(validityState.customError); // true
console.log(button.checkValidity()); // ボタンの種類が "submit" の場合は false、そうでなければ true

仕様書

Specification
HTML Standard
# the-constraint-validation-api:dom-cva-validity

ブラウザーの互換性

BCD tables only load in the browser

関連情報