受控组件是指输入值由 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-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“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 框架）中数据流设计的体现——把表单当作状态的一部分来统一管理，清晰、可靠、易于测试。
