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 更适合统一收集。复杂应用通常会在收集后进入独立的数据校验流程。
按自己的节奏,确认真正理解。