HTMLFieldSetElement: validity 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

HTMLFieldSetElement 介面的 **validity** 只讀屬性返回一個 ValidityState 物件,該物件表示此元素所處的有效性狀態。儘管 <fieldset> 元素永遠不是 約束驗證 的候選者,但如果設定了自定義有效性訊息,則有效性狀態仍然可能無效。

注意: <fieldset> 元素的 :valid:invalid CSS 偽類是根據其後代表單控制元件的有效性來應用的,而不是根據 fieldset 本身。

一個 ValidityState 物件。

示例

以下示例演示了當設定了 customError 時,<fieldset> 處於無效狀態;在此狀態下,checkValidity() 返回 true,而 validityStatevalidity 屬性為 false

js
const fieldSet = document.getElementById("myFieldSet");
fieldSet.setCustomValidity("This fieldset is invalid.");
const validityState = fieldSet.validity;
console.log(validityState.valid); // false
console.log(validityState.customError); // true
console.log(fieldSet.checkValidity()); // true

注意: <fieldset> 元素的 :valid:invalid CSS 偽類是根據其後代表單控制元件的有效性來應用的,而不是根據 fieldset 本身。

規範

規範
HTML
# the-constraint-validation-api:dom-cva-validity

瀏覽器相容性

另見