React / 系统课时
受控组件
受控组件
受控组件把表单值保存在 React state 中,并通过 value 与 onChange 保持界面和状态一致。本课将同时控制输入框、选择框和文本域,并观察状态如何成为表单数据的唯一来源。
学习目标
- 使用 state 控制常见表单元素
- 正确连接
value与onChange - 理解受控输入的同步更新要求
受控组件的基本规则
文本输入获得字符串 value 后会成为受控组件,选择框和文本域也遵循相同思路:React 提供当前值,用户输入事件再更新 state。受控字段在整个生命周期中应保持受控,不要在字符串与 undefined、null 之间切换。:contentReference[oaicite:2]{index=2}
同时控制三种字段
jsx
import { useState } from 'react';
export default function App() {
const [name, setName] = useState('');
const [role, setRole] = useState('developer');
const [bio, setBio] = useState('');
return (
<main>
<label>
姓名
<input
value={name}
onChange={(event) => setName(event.target.value)}
/>
</label>
<label>
角色
<select
value={role}
onChange={(event) => setRole(event.target.value)}
>
<option value="developer">开发者</option>
<option value="designer">设计师</option>
<option value="manager">项目经理</option>
</select>
</label>
<label>
简介
<textarea
value={bio}
onChange={(event) => setBio(event.target.value)}
/>
</label>
<section>
<h2>实时预览</h2>
<p>姓名:{name || '未填写'}</p>
<p>角色:{role}</p>
<p>简介:{bio || '未填写'}</p>
</section>
</main>
);
}预期结果:
text
输入姓名、切换角色或编辑简介时,实时预览立即显示最新值。
刷新页面后状态会恢复为代码中的初始值。为什么必须同步更新
为受控字段提供 value 却不在 onChange 中同步更新,用户输入会被下一次渲染覆盖,字段看起来像“无法输入”。因此事件处理函数应立即读取 event.target.value 并更新对应 state。
数字输入的 event.target.value 仍是字符串。只有业务计算确实需要数字时,才在合适位置转换,并处理空字符串;不要让用户暂时清空输入框时得到 NaN。
何时使用受控方案
当页面需要实时预览、联动字段、即时校验、条件禁用或统一提交数据时,受控组件最直接。代价是每次输入都会更新 state 并触发渲染,但常规表单通常足以承受。
大型表单可以拆分组件、让状态靠近使用位置,或使用专门的表单方案。优化前先确认真实性能问题,不要仅因字段数量多就放弃受控模型。
按自己的节奏,确认真正理解。