H5 中怎么规范团队前端自定义表单校验提示的视觉与文案规范

风强大大_5537

风强大大_5537

2026-10-01

580人浏览

原创

h5表单校验统一规范:以原生校验为基础,css伪类控制状态反馈,预设三类文案模板,js严格管理setcustomvalidity调用与重置,保障无障碍与国际化支持。

h5 中怎么规范团队前端自定义表单校验提示的视觉与文案规范

团队前端在 H5 项目中统一自定义表单校验提示,关键不是“写更多 JS”,而是建立可复用、可维护、无障碍友好的视觉与文案规则。核心原则是:**浏览器原生校验为基底,JS 仅做必要接管;错误提示必须可读、可定位、可恢复;样式反馈需与状态严格同步。**

视觉规范:用 CSS 伪类驱动状态反馈,不依赖 JS 操作 class

所有输入控件(input、select、textarea)的视觉反馈必须通过原生伪类控制,避免手动增删 is-error 类:

  • 聚焦态统一用 :focus + outline: 2px solid #007AFF(iOS/Safari 友好),禁用 outline: none
  • 无效态仅响应 :invalid:not(:placeholder-shown),边框变红(border-color: #E53935),禁用 :invalid 单独匹配(会误伤未输入的必填项)
  • 有效态用 :valid:not(:placeholder-shown),边框变绿(border-color: #43A047),且移除 placeholder 文字
  • 错误提示容器(如 <div class="field-error">)默认 <code>display: none,仅当对应控件处于 :invalid:not(:placeholder-shown) 时,用相邻兄弟选择器显示:input:invalid:not(:placeholder-shown) + .field-error { display: block; }

    文案规范:按错误类型分层定义,禁止自由发挥

    所有自定义提示文案必须从预设池中选取,由产品与 UX 共同确认,禁止开发者临时拼写。分三类:

    html-deploy
    html-deploy

    使用 htmlcode.fun 将 HTML 内容或文件部署到网页,适用于用户要求“部署到网页”“托管此 HTML”“生成此前端...的实时链接”等场景。

    下载
    • 空值类(触发 value === '' && validity.valueMissing):统一为「请填写【字段名】」,字段名从 label.textContent 或 aria-label 提取,例:「请填写手机号」
    • 格式类(触发 validity.typeMismatch || validity.patternMismatch):统一为「【字段名】格式不正确」,例:「邮箱格式不正确」
    • 业务类(需 JS 主动调用 setCustomValidity() 的场景,如用户名查重):必须带明确动作指引,例:「该手机号已被注册,请换一个」或「密码需包含字母和数字,至少8位」

    禁用模糊表述(如“输入有误”“请重试”)、英文混杂(如“Email is invalid”)、以及带情绪化词汇(如“错了!”“别乱填!”)。

    JS 行为规范:约束 setCustomValidity 调用时机与重置逻辑

    所有 JS 校验逻辑必须遵循固定节奏,杜绝“设了不重置”“重置传 null”等高频错误:

    • 在 input 事件中,先清空: el.setCustomValidity(''),再根据当前值判断是否设错;禁止在 blur 后才首次设置
    • 提交前统一调用 form.checkValidity(),若失败,遍历 form.elements,对每个 !el.checkValidity() 的控件,提取 el.validationMessage 渲染到对应 .field-error 中,不调 reportValidity()
    • 每次 setCustomValidity() 后,必须确保后续有明确路径重置:用户继续输入合法内容时自动清空;用户切换字段后若已合法,也需在 blur 时强制清空
    • 禁用 setCustomValidity(null)、setCustomValidity(undefined)、setCustomValidity(' ')(空格会被转成字符串,持续触发 invalid)

    无障碍与国际化基础支持

    提示文案必须可通过 aria-live="polite" 区域同步播报,且支持 i18n 替换:

    • 每个 .field-error 必须有 role="alert" 和 aria-live="polite",确保屏幕阅读器可读
    • 文案模板预留占位符,如 「{field} 格式不正确」,由 i18n 工具注入翻译,不硬编码中文
    • 表单提交按钮需添加 aria-busy="true" 和 aria-disabled="true" 状态,在校验中/提交中提供明确反馈

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

html 前端

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2203

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4723

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5870

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5318

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

763

5

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

2023.10.23

3691

6

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

2024.03.06

6148

6

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

2025.12.30

774

19

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

2025.12.30

654

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 219人学习