1 / 4概念
Forms and Inputs
表单是浏览器唯一原生的数据采集通道:控件、校验、编码、提交都由浏览器实现。判断标准不是会不会写 input,而是能否说清哪些字段会被提交、校验什么时候触发、数据以什么格式离开页面。
1 概念
1.1 一句话定义
表单把一组带名字的控件聚合成一次提交。浏览器负责收集值、执行声明式校验、按 enctype 编码,再以 GET 或 POST 发出请求。
1.2 它解决什么问题
- 原生控件:日期、颜色、文件选择无需自造。
- 声明式校验:必填、格式、范围写在属性里,浏览器直接拦截。
- 无脚本可用:脚本失败时表单仍能提交,这是回归底线。
- 可访问性:标签、分组与错误提示有原生约定。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 控件样式与错误态 | CSS 章 |
| 标签、焦点与 ARIA 细节 | Accessibility and SEO |
| 框架里的受控组件与表单库 | React、Vue |
| 请求语义与状态码 | Application Protocols |
| 上传文件的存储与鉴权 | Backend Frameworks |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 控件 | input、select、textarea 等 | 不是容器 |
name | 提交时的字段名 | 没有它就不会被提交 |
value | 控件的当前值 | 与默认值 defaultValue 不同 |
| 标签 | 与控件关联的文字 | placeholder 不是标签 |
| 分组 | fieldset 与 legend | 影响可访问性名称 |
| 约束校验 | 属性驱动的原生校验 | 只在提交与交互时触发 |
FormData | 提交数据的脚本视图 | 与 URL 编码不完全等价 |
enctype | 提交编码方式 | 文件必须用 multipart |
2 机制
2.1 心智模型
把表单想成一张表:每行是一个「名字 → 值」,由控件提供。提交时浏览器按规则筛出可提交的控件,做一次校验,再编码发送。脚本只是旁路读取或拦截。
2.2 机制拆解
- 收集规则:只有带
name且未禁用、且属于该表单的控件会提交;未选中的单选与复选不提交。 - 提交路径:
submit事件先触发,可被preventDefault拦下;随后浏览器校验,未通过则聚焦第一个错误控件。 - 编码:默认
application/x-www-form-urlencoded,含文件时必须multipart/form-data。 - 校验属性:
required、pattern、min、max、step、minlength、maxlength由浏览器实现,跨浏览器语义一致。 - 校验接口:
checkValidity返回布尔,reportValidity同时显示提示,validity暴露具体原因。 - 标签关联:
label用for指向控件id,或包裹控件;点击标签会聚焦或切换控件。 - 按钮语义:
button元素默认type="submit",不写类型会意外提交。
2.3 完整枚举
二十二种 input 类型,这是完整集合:
| 类型 | 取值 | 备注 |
|---|---|---|
text | 任意文本 | 默认类型 |
search | 文本 | 语义为搜索 |
tel | 电话 | 不校验格式,用 pattern |
url | 绝对地址 | 原生格式校验 |
email | 邮箱 | multiple 允许多个 |
password | 掩码文本 | 不参与日志 |
number | 数值 | 本地化小数点 |
range | 滑块 | 配合 min、max、step |
date | 日期 | 不含时间 |
month | 年月 | — |
week | 年周 | — |
time | 时间 | 可选秒 |
datetime-local | 本地日期时间 | 不带时区 |
color | 颜色 | 值为十六进制 |
checkbox | 多选 | 未勾选不提交 |
radio | 单选 | 同 name 成组 |
file | 文件 | 需要 multipart |
hidden | 隐藏值 | 用户不可见,不可信 |
submit | 提交按钮 | — |
image | 图片提交按钮 | 额外提交坐标 |
reset | 重置按钮 | 恢复默认值 |
button | 通用按钮 | 无默认行为 |
约束校验的完整属性集:
| 属性 | 作用 | 适用 |
|---|---|---|
required | 必填 | 多数类型 |
pattern | 正则匹配 | 文本类 |
min 与 max | 数值或日期范围 | 数值、日期 |
step | 取值步长 | 数值、日期 |
minlength 与 maxlength | 文本长度 | 文本类 |
multiple | 允许多值 | 邮箱、文件 |
accept | 文件类型过滤 | 文件 |
novalidate | 关闭表单校验 | form 上 |
button 的三种类型:
| 类型 | 行为 |
|---|---|
submit | 提交表单,默认值 |
reset | 恢复默认值 |
button | 无行为,交给脚本 |
三种提交编码:
enctype | 格式 | 适用 |
|---|---|---|
application/x-www-form-urlencoded | 键值对 URL 编码 | 默认、纯文本 |
multipart/form-data | 分段边界 | 含文件 |
text/plain | 纯文本调试 | 仅调试 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| GET 地址长度 | 约两千字符 | 超出会被截断 |
| 文本长度上限 | 五十万字符 | 规范的默认上限 |
| 文件分块 | 实现相关 | 大文件要分片上传 |
| 校验触发 | 提交或失焦 | 不是每次按键 |
3 实践
3.1 最小示例
原生校验加脚本兜底:浏览器先拦,脚本再读 FormData 并决定是否发请求。
<form id="signup" method="post" action="/api/signup">
<fieldset>
<legend>账号</legend>
<label for="email">邮箱</label>
<input id="email" name="email" type="email" required autocomplete="email" />
<label for="password">密码</label>
<input
id="password"
name="password"
type="password"
required
minlength="12"
autocomplete="new-password"
/>
</fieldset>
<button type="submit">创建账号</button>
</form>
const form = document.querySelector('#signup');
form.addEventListener('submit', async (event) => {
event.preventDefault();
const data = new FormData(form);
const response = await fetch(form.action, {method: 'POST', body: data});
if (!response.ok) {
// 服务端返回字段级错误,映射到对应控件
console.error('signup failed', response.status);
}
});
追踪:点提交时浏览器先执行约束校验,email 为空或格式错误会阻止提交并聚焦该控件;校验通过才触发 submit 监听器;监听器拦截后用 FormData 取出所有带 name 的控件值,交给 fetch。若删掉 name,该字段在 FormData 里直接消失。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 必填 | required | 空值阻止提交 |
| 格式 | pattern="[0-9]{6}" | 整串匹配,隐含锚定 |
| 提示输入法 | inputmode="numeric" | 移动端数字键盘 |
| 建议值 | list 加 datalist | 可选可输入 |
| 自动填充 | autocomplete="one-time-code" | 依赖令牌语义 |
| 关闭校验 | formnovalidate | 单个按钮跳过 |
| 读取值 | new FormData(form) | 只含可提交控件 |
| 自定义错误 | setCustomValidity | 会阻止提交直到清空 |
3.3 标准流程
- 先写服务端契约:字段、类型、长度、必填。
- 每个控件配
label,需要分组时用fieldset与legend。 - 把能表达为属性的约束写成原生属性,别用脚本模拟。
- 提交处理里读
FormData,把服务端错误映射回字段。 - 关闭 JavaScript 走一遍,确认表单仍可提交。
- 服务端重复全部校验,客户端校验只是体验。
3.4 与相邻技术的组合
- CSS:
:invalid、:user-invalid可以只对用户交互过的控件标错。 - 可访问性:错误信息用
aria-describedby关联,焦点移到第一个错误。 - 框架:受控组件把
value与onChange绑在一起,非受控组件更接近原生行为。 - 网络:
POST提交与fetch共用同一套编码,服务端要按Content-Type解析。 - 存储:草稿可以存本地,但密码与验证码不应落盘。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 校验 | 原生 / 脚本 / 库 | 体验与一致性 |
| 单选 | select / 单选组 / datalist | 选项数量与可搜索性 |
| 提交 | 原生表单 / fetch | 无脚本可用性 |
| 上传 | 一次性 / 分片 | 体积与断点续传 |
3.6 决策规则
- 能用原生属性表达的校验就写属性,脚本只做补充。
- 选项超过十个用可搜索控件,不要在单选组里堆。
- 每个按钮显式写
type,避免默认提交。 - 含文件的表单必须设
enctype="multipart/form-data"。 - 任何提交都要服务端再校验一次。
- 错误提示与字段绑定,焦点落在第一个错误处。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 原生校验 | 零依赖、可访问 | 提示样式受限 | 大多数表单 |
| 脚本校验 | 完全可控 | 需处理可访问性 | 复杂规则 |
| 表单库 | 校验与状态一体 | 体积与学习 | 大表单 |
| 原生提交 | 无脚本可用 | 整页刷新 | 关键流程 |
3.8 何时不该用
- 不要用
div加点击事件冒充按钮,键盘与语义都会丢。 - 不要用
placeholder代替label。 - 不要只做客户端校验,请求可以绕过页面。
- 不要把密码放进
hidden字段。 - 不要在
input type="number"上做金额计算,精度与本地化都会出问题。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 字段提交后消失 | 缺 name | 补 name |
| 点按钮整页刷新 | 按钮默认 submit | 显式写 type |
| 点击文字不聚焦控件 | label 未关联 | for 配 id |
| 上传文件为空 | 缺 multipart | 设 enctype |
| 禁用的字段收不到 | disabled 不提交 | 用 readonly |
| 客户端校验被绕过 | 请求不经过页面 | 服务端重复校验 |
| 小数点在部分区域失效 | number 本地化 | 用文本加 inputmode |
| 正则匹配意外通过 | 未考虑整串匹配 | 显式写锚点 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
placeholder 当标签 | 输入后提示消失 | label |
| 隐藏字段存权限 | 可被篡改 | 服务端判断 |
| 表单嵌套 | 行为未定义 | 拆成两个表单 |
只用 alert 报错 | 不可访问 | 字段级提示 |
| 巨型单页表单 | 放弃率高 | 分步提交 |
4.3 可观测信号
表单放弃率、字段级错误分布、提交失败率、自动填充使用率、移动端键盘类型是否匹配、服务端校验拒绝率。
4.4 安全 / 性能 / 一致性边界
- 信任边界:所有字段都可被篡改,服务端必须独立校验。
- CSRF 边界:基于 Cookie 的会话需要 CSRF 令牌或同站策略。
- 注入边界:回显用户输入时必须转义,否则就是 XSS。
- 一致边界:客户端与服务端对长度、格式、字符集的规则必须一致,否则会出现前端通过、后端拒绝。