接手一个「注册页提交后收不到手机号」的 bug,前端日志显示请求发出去了,状态码 200,后端却说没有这个字段。查了半小时,问题出在一个很小的疏忽:手机号那个 input 只写了 type 和 placeholder,忘了写 name。表单提交时,浏览器只收集带 name 的控件,没名字的字段压根不会出现在请求里。页面看起来一切正常,数据却悄悄丢了。
这类问题有个共同点:不报错。表单不会提醒你少了一个属性,控制台也不会红,只有等到后端对账或者用户投诉,才发现数据缺了一块。所以这篇不打算按「控件列表」平铺,而是围绕几个真实故障点来讲:数据在哪一步消失、点标签为什么没反应、浏览器校验什么时候会拦人、按钮为什么会偷偷提交。
form:把控件组织成一次提交
form 是表单的外壳,action 是提交地址,method 是提交方式。get 把数据拼在地址后面,适合搜索这类查询;post 放在请求体里,适合注册、下单、上传。不写 method 时默认是 GET,很多人第一次做登录页,密码直接出现在地址栏里,就是忘了改。
GET 和 POST 的差别不只是「参数在哪儿」。GET 的参数会进浏览器历史、代理和服务器日志,等于半公开;POST 放在请求体里,相对不容易被日志收进去,但没有 HTTPS 照样能被看到。所以登录、支付类表单,先保证整站走 HTTPS,再谈 method。URL 还有长度上限,用 GET 传一长串数据迟早会撞墙。
表单里有文件,必须在 form 上写 enctype="multipart/form-data"。漏了它,浏览器只把文件名当普通文本发出去,现象是「上传成功但文件 0 字节」或「只收到文件名」。这个属性属于表单,写到 input 上不生效。
<form action="/api/search" method="get">
<label for="keyword">搜索关键词</label>
<input id="keyword" name="q" type="search">
<button type="submit">搜索</button>
</form>
现代项目里,很多表单被脚本拦截后用 fetch 提交。即便如此,action 和 method 也建议写上:脚本加载失败时还能退化成普通提交,这是成本很低的渐进增强。反过来,action 留空会提交到当前地址,筛选页很方便,订单确认页却可能导致刷新后重复提交。
把提交拆成「触发、校验、收集、发送」几段来看,定位会快很多。用户说「点了没反应」,可能是校验被拦下但提示不在视野里,也可能是按钮根本不是提交按钮,还可能是请求发出去了但脚本吞了错误。
name:字段的身份证
提交时,浏览器把每个「有 name、没被禁用」的控件拼成键值对:name 是键,用户填的值是值。没 name、写了 disabled、复选框没勾选,这三种情况都不参与提交,也是「数据莫名丢失」的高频原因。
字段「不存在」和字段「是空字符串」是两回事。控件有 name、没被禁用,用户一个字没填也会提交空值。后端说「没收到」,和「收到但为空」,修法完全不同。看请求体先确认键在不在,再看值。
只读和禁用常被混用。readonly 不能编辑,但值仍会提交,也能聚焦;disabled 既不提交也不聚焦。曾见过为了锁定编辑把整个区域包进 disabled,结果保存时整块字段从请求里消失了。要保留值,用 readonly;要彻底排除,才用 disabled。
复选框和单选框不写 value,提交上去的值是 on。一组单选框必须写不同的 value,否则后端收到的全是 on。同一组共用 name 才有互斥效果;多选框要提交多个值,也共用 name,后端按数组接收。
脚本收集数据时,new FormData(form) 遵循同样的规则:disabled、没 name、未勾选项都不进去,比手写 querySelectorAll 可靠。有文件时直接让 FormData 走请求体,别转成对象再 JSON 序列化。
input 的类型:先选对,再谈样式
type 决定控件长什么样、手机弹什么键盘、浏览器做哪些校验。很多人所有输入框都用 type="text",再用 CSS 改样子,结果手机上填邮箱还要手动切键盘,填日期只能自己打字。
| 类型 | 用途 | 实际影响 |
|---|---|---|
text | 普通单行文本 | 默认类型,不做格式校验 |
email | 邮箱地址 | 手机键盘带 @,提交时检查基本格式 |
tel | 电话号码 | 手机弹出数字键盘,不校验具体格式 |
number | 数值 | 可用上下键调整,配合 min、max、step |
password | 密码 | 输入内容被遮住,注意它不提供加密 |
search | 搜索 | 部分浏览器会显示清空按钮 |
checkbox | 多选 | 可勾选多个,配合 value 提交 |
radio | 单选 | 同一 name 的一组里只能选一个 |
file | 选文件 | 需要表单用 multipart/form-data |
date | 日期 | 浏览器提供日期选择器,值格式为年-月-日 |
hidden | 隐藏字段 | 用户看不见,随表单提交,别用来存敏感信息 |
number 不是「只能输数字的文本框」:值按浮动数字处理,开头的 0 可能被吃掉,某些输入法能打出 e 表示科学计数法,手机号这种「数字组成的字符串」放进去反而容易出问题。电话号码用 tel 配 inputmode="numeric" 更合适,前者决定键盘,后者只是输入提示,都不负责校验格式。
日期、颜色、范围这些控件的界面差异不小,样式也不容易统一。设计要求完全一致的日历面板时,通常只能自研,代价是要自己补键盘操作和无障碍。
label:点文字就能选中输入框
label 给控件起名字,有两种绑定:用 for 指向控件的 id,或者把控件包在 label 里。绑定后,点标签文字能聚焦输入框,复选框和单选框会被切换选中。对鼠标用户,小复选框好点多了;对读屏用户,这是控件有没有名字的关键。
<label for="phone">手机号</label>
<input id="phone" name="phone" type="tel">
<label>
<input type="checkbox" name="agree" value="yes">
我已阅读并同意用户协议
</label>
常见错误是用 placeholder 代替 label。占位文字在用户输入后就消失,填到一半回头检查已经不知道这栏是什么;颜色通常很浅,对比度不达标;读屏支持也不如 label 稳定。它只适合当补充提示,比如「例如 13800000000」,字段名必须用 label。
for 指向的 id 不存在,或者页面里有重复 id,点击标签不会有反应。这个现象排查起来很快:先在 Elements 面板确认 id 是否唯一、是否拼错。重复 id 还可能来自同一个组件被复用两次,光看标签本身看不出问题。没有可见标签时,也不要真的删掉 label。搜索框这类设计可以写一个视觉上隐藏、读屏仍能读到的标签,用裁剪样式把元素移出可视区域,而不是 display: none,后者会让辅助技术也读不到。标签文字尽量写名词,「手机号」比「请输入手机号」更适合,读屏软件会把它念成「手机号,编辑框」,再加指令就显得啰嗦。
一次「预约试听」表单的走查
需求来自课程页:用户填姓名、手机号、孩子年级、期望试听时间,勾选同意条款,点「预约」。提交成功后不跳页,就地显示「已收到,顾问会在 24 小时内联系」。听起来是个两天能上线的功能,实际改了三轮。
第一版是这么写的:底部放一个 div 加背景色当按钮,点击时用脚本遍历几个输入框拼对象,然后 fetch 提交。上线前的键盘走查立刻暴露问题:Tab 走不到那个 div,回车也不会触发。更糟的是,脚本只读了姓名和手机,年级用的是 select,代码按 id 取值,而 id 和字段名对不上,后端的年级一直是空的。用户连点三次,还生了三条预约记录。这一版的根本错误,是把「表单」当成了「几个输入框加一个点击事件」。
第二版回到原生表单。button 改回 type="submit",每个控件补上 name,提交逻辑统一监听 form 的 submit 事件,先 preventDefault(),再用 new FormData(form) 收集。这样键盘、自动填充、浏览器校验都回来了,脚本也不用再维护字段清单。后来产品临时加了一个「意向课程」下拉,代码没改,数据自动就带上了,这是第一版做不到的。
但第二版又踩了一个坑:为了防重复提交,请求发出时把提交按钮设成 disabled,请求失败后忘了恢复,用户看到「提交失败」却怎么点都没反应。更危险的是,如果 disabled 加在 fieldset 上,FormData 里的字段会一起消失。修正办法是只锁按钮、请求结束无论成败都恢复,再用标志位拦住并发点击。
最后一轮是错误提示。原本只把出错的输入框边框染红,试用时有人填错手机号,盯着页面问「然后呢」。改成在字段下方加一行文字说明,用 aria-describedby 关联;提交失败时把焦点移到第一个出错的字段,并在表单顶部用 aria-live 播报「有 2 个字段需要检查」。这轮改动不大,但「填错了不知道怎么办」的反馈基本消失了。
浏览器自带的校验:能用,但别全指望
HTML 提供了一组校验属性:required 必填、pattern 按正则校验、minlength 和 maxlength 限制长度、min 和 max 限制数值范围、type="email" 检查邮箱格式。提交时浏览器会先跑一遍,不通过就拦下来并弹出提示。
<input id="email" name="email" type="email" required
placeholder="例如 name@example.com">
<input id="code" name="code" type="text" required
pattern="[0-9]{6}" title="请输入 6 位数字验证码">
这套东西的好处是零成本、键盘和读屏软件都能识别。代价是提示文字由浏览器决定,样式改不了,不同浏览器甚至不同语言环境下的措辞都不一样。做国际化产品时,这种不可控会变成问题。另一个坑是:原生校验只在「提交」时触发,用户填错后焦点会跳到第一个错误项,但如果错误项在折叠区域里,用户可能看不到,只觉得「点了没反应」。
几个容易误判的细节,值得单独记一下:
required只要求「非空」,一串空格也算有值。要挡纯空格,得在脚本里trim()之后再判断。pattern默认匹配整个值,不用自己加首尾的 ^ 和 $;加了通常也没问题,但在部分实现里会多一层转义,没必要。maxlength限制的是用户输入,脚本直接赋值可以绕过;服务端仍然要截断或拒绝。
所以实际项目常见的做法是:保留原生属性作为兜底,同时在脚本里做更友好的行内提示。想完全接管校验,可以在 form 上加 novalidate,关掉浏览器默认行为,全部自己处理。这个取舍要想清楚:自己处理意味着要覆盖必填、格式、长度、错误定位、读屏播报,工作量远大于加几个属性。
按钮:默认行为最容易埋雷
button 在表单里默认是 type="submit"。这意味着,你在表单里放了一个「获取验证码」的按钮,本来只想执行一段脚本,结果一点就把整个表单提交了。这个 bug 很经典,排查时看按钮有没有写 type 就行。
type="submit":提交表单,回车键通常也会触发它。type="button":普通按钮,只响应点击,不提交。做「获取验证码」「展开更多」这类操作时用它。type="reset":清空表单。误点代价很大,用户填了十分钟全没了,除非有明确需求,一般不放。
回车的行为也值得知道。焦点在文本输入框里按回车,浏览器通常会找表单里的第一个提交按钮并触发它。如果那个按钮是「删除」或者「取消」,用户本来只想确认输入,结果执行了破坏性操作。稳妥的排法是让主提交按钮在 DOM 里靠前,把次要或危险操作放在后面,并且明确写 type。
另一类问题是用 div 或 span 画按钮。加个背景色、圆角,看起来一模一样,但键盘按不到、读屏软件不认为它是按钮、回车和空格也没反应。补救办法是加 role="button" 和 tabindex="0",再自己监听键盘事件。能做,但没必要:原生 button 用 CSS 就能改成任何样子,何必重新实现一遍。
分组、说明与错误提示
一组长相相同的单选框,比如「配送方式:标准/加急」,光看每个选项的标签,用户不知道这组在问什么。用 fieldset 包起来,再用 legend 写组名,读屏软件会把组名和选项一起念出来。
<fieldset>
<legend>配送方式</legend>
<label><input type="radio" name="shipping" value="standard"> 标准配送</label>
<label><input type="radio" name="shipping" value="express"> 加急配送</label>
</fieldset>
错误提示不要只靠颜色。红色边框对色觉障碍用户不友好,正确做法是同时给出文字说明,并用 aria-describedby 把说明和输入框关联起来,让读屏软件在聚焦时一起念。输入框本身可以加 aria-invalid="true" 表示当前值有误。这些属性的细节在可访问性那篇会展开,这里先知道「错误不能只靠颜色」就够了。
错误现象对照
这些现象症状各不相同,原因大多落在那几个属性上。按「第一步查什么」走,通常比通读代码快。
| 现象 | 真实原因 | 第一步查什么 |
|---|---|---|
| 提交后后端收不到某个字段 | 控件没写 name,或被 disabled,或不在 form 内 | 看请求体里有没有这个键,再对照控件的 name 与 disabled |
字段在,但值总是空的或全是 on | 用户没填、缺 value、空串也会提交 | 看请求体里的值,检查 checkbox 和 radio 的 value |
| 点标签文字没反应 | for 与 id 不匹配,或 id 重复 | 在 Elements 面板确认 id 唯一且拼写一致 |
| 点「获取验证码」整页刷新 | 按钮没写 type,默认按 submit 处理 | 看按钮的 type 属性,是否缺省成了 submit |
| 在输入框按回车,触发了错误的操作 | 表单里第一个提交按钮是次要或危险操作 | 按 DOM 顺序看第一个 submit 按钮是谁 |
| 手机号少一位也能提交 | type="tel" 只换键盘,不校验格式 | 看有没有 pattern 或长度限制,服务端是否兜底 |
| 文件上传后后端只拿到文件名 | 表单缺 enctype="multipart/form-data" | 看 form 的 enctype,而不是 input 的属性 |
| 错误提示读屏软件不念 | 只改了颜色,提示文字没有和控件关联 | 看 aria-describedby 与 aria-invalid 是否指向真实存在的 id |
边界与代价:原生表单到哪里为止
原生表单不是万能的。动态增删的表格行、跨字段联动、分步向导、带搜索分组的下拉,光靠 HTML 属性不够,必须引入脚本状态。代价是原生校验、自动填充、无脚本回退这些能力,要么自己补,要么放弃。补得越全,越接近在框架里重写一遍表单层。
规模也是信号。十来个字段,手写 HTML 加几段校验最省事;二三十个还要分步和联动,规则会散在 HTML、脚本和接口文档里,改一处忘两处。稳妥的做法是把字段定义、校验规则、错误文案收成一份配置,HTML 和脚本都从它生成。
还有几个容易被忽略的副作用:
- 加了
novalidate之后,原生校验的读屏播报和错误定位也一起没了,得自己补,否则表面上提示更好看,实际更难用。 - 用
disabled锁表单会同时锁掉数据,用readonly只锁输入不锁提交,两者别混。 - 隐藏字段不隐藏。用户改不了页面上的值,但能改请求,凡是涉及价格、权限、身份的字段,服务端必须重新校验。
- 客户端的
accept只是选择文件时的过滤器,不是安全校验,文件类型和大小必须在服务端再查一遍。
最后一条底线:前端校验是为了让用户少走弯路,不是为了安全。任何「浏览器已经拦住了」的假设,在服务端都不成立。反过来说,服务端校验也不能替代前端提示,用户不该为了知道「手机号格式不对」而提交三次。
小结与下一步
排查表单先看四处:name 写了吗、控件被禁用了吗、按钮的 type 对吗、label 的 for 指对了吗。这四条能解决大部分「数据丢了」「点不动」「莫名提交」。能用原生控件就别自研,时间花在错误提示和键盘体验上。
下面几件事当天就能自己验证,不用等别人给环境:
- 提交一次任意表单,在 Network 面板核对请求体,重点找页面上有、请求里没有的字段。
- 拔掉鼠标,只用 Tab、Shift+Tab、回车和空格填写一次,记下卡住的位置。
- 给必填项留空提交,观察提示位置和焦点;再放进折叠区域看能否发现错误。
- 把 div 按钮换成原生
button,确认能聚焦、回车和空格都能触发。
表单和链接都写好了,接下来是让页面被正确收录和分享:标题、描述、规范地址、社交卡片。下一篇 meta 标签与基础 SEO 会解释搜索引擎实际看到的是什么,为什么「每页复制同一段 head」会让文章互相打架,以及哪些流传很广的 SEO 技巧其实只是心理安慰。