React / 系统课时

非受控组件

非受控组件

非受控组件把当前输入值留在 DOM 中,React 不在每次键入时同步 state。本课使用 useRef 和 FormData 在提交时读取值,并说明这种方案适合哪些简单或兼容性场景。

学习目标

  • 使用 ref 访问真实输入元素
  • 在提交时读取非受控表单值
  • 区分 defaultValue 与 value

让 DOM 保存当前值

useRef 返回的对象会在多次渲染之间保持,React 可把 DOM 节点写入其 current 属性。修改输入元素的值不会自动触发 React 渲染,因此非受控方案更适合“提交时再读取”的数据。:contentReference[oaicite:3]{index=3}

非受控输入使用 defaultValue 或 defaultChecked 提供初始值,而不是使用持续控制当前值的 value 或 checked。

使用 ref 与 FormData

jsx
import { useRef, useState } from 'react';

export default function App() {
  const nameRef = useRef(null);
  const [result, setResult] = useState('');

  function handleSubmit(event) {
    event.preventDefault();

    const formData = new FormData(event.currentTarget);
    const payload = {
      name: nameRef.current.value.trim(),
      role: formData.get('role'),
      agree: formData.get('agree') === 'on',
    };

    setResult(JSON.stringify(payload));
  }

  function focusName() {
    nameRef.current.focus();
  }

  return (
    <main>
      <form onSubmit={handleSubmit}>
        <label>
          姓名
          <input ref={nameRef} name="name" defaultValue="Ada" />
        </label>

        <label>
          角色
          <select name="role" defaultValue="developer">
            <option value="developer">开发者</option>
            <option value="designer">设计师</option>
          </select>
        </label>

        <label>
          <input name="agree" type="checkbox" defaultChecked />
          同意条款
        </label>

        <button type="button" onClick={focusName}>聚焦姓名</button>
        <button type="submit">读取数据</button>
      </form>
      <p>{result}</p>
    </main>
  );
}

预期结果:

json
{"name":"Ada","role":"developer","agree":true}

实际结果取决于提交前的输入;点击“聚焦姓名”会把光标移动到姓名输入框。

适合与不适合的场景

简单搜索框、只在提交时读取的传统表单、与非 React 插件集成的输入,以及文件选择器,都可能适合非受控方案。它减少了逐键 state 更新,但也失去了实时派生界面所需的数据源。

需要实时校验、字符计数、字段联动、条件显示或即时保存时,受控组件通常更清楚。不要仅为了少写一个 onChange 就选择非受控模式,应根据交互需求决定。

ref 的使用边界

ref 适合聚焦、滚动、测量或提交时读取 DOM。不要在渲染期间读取 ref.current 来决定 JSX,因为 ref 变化不会触发渲染,页面可能与真实值不同步。

父组件需要操作自定义输入组件时,应只暴露必要能力,而不是把整个内部 DOM 结构公开给外部。

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

目录与阅读设置

阅读设置

17

记录一个想法

非受控组件

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

登录哪都通