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 并触发渲染,但常规表单通常足以承受。

大型表单可以拆分组件、让状态靠近使用位置,或使用专门的表单方案。优化前先确认真实性能问题,不要仅因字段数量多就放弃受控模型。

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

目录与阅读设置

阅读设置

17

记录一个想法

受控组件

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

登录哪都通