状态与受控组件
本合集目录
本章目录
单册说明:本文件是卷 4 的第 3 章,可独立阅读。前置:第 2 章(组件与 props)。本章解决"界面怎么跟着数据变":把状态收到一处,让输入框听你的话,并且搞清为什么直接改数组界面不动。
| 项 | 内容 |
|---|---|
| 所属卷 | 卷 4 · React 与 Next.js(第 3 / 8 章) |
| 前置章节 | 4.2 组件、props 与 JSX |
| 本章产出 | 可新增摘录的表单 + 可筛选的列表,全部由状态驱动 |
| 对应代码 | src/components/NoteForm.jsx、src/App.jsx |
| 配图 | 无(后续统一制图) |
| 读完的判定 | 能说出"为什么 push 之后界面不动",并写出三种正确的不可变更新 |
4.3.1 一句话结论:你只改状态,界面是状态的函数
上一章结束时,删除功能是能用的:setNotes(notes.filter(...))。现在加"新增",很多人会写成这样:
notes.push(newNote);
setNotes(notes);
点保存:输入框清空了,列表一条没多。打开控制台 console.log(notes.length),确实从 3 变成了 4。
数据变了,界面没变。 这是 React 新手第一个真正的"玄学"时刻,也是本章要拆掉的核心误解:setNotes 不是"通知界面重画",它是"提交一个新值"。React 拿到新值后会和旧值比较,发现是同一个引用,就认为什么都没发生。
4.3.2 原理与方法
useState 与"重新渲染"到底发生了什么
const [notes, setNotes] = useState(seedNotes);
这一行做了三件事:
- 第一次渲染时,把
seedNotes存进 React 内部的一个槽位; - 返回当前值和修改函数;
- 之后每次
setNotes(next),把新值存进槽位,并排队一次重新渲染。
"重新渲染"不是刷新页面,是把这个组件函数再执行一遍。理解这一点,很多现象就顺了:
| 东西 | 重渲染之后 |
|---|---|
| 函数体里的普通变量 | 重新创建,上次的值丢了 |
useState 的值 |
保留(存在 React 内部,不在函数里) |
useRef().current |
保留,且改它不触发渲染 |
| 已提交的 DOM 节点 | 尽量复用;节点身份变了才重建 |
| 输入框里用户没提交的内容 | 由 DOM 保管,所以"非受控"时不会丢 |
这也解释了一个常见困惑:"我在函数里 let count = 0,点了三次还是 0。" 因为每次渲染都是新的一次函数调用,count 重新变成 0。要跨渲染记住东西,只有 state 和 ref 两条路。
还有一个优化点:useState 的初始值如果很贵(比如读 localStorage 解析 JSON),传函数进去,它只会在首次执行:
const [notes, setNotes] = useState(() => JSON.parse(localStorage.getItem('notes') ?? '[]'));
写成 useState(JSON.parse(...)),每次渲染都会解析一遍,结果被丢掉,纯浪费。
状态提升:谁需要读,就放到共同祖先
第 2 章里,activeTag 放在 App,TagFilter 只负责显示和上报。这不是随便选的,是唯一正确的放法:
TagFilter需要读它(高亮哪个按钮);NoteList需要读它(决定显示哪些);- 两个组件的共同祖先是
App。
| 放错的位置 | 后果 |
|---|---|
放在 TagFilter 里 |
按钮高亮了,列表不动——因为列表根本不知道筛选变了 |
| 两个组件各存一份 | 两份状态迟早不一致,且没有任何机制能发现 |
放在 NoteList 里 |
筛选器无法控制它,除非再往上提 |
判断口诀:找到所有需要读这个值的组件,把状态放在它们最近的共同父级。 如果发现要穿过五层 props 才能传下去,才考虑 context(本卷不展开,等数据真的跨多页时再说)。
受控输入:value 和 onChange 必须成对
<input value={title} onChange={(e) => setTitle(e.target.value)} />
value让输入框显示 state 的值;onChange在每次输入时把新值写回 state。
两者缺一不可。少一个会怎样,这张表说得很清楚:
| 写法 | 结果 |
|---|---|
value + onChange |
正常受控。显示的和 state 永远一致 |
只有 value |
输入框变只读,敲键盘没反应,控制台警告(见坑二) |
只有 onChange |
变成非受控。能打字,但"提交后清空""输入时校验"都做不了 |
两者都有,但 onChange 里没 setState |
打一个字就弹回去,像键盘坏了 |
为什么表单值得受控?因为值在 state 里,你才能做这四件事:提交前校验、输入时实时过滤、一键清空、多个输入框联动(比如选了"引用"才显示来源链接)。非受控要靠 ref 去 DOM 里捞值,这些都会变得别扭。
代价是每敲一个字都会重渲染一次表单所在的那棵子树。本项目只有几十条数据,完全感觉不到;等到列表上千条、输入明显卡顿时,再考虑把输入框拆成独立组件或用 useDeferredValue。不要在一开始就为此加 useMemo——过早优化换来的复杂度,比那几毫秒贵得多。
不可变更新:不要改,要造一个新的
React 判断"变没变"用的是 Object.is。对数组和对象来说,比的是引用。push、splice、sort、直接赋属性,都改的是同一个引用,React 看不出区别。
| 操作 | 错的(原地改) | 对的(造新的) |
|---|---|---|
| 追加 | notes.push(n) |
[...notes, n] |
| 前插 | notes.unshift(n) |
[n, ...notes] |
| 删除 | notes.splice(i, 1) |
notes.filter((x) => x.id !== id) |
| 改一项 | notes[i].title = t |
notes.map((x) => x.id === id ? { ...x, title: t } : x) |
| 排序 | notes.sort(...) |
[...notes].sort(...) |
| 改嵌套 | note.tags.push(t) |
{ ...note, tags: [...note.tags, t] } |
最后一行是最隐蔽的:你写了 { ...note },以为复制了,但 tags 还是同一个数组的引用,push 之后原对象也变了。浅拷贝只复制第一层,嵌套的每一层都要手动展开。
除了"让 React 看见变化",不可变还有第二个好处:旧的那个数组还在,你可以做撤销、可以对比前后差异、可以在调试器里回看上一帧。原地改等于把历史擦掉了。
批量更新与函数式更新
setCount(count + 1);
setCount(count + 1);
setCount(count + 1);
点一次,结果只加 1。因为三次都读的是本次渲染里的那个 count,三次提交的都是 count + 1 这同一个值。
setCount((v) => v + 1);
setCount((v) => v + 1);
setCount((v) => v + 1);
这样才是加 3。函数式更新拿到的是"队列里最新的值",不是渲染时捕获的旧值。
React 18 之后,同一个事件处理函数里的多次 setState 会被自动批处理成一次渲染。好处是不会中间态闪屏,代价是你 set 完立刻读 state,读到的是旧值:
setNotes(next);
console.log(notes.length); // 还是旧的
真实场景:新增一条后想跳到它的详情页,写成 navigate('/notes/' + notes.at(-1).id),跳过去的是上一条。正确做法是用你刚构造出来的 next,而不是再去读 notes。
派生状态不要存进 state
"筛选后的列表"需要存吗?很多人会:
const [filtered, setFiltered] = useState(notes);
useEffect(() => {
setFiltered(notes.filter((n) => activeTag === 'all' || n.tags.includes(activeTag)));
}, [notes, activeTag]);
这段代码能跑,但它制造了第四个必须手动同步的地方。新增一条摘录时,只要有一处忘了触发这个 effect,列表就不更新——而且现象和"筛选逻辑写错"一模一样,极难查。
正确写法是一行:
const visible = activeTag === 'all' ? notes : notes.filter((n) => n.tags.includes(activeTag));
每次渲染重算一遍。三条数据的 filter 是微秒级,完全不需要缓存。
| 该进 state | 不该进 state |
|---|---|
| 用户输入的值 | 能由其他 state 算出来的(筛选结果、计数、是否为空) |
| 从接口拿回来、要跨渲染保留的 | 每次渲染都会重新得到的常量 |
| 用户的选择(当前标签、排序方式) | props 的副本(props 变了它不会跟着变) |
判断标准一句话:"这个值能不能用现有的 state 推出来?"能,就不要存。
4.3.3 动手:新增表单与标签筛选
NoteForm:一个受控表单
src/components/NoteForm.jsx:
import { useState } from 'react';
const emptyDraft = { title: '', content: '', sourceUrl: '', tags: '' };
export default function NoteForm({ onAdd }) {
const [draft, setDraft] = useState(emptyDraft);
const [error, setError] = useState('');
function update(field) {
return (e) => setDraft({ ...draft, [field]: e.target.value });
}
function handleSubmit(e) {
e.preventDefault();
const title = draft.title.trim();
if (!title) {
setError('标题不能为空');
return;
}
onAdd({
title,
content: draft.content.trim(),
sourceUrl: draft.sourceUrl.trim(),
tags: draft.tags.split(',').map((t) => t.trim()).filter(Boolean),
});
setDraft(emptyDraft);
setError('');
}
return (
<form className="form" onSubmit={handleSubmit}>
<input value={draft.title} onChange={update('title')} placeholder="标题" />
<textarea value={draft.content} onChange={update('content')} placeholder="正文" rows={3} />
<input value={draft.sourceUrl} onChange={update('sourceUrl')} placeholder="来源链接" />
<input value={draft.tags} onChange={update('tags')} placeholder="标签,用逗号分隔" />
{error && <p className="error">{error}</p>}
<button type="submit">保存</button>
</form>
);
}
三个值得注意的写法:
update(field)返回一个处理函数,避免写四个几乎一样的onChange。这是"用函数生成函数",不是立即执行——onChange={update('title')}会在渲染时调用update,返回的那个箭头函数才是事件处理器。- 用
e.preventDefault()拦住表单的默认提交(否则浏览器会刷新整页,state 全丢)。这是 SPA 里最容易忘的一行。 tags用逗号分隔的字符串,提交时才 split。如果存成数组,每敲一个字符都要处理"逗号还没输完"的中间态,反而更麻烦。
App:接上新增
src/App.jsx 里加:
import NoteForm from './components/NoteForm';
function handleAdd(input) {
const note = {
id: `n${Date.now()}`,
...input,
createdAt: new Date().toISOString().slice(0, 10),
};
setNotes((prev) => [note, ...prev]);
setActiveTag('all');
}
setNotes((prev) => [note, ...prev]) 用函数式更新,新的一条放在最前。为什么要 setActiveTag('all')?
因为如果当前筛选是 css,而新摘录没有 css 标签,保存后它会立刻被过滤掉。用户看到的是"我点了保存,什么都没发生",然后重复提交三次。这是产品问题伪装成技术问题,一行代码就能避免。
id 用 Date.now() 是这一卷的临时方案(本地假数据,够用)。卷 5 接了真接口后,id 由后端生成,前端不再自己造。
预期效果:填标题和正文,标签写 js, 读书,点保存。新卡片出现在列表最上方,标签变成两个小方块,表单清空,计数加 1。标题留空点保存,出现红字"标题不能为空",列表不变。
做三个实验,验证你理解了原理
实验一:把不可变改成原地改。
// 把 setNotes((prev) => [note, ...prev]) 换成
notes.push(note);
setNotes(notes);
现象:表单清空了(因为 setDraft 正常),列表一条没多。控制台打印 notes.length 是 4。这就是 4.3.1 开头那个场景。
实验二:去掉 onChange。
把标题输入框改成 <input value={draft.title} placeholder="标题" />。现象:这个框完全打不进字,控制台出现坑二里那条警告。改回来。
实验三:把派生状态存进 state。
按 4.3.2 里的反例,用 useState + useEffect 维护 filtered,但故意在 handleAdd 里只 setNotes 不更新 filtered。现象:新增成功、计数变了、列表没变。你会花十分钟怀疑 filter 写错了,其实只是多存了一份状态。
4.3.4 三个坑
坑一:push / splice 之后界面不更新
症状:点"添加"没反应,点"删除"没反应;console.log 里数组长度确实变了;刷新页面后数据又对(因为重新读了一次源数据)。有时更诡异:列表少了一项,但计数没变。
成因:push、splice、sort、reverse 都返回"原数组"或"被删元素",引用没变。React 用 Object.is 比较新旧 state,同一个引用直接跳过渲染。
修法:所有修改都造新数组——追加用展开、删除用 filter、修改用 map、排序先 [...arr]。判断口诀:看到 push/splice/sort 直接作用在 state 上,就是 bug。
坑二:给了 value 却忘了 onChange
症状:输入框完全打不进字,光标在闪但按键盘没反应,看起来像"页面卡了"。
成因:React 把有 value 无 onChange 的输入框当成只读。控制台会明确告诉你:
Warning: You provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`.
修法:补上 onChange。如果确实只想显示不想改,显式写 readOnly,把警告消掉的同时也表达了意图。
坑三:onClick={handleAdd()} 导致无限渲染
症状:页面一打开就卡死,或者点一下按钮后浏览器风扇狂转,控制台:
Too many re-renders. React limits the number of renders to prevent an infinite loop.
成因:JSX 里 {} 是求值,不是"注册回调"。handleAdd() 带括号,会在渲染时立刻执行;它内部调用 setNotes,触发重渲染,重渲染又执行一次 handleAdd()……直到 React 熔断。
修法:传函数本身,或用箭头函数包一层。
<button onClick={handleAdd}>保存</button> // 事件触发时执行
<button onClick={() => handleAdd(note.id)}>保存</button> // 需要传参时包一层
顺带记一个同源现象:onSubmit={handleSubmit()} 也会这样,而且它还会让"提交"在页面加载时就跑一次。
本章验收
- 能用自己的话解释"重新渲染 = 重新执行组件函数",并说出哪些东西会保留
- 表单四个输入框全部受控,保存后清空,标题为空时报错
- 亲手把
setNotes([...])改成push再改回来,看到"数据变了界面不动" - 能默写追加、删除、修改一项的三种不可变写法
- 能说出为什么
filtered不该放进useState
自测
Q1:为什么 setNotes(notes) 在 notes.push(x) 之后不会触发更新,而 setNotes([...notes, x]) 会?
看答案
React 用 Object.is 比较新旧 state。push 改的是同一个数组对象,前后引用相同,React 判定"没有变化"并跳过渲染;展开语法创建了一个新数组,引用不同,于是正常排队重渲染。注意 push 的副作用已经发生了——数据确实变了,只是界面不知道,所以这类 bug 特别难查。Q2:一个页面里 setA(1); setB(2); 连续两次,会渲染几次?这对写代码有什么影响?
看答案
在 React 18+ 的事件处理函数里会被批处理成一次渲染。好处是不会出现"A 已更新、B 还是旧值"的中间态;影响是不能在 set 之后立即读 state 拿新值,需要新值时应该用你构造出来的局部变量,或用函数式更新。Q3:为什么说"props 的副本不要放进 state"?举一个会出问题的场景。
看答案
useState 的初始值只在首次渲染时使用,之后 props 变化不会同步过去。场景:详情页用 useState(note.title) 做编辑框,用户从 A 切到 B,编辑框里还是 A 的标题,因为组件没卸载、state 没重置。正确做法是直接用 props,或者给组件加 key={note.id} 强制重建。下一步
状态和表单都就位了,但数据还是从本地数组读的。下一章处理"从外面拿数据"这件事:什么时候发请求、怎么清理、为什么快速切页会让旧结果盖掉新结果。