HTMLButtonElement: setCustomValidity() 方法

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

setCustomValidity() 方法是 HTMLButtonElement 接口的一部分，用于为 <button> 元素设置自定义的有效性消息。使用空字符串表示该元素没有自定义的有效性错误。

语法

setCustomValidity(string)

参数

string: 包含错误消息的字符串。空字符串会移除任何自定义有效性错误。

返回值

无（undefined）。

示例

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

规范

规范
HTML # dom-cva-setcustomvalidity-dev

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改时间为 2025年4月10日，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的问题