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 结构公开给外部。
按自己的节奏,确认真正理解。