HTML DOM
HTMLObjectElement 接口的 setCustomValidity() 方法设置元素的自定义校验消息。
语法
setCustomValidity(errorMessage)
参数
errorMessage- : 用于校验错误的消息。
返回值
无 (undefined)。
异常
无。
示例
在这个示例中,我们传入输入元素的 ID,并根据该值是缺失、过小或过大设置不同的错误消息。此外,你必须对同一元素调用 reportValidity 方法,否则什么事都不会发生。
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();
}
如果没有错误,将消息设置为空字符串是至关重要的。只要错误消息不为空,表单就不会验证通过,也不会被提交。
规范
浏览器兼容性
参见
- validityState
- validityState.valueMissing
- validityState.typeMismatch
- validityState.patternMismatch
- validityState.tooLong
- validityState.tooShort
- validityState.rangeUnderflow
- validityState.rangeOverflow
- validityState.stepMismatch
- validityState.valid
- validityState.customError
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
