原生表单校验需调用reportValidity()触发UI提示,checkValidity()仅逻辑判断;setCustomValidity('')不重置校验状态,须配合重新评估;禁用novalidate时需同步管理ARIA属性;移动端type属性仅触发键盘,不替代正则校验。

原生校验能用,但直接写 required 或 type="email" 就交差,大概率会在线上翻车——Safari 不提示、Chrome 提示语改不了、隐藏字段静默失败、setCustomValidity('') 还会卡死校验状态。
为什么 checkValidity() 调用后页面没反应
这是最常踩的坑:你写了 form.checkValidity(),控制台返回 false,但输入框没高亮、也没错误气泡弹出来。
-
checkValidity()只做逻辑判断,不触发 UI 渲染;它就像个“裁判”,只打分,不亮灯 - 真正让浏览器显示错误提示的,是
reportValidity()——所有现代浏览器(包括 Safari 15.4+)都支持 - 如果字段设置了
display: none或visibility: hidden,哪怕调了reportValidity(),浏览器也拒绝显示提示(这是规范行为,不是 bug) - 表单提交时,
submit事件会自动触发reportValidity();但手动校验必须显式调用它
setCustomValidity('') 的清空陷阱
很多人以为 input.setCustomValidity('') 是“清除错误”,其实它只是把自定义错误设为空字符串,而浏览器内部仍标记该字段为“已设置过自定义校验”——后续 checkValidity() 可能持续返回 false,哪怕值已经合法。
阿拉丁·前端工程工坊把「前端只会写页面、规范停在文档里、脚手架手敲、构建靠抄、性能靠猜、可访问性靠忘」从「手动搭项目、抄配置、肉眼查规范」升级成一条本地工具链——多框架脚手架生成(React/Vue3/Svelte + Vite)、可复用组件生成(Props 类型+样式+示例)、规范落地检查(lint-lite:命名/未用变量/console残留/TS any/目录结构)、构建配置生成与产物体积预算、性能审计(依赖体积/重复/懒加载/Lighthouse 清单)、可访问性(a11y)校验(alt/aria
- 错误写法:
input.setCustomValidity('')单独调用,不重置状态 - 正确做法:设空后,必须确保下一次
input.checkValidity()能重新评估;更稳妥的是每次非法时设错,合法时统一设input.setCustomValidity(''),且不依赖前值 - 别用
title属性控制提示文本——它不可靠,不同浏览器渲染不一致;所有定制提示请走setCustomValidity()+reportValidity()
如何让原生校验和 JS 逻辑共存不打架
常见冲突场景:你加了 required,又在 JS 里监听 input 事件手动校验,结果两个校验逻辑互相覆盖,或者 reportValidity() 被 novalidate 意外禁用。
- 禁用
novalidate属性时,务必同步管理aria-invalid和aria-describedby,否则读屏软件无法识别错误状态 - 混合使用时,优先让原生属性(
required、pattern、minlength)承担基础约束,JS 专注业务逻辑(如密码一致性、实时查重) - 监听
submit事件时,不要直接e.preventDefault()后扔掉原生流程;建议先form.reportValidity(),仅当返回true再执行后续提交逻辑 - 移动端注意:用
type="tel"或type="number"触发对应键盘,但别指望它们能替代正则校验——type="number"允许粘贴非数字字符,type="tel"完全不校验格式
真正难的不是写对某一行代码,而是理解浏览器校验状态机怎么流转:每个字段有「有效/无效/自定义校验中」三种内部状态,setCustomValidity()、checkValidity()、reportValidity() 各自修改其中哪些位,以及它们在不同 visibility、disabled、novalidate 组合下的表现。漏掉任一环节,都可能让整个表单在校验环节静默失效。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










