patternMismatch是input设置pattern属性后输入不匹配正则时validity的布尔属性,仅在非空输入且不满足正则时为true;需在input/blur/submit事件中读取,并配合setCustomValidity手动设错与清空。

直接通过表单控件的 validity.patternMismatch 属性就能判断正则匹配是否失败。
patternMismatch 是什么
当 input 元素设置了 pattern 属性(含正则表达式),且用户输入内容不满足该正则时,浏览器会自动将该元素的 validity.patternMismatch 设为 true。它只在有 pattern 且值不为空时起作用;空值不会触发 patternMismatch(除非同时加了 required)。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
如何准确读取 patternMismatch 状态
- 必须等用户输入后或提交前检查,不能在页面加载完就立刻读 —— 此时 validity 还未计算
- 推荐监听
input、blur或submit事件来实时获取 - 代码示例:
const el = document.getElementById('idcard');
el.addEventListener('input', () => {
if (el.validity.patternMismatch) {
console.log('身份证格式不对');
} else if (el.validity.valid) {
console.log('格式正确');
}
});
配合 setCustomValidity 自定义提示
patternMismatch 本身不显示错误文案,需手动设置:
- 当
validity.patternMismatch === true时,调用el.setCustomValidity('请输入正确的身份证号') - 当输入合法时,必须调用
el.setCustomValidity('')清空自定义错误(否则即使输对了也报错) - 注意:setCustomValidity 一旦非空,就会覆盖所有原生验证状态(包括 required、typeMismatch 等),所以清空动作不能遗漏
常见陷阱提醒
- pattern 正则默认不带
^和$,但浏览器内部会**自动锚定首尾**(即等效于^...$),所以不用额外加 - 移动端 iOS Safari 对某些正则语法(如 lookbehind)支持不全,建议用基础语法(
\d、{n}、[abc]等) - 若同时用了 required,空值触发的是
valueMissing,不是patternMismatch—— 两者互斥

















