HTMLFieldSetElement: setCustomValidity() 方法

Baseline 已廣泛支援

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

setCustomValidity() 方法是 HTMLFieldSetElement 介面的一部分,用於為 <fieldset> 元素設定自定義有效性訊息。使用空字串表示該元素沒有自定義有效性錯誤。

<fieldset> 元素不是約束驗證的候選物件。reportValidity() 方法不會導致向用戶顯示自定義錯誤訊息,但會將其元素 ValidityState 物件的 customError 屬性設定為 true,並將 valid 屬性設定為 false

語法

js
setCustomValidity(string)

引數

string

包含錯誤訊息的字串。空字串會移除任何自定義有效性錯誤。

返回值

無(undefined)。

示例

js
const errorFieldSet = document.getElementById("checkErrors");
const errors = issuesToReport();
if (errors) {
  errorFieldSet.setCustomValidity("There is an error");
} else {
  errorFieldSet.setCustomValidity("");
}

規範

規範
HTML
# dom-cva-setcustomvalidity-dev

瀏覽器相容性

另見