JavaScript / TypeScript / 系统课时

读取表单控件数据

读取表单控件数据

本篇解决网页提交信息时如何获取用户输入的问题,覆盖文本框、单选框、复选框和下拉框等常见控件,帮助你构建能够正确读取表单状态的交互逻辑。

学习目标

  • 掌握常见表单控件的值读取方式。
  • 理解不同控件的数据结构差异。
  • 能够在提交表单前收集并验证用户输入。

读取不同类型控件的值

表单控件的数据读取方式取决于控件类型。文本框通常直接读取 value,单选框需要找到选中的选项,复选框需要判断是否选中,下拉框则读取当前选择项。

下面示例展示一个完整表单数据读取过程。

html
<form id="profile-form">
  <input id="name" value="Alice">
  <label><input type="radio" name="level" value="basic" checked>基础</label>
  <label><input type="radio" name="level" value="advanced">高级</label>
  <label><input id="agree" type="checkbox" checked>同意协议</label>
  <select id="city">
    <option value="bj" selected>北京</option>
    <option value="sh">上海</option>
  </select>
</form>

<script>
const form = document.querySelector('#profile-form');

const data = {
  name: document.querySelector('#name').value,
  level: document.querySelector('input[name="level"]:checked').value,
  agree: document.querySelector('#agree').checked,
  city: document.querySelector('#city').value
};

console.log(data);
</script>

预期输出

text
{name: 'Alice', level: 'basic', agree: true, city: 'bj'}

这里的 value 表示控件当前数据,checked 表示布尔状态。两者用途不同,不能使用 value 判断复选框是否勾选。

使用 FormData 收集表单

当表单字段较多时,可以使用 FormData 自动读取带有 name 属性的控件,减少逐个查询元素的代码。

js
const form = document.querySelector('#profile-form');
const formData = new FormData(form);

console.log(formData.get('level'));

预期输出

text
basic

使用 FormData 时,控件必须设置 name 属性,否则该字段不会被收集。

常见读取错误

开发中常见问题包括直接读取不存在的元素导致空值错误、使用 value 判断复选框状态、忘记处理未选择单选框的情况。

对于用户提交的数据,还需要在读取后进行校验。例如长度限制、格式检查和必填字段判断都不能只依赖 HTML 属性。

什么时候选择不同方式

字段较少且需要立即处理时,直接通过 DOM 查询读取更直观。表单结构固定但字段较多时,FormData 更适合统一收集。复杂应用通常会在收集后进入独立的数据校验流程。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取表单控件数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通