受控组件是指输入值由 react state 控制的表单组件,通过 value/checked 绑定 state 并在 onChange 中更新 state,实现状态可预测、可校验;非受控组件则依赖 dom 自行管理值。

javaScript 中实现表单控制,核心是让组件的值由 React(或类似框架)的状态(state)来管理,而不是由 DOM 自己维护——这就是“受控组件”。
什么是受控组件
受控组件是指组件的输入值(如 input、textarea、select)完全由 React 的 state 控制。用户每次输入,都触发 onChange 事件,更新 state;而组件的 value(或 checked)属性始终从 state 读取。这样,React 始终“知道”当前值,表单状态可预测、可干预、可校验。
与之相对的是“非受控组件”,它把值交给 DOM 自己管(比如用 ref 获取初始值后不再同步),适合简单场景,但难以做实时校验或动态联动。
如何实现一个受控 input
关键三步:声明 state、绑定 value、监听 onChange 并更新 state。
立即学习“Java免费学习笔记(深入)”;
- 用 useState 初始化值,例如:const [name, setName] = useState(”);
- 将 input 的 value 设为该 state:value={name}
- 在 onChange 中更新 state:onChange={(e) => setName(e.target.value)}
此时输入框无法手动修改内容,除非 state 改变——它真正“受控”了。
处理多字段表单的常见写法
多个输入项时,避免为每个字段写单独的 setState。常用模式是统一用一个对象管理所有字段:
- 定义 state:const [form, setForm] = useState({ username: ”, email: ”, agree: false });
- 通用 onChange 处理函数:const handleChange = (e) => { const { name, value, type, checked } = e.target; setForm(prev => ({ …prev, [name]: type === ‘checkbox’ ? checked : value })); };
- 每个 input 设置 name 属性(如 name=”username”),确保能映射到 state 字段
注意几个易错点
- 不要只写 onChange 不写 value:否则会变成“半受控”,React 控制台会警告
- textarea 的值也用 value 而非 children:和 input 一致,保持受控逻辑统一
- select 的 value 绑定在 select 标签上,不是 option 上;option 用 value 属性声明选项值
- 如果初始值来自 props,记得在 useEffect 中同步,避免“props 改变但 input 不更新”
基本上就这些。受控组件不是 javascript 独有概念,而是 React(及类 React 框架)中数据流设计的体现——把表单当作状态的一部分来统一管理,清晰、可靠、易于测试。