ValidityState是H5表单中用于精确判断控件校验状态的核心接口,通过valueMissing、typeMismatch等布尔属性暴露失败原因,配合setCustomValidity可实现可控提示。

在 H5 表单中,ValidityState 对象是浏览器原生提供的、用于精确判断表单控件(如 <input>、<textarea></textarea>、<select></select>)校验状态的核心接口。它不直接返回错误消息,而是通过一组布尔属性暴露具体的失败原因,配合 element.validationMessage 或自定义逻辑,就能精准定位并提示用户问题所在。
ValidityState 的关键属性含义
element.validity 返回一个 ValidityState 实例,其常见属性如下(均为只读布尔值):
-
valueMissing:必填字段为空(required为 true 且无输入) -
typeMismatch:输入类型不匹配(如type="email"但输入了abc) -
patternMismatch:不符合pattern正则规则 -
tooShort:长度小于minLength -
tooLong:长度大于maxLength -
rangeUnderflow:数值或日期小于min -
rangeOverflow:数值或日期大于max -
stepMismatch:不符合step步长(如type="number" step="0.5"输入了1.2) -
badInput:用户输入了浏览器无法解析的值(如type="number"输入了abc) -
customError:调用了setCustomValidity("msg")且传入非空字符串
如何用 ValidityState 获取具体失败原因
只需遍历上述属性,找出第一个为 true 的项即可——因为浏览器按优先级顺序触发校验,首个 true 属性即当前最优先的失败原因:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
function getValidationReason(input) {
const validity = input.validity;
if (validity.customError) return 'customError';
if (validity.valueMissing) return 'valueMissing';
if (validity.typeMismatch) return 'typeMismatch';
if (validity.patternMismatch) return 'patternMismatch';
if (validity.tooShort) return 'tooShort';
if (validity.tooLong) return 'tooLong';
if (validity.rangeUnderflow) return 'rangeUnderflow';
if (validity.rangeOverflow) return 'rangeOverflow';
if (validity.stepMismatch) return 'stepMismatch';
if (validity.badInput) return 'badInput';
return null; // 无校验失败
}
// 使用示例
const emailInput = document.querySelector('#email');
emailInput.addEventListener('blur', () => {
const reason = getValidationReason(emailInput);
console.log('失败原因:', reason); // 如 'typeMismatch'
console.log('默认提示:', emailInput.validationMessage); // 浏览器内置提示
});
结合 setCustomValidity 实现可控提示
原生提示语不友好且不可翻译,推荐用 setCustomValidity 覆盖,并利用 ValidityState 动态设置:
emailInput.addEventListener('input', () => {
const validity = emailInput.validity;
if (validity.valid) {
emailInput.setCustomValidity('');
} else if (validity.typeMismatch) {
emailInput.setCustomValidity('请输入有效的邮箱地址');
} else if (validity.valueMissing) {
emailInput.setCustomValidity('邮箱不能为空');
}
});
注意:setCustomValidity('') 是恢复有效状态的关键,否则元素会一直被视为无效。
兼容性与注意事项
ValidityState 在所有现代浏览器中均支持(Chrome 10+、Firefox 4+、Safari 5.1+、Edge 12+),无需 Polyfill。
- 校验仅在用户交互(如 blur、submit)或显式调用
checkValidity()后触发;初始加载时validity.valid可能为true即使未输入 -
validationMessage的内容由浏览器决定,不同语言/版本可能不同,不建议直接展示给用户 - 多个校验同时失败时,
ValidityState中可能有多个true,但应以最高优先级(如valueMissing通常优先于patternMismatch)为准

















