← 返回首页
HTMLObjectElement:setCustomValidity() 方法 - Web API | MDN

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

HTMLObjectElement:setCustomValidity() 方法

基线 广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

HTMLObjectElement 接口的 setCustomValidity() 方法设置元素的自定义校验消息。

本文内容

语法

js
setCustomValidity(errorMessage)

参数

errorMessage

用于校验错误的消息。

返回值

无 (undefined)。

异常

无。

示例

在这个示例中,我们传入输入元素的 ID,并根据该值是缺失、过小或过大设置不同的错误消息。此外,你必须对同一元素调用 reportValidity 方法,否则什么事都不会发生。

js
function validate(inputID) { const input = document.getElementById(inputID); const validityState = input.validity; if (validityState.valueMissing) { input.setCustomValidity("你必须填满这个,哟!"); } else if (validityState.rangeUnderflow) { input.setCustomValidity("我们需要一个更大的数字!"); } else if (validityState.rangeOverflow) { input.setCustomValidity("太大了!"); } else { input.setCustomValidity(""); } input.reportValidity(); }

如果没有错误,将消息设置为空字符串是至关重要的。只要错误消息不为空,表单就不会验证通过,也不会被提交。

规范

规范
HTML
# dom-cva-setcustomvalidity-dev

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见