接手一个「注册页提交后收不到手机号」的 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 指对了吗。这四条能解决大部分「数据丢了」「点不动」「莫名提交」。能用原生控件就别自研,时间花在错误提示和键盘体验上。

下面几件事当天就能自己验证,不用等别人给环境:

  1. 提交一次任意表单,在 Network 面板核对请求体,重点找页面上有、请求里没有的字段。
  2. 拔掉鼠标,只用 Tab、Shift+Tab、回车和空格填写一次,记下卡住的位置。
  3. 给必填项留空提交,观察提示位置和焦点;再放进折叠区域看能否发现错误。
  4. 把 div 按钮换成原生 button,确认能聚焦、回车和空格都能触发。

表单和链接都写好了,接下来是让页面被正确收录和分享:标题、描述、规范地址、社交卡片。下一篇 meta 标签与基础 SEO 会解释搜索引擎实际看到的是什么,为什么「每页复制同一段 head」会让文章互相打架,以及哪些流传很广的 SEO 技巧其实只是心理安慰。