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

浏览器兼容性

另见