组件、props 与 JSX
本合集目录
本章目录
单册说明:本文件是卷 4 的第 2 章,可独立阅读。前置:第 1 章(三笔债)、卷 3 第 6 章(Vite 的 dev/build)。本章把上一卷那个"一个
app.js管所有 DOM"的工程,拆成三个能复用的组件。
| 项 | 内容 |
|---|---|
| 所属卷 | 卷 4 · React 与 Next.js(第 2 / 8 章) |
| 前置章节 | 4.1 为什么需要框架;3.6 Vite 开发与构建 |
| 本章产出 | NoteCard / NoteList / TagFilter 三个组件 + 一份"该不该拆"的判断标准 |
| 对应代码 | dudao-frontend/src/components/、src/data/notes.js |
| 配图 | 无(后续统一制图) |
| 读完的判定 | 能解释 key 为什么不能用下标,并能当场复现一次状态错位 |
4.2.1 一句话结论:组件是"输入 props、输出 UI"的函数,别的都不是
一个组件只该有这两件事:接收什么、渲染成什么。它不该自己去找数据,不该自己去改别人的东西,也不该在渲染的时候顺手干别的事。
先看一个新手一定会撞的报错。你把组件写成小写开头:
<noteCard note={note} />
页面这块区域空白,控制台出现:
Warning: The tag <noteCard> is unrecognized in this browser. If you meant to render a React component, start its name with an uppercase letter.
原因很直接:JSX 编译后,首字母小写的标签被当成原生 HTML 标签(就像 div、span),大写开头才会被当成变量引用。React 的规则不是"约定",是编译规则。
4.2.2 原理与方法
JSX 编译成什么
JSX 不是字符串模板,也不是浏览器能认的语法。它在构建时被翻译成函数调用。
| 你写的 | 编译后(自动 runtime) |
|---|---|
<h1 className="title">读到</h1> |
_jsx('h1', { className: 'title', children: '读到' }) |
<NoteCard note={n} /> |
_jsx(NoteCard, { note: n }) |
<ul>{list.map(...)}</ul> |
_jsx('ul', { children: list.map(...) }) |
<>{a}{b}</> |
_jsx(_Fragment, { children: [a, b] }) |
现代构建工具用"自动 runtime",所以文件里不需要 import React from 'react'。你只需要 import { useState } from 'react' 这类具名导入。
这个翻译过程解释了四条看起来莫名其妙的规则:
| 规则 | 为什么 |
|---|---|
写 className 不写 class |
class 是 JS 保留字,而 DOM 属性本来就叫 className |
写 htmlFor 不写 for |
同上 |
表达式用 {},且只能放表达式 |
编译产物是对象字面量,if/for 是语句,塞不进去 |
| 组件必须大写开头 | 小写会被编译成字符串 'noteCard' |
"只能放表达式"这条最常咬人:{ if (x) ... } 直接语法错误。所以条件要用三元或 &&,循环要用 map——不是为了好看,是编译器的硬约束。
props 是单向的
数据从父流向子,子组件只读。React 在开发模式下会冻结 props 对象,你硬改会得到:
TypeError: Cannot assign to read only property 'title' of object '#<Object>'
(严格模式下直接抛错;非严格模式下静默失败,更难查。)
正确的心智模型是:子组件不能改数据,只能"请求"父组件改。 请求的方式是调用父组件传下来的函数。
| 想做 | 不要 | 要 |
|---|---|---|
| 删除一条 | 在 NoteCard 里改 notes 数组 |
调 onDelete(note.id),让父组件改 |
| 修改标题 | 给 note.title 赋值 |
调 onEdit(id, newTitle) |
| 关闭弹窗 | 在子组件里改父组件的 open |
调 onClose() |
这条规则不是洁癖。它保证"数据只有一个修改入口",出问题时你只需要在一个地方打断点。
列表与 key
渲染列表的固定写法:
{notes.map((note) => <NoteCard key={note.id} note={note} />)}
漏掉 key,控制台会给:
Warning: Each child in a list should have a unique "key" prop.
很多人把这个警告当成"消除一下就好",于是写 key={index}。这就是下一节要讲的真实事故。
key 是什么:它是 React 判断"这一项还是不是上一轮那一项"的身份标识。没有 key 时 React 退化成用下标,等于告诉你:"位置就是身份。"
具体现场(本章 4.2.3 会让你亲手复现):列表三条,每张卡片里有一个自己的"展开"状态。
- 你点开第三条,它展开;
- 你删掉第一条;
- 现在的第二条(原来的第三条)没有展开,而原来的第二条展开了。
因为 React 看到的是"key=0、1 还是那三个组件",它保留了组件内部状态,只把 props 换了一遍。状态留在了位置上,而不是跟着数据走。
同样的错位也会发生在输入框上:在列表头部插入一条,所有输入框的内容整体下移一格。用户会以为"我输的字跑到了别人那一行"。
| key 的取值 | 能不能用 | 说明 |
|---|---|---|
| 数据库 id / 稳定的业务 id | 最好 | 身份和数据绑定,增删排序都正确 |
index |
有条件 | 仅当:只追加、不删除、不排序、项内无状态,四条同时满足 |
Math.random() |
不行 | 每次渲染都是新身份,整列表重建,输入框必失焦 |
title 之类的业务字段 |
谨慎 | 可能重复;重复的 key 会引发另一类错位 |
条件渲染的四种写法
| 写法 | 代码 | 适用 | 注意 |
|---|---|---|---|
| 提前 return | if (!note) return <p>未找到</p> |
整个组件都不该出现 | hook 必须写在 return 之前 |
| 三元 | {loading ? <Spinner /> : <List />} |
二选一 | 嵌套超过两层就拆函数 |
&& |
{error && <p>{error}</p>} |
有或没有 | 左边是 0 时会渲染出 0 |
| 变量 | const body = ...; return <div>{body}</div> |
分支多 | 可读性最好,推荐 |
&& 那个坑值得单独说:{notes.length && <NoteList />} 在列表为空时,页面会出现一个孤零零的 0。因为 0 是 falsy,但 React 会把数字 0 当内容渲染出来。写成 notes.length > 0 && ... 就好。
children:让组件当"壳"
function Panel({ title, children }) {
return (
<section className="panel">
<h2>{title}</h2>
{children}
</section>
);
}
<Panel title="本周新增">
<NoteList notes={recent} />
</Panel>
children 就是"标签中间那一段"。它适合做布局壳、弹窗、卡片容器。不要把它当成"传数据的第二通道"——数据走具名 props,只有"这块区域由调用方决定"时才用 children。
组件可以返回 null
一个组件返回 null 是合法的,表示"这次什么都不渲染",适合"没权限就不显示"这类情况。但不要返回 false:JSX 里的 false 会被忽略,可组件函数 return false 会直接报:
Nothing was returned from render. This usually means a return statement is missing. Or, to render nothing, return null.
统一用 null,不要用 false。
拆到什么粒度
拆太粗,组件变成一坨;拆太细,props 一路透传五层,改一个字段要动六个文件。三条可操作的判断:
| 信号 | 动作 |
|---|---|
| 它有自己的状态(展开、输入、选中) | 拆出去,状态跟着走 |
| 它要在同一个列表里重复出现 | 拆出去,用 props 差异化 |
| 描述它时需要说"和/或" | 里面还有两个组件 |
| 文件超过 150 行 | 找边界拆,通常能拆出 2–3 个 |
只是为了少写两行 <div> |
不拆 |
反面案例也要认识:把每个 <span> 都包成组件,props 从 App 传到第 5 层才用上,这叫 prop drilling(属性钻取),是另一种维护灾难。出现这种情况,说明该用状态提升或 context,而不是继续拆。
4.2.3 动手:拆出三个组件
建工程
npm create vite@latest dudao-frontend -- --template react
cd dudao-frontend
npm install
npm run dev
模板选 react,不要选 react-ts——本书全程 JavaScript。启动后浏览器打开终端里给出的地址,看到 Vite 的示例页就算成功。
清空 src/App.jsx 里模板自带的内容,删掉 src/assets/react.svg 的引用。
数据层
新建 src/data/notes.js。这一卷所有数据都从这里来,卷 5 再换成真接口。
export const notes = [
{
id: 'n1',
title: '闭包是函数和它的词法环境',
content: '函数记住它被定义时所在的作用域,即使离开了那个作用域,仍然能访问里面的变量。',
sourceUrl: 'https://example.com/closure',
tags: ['js'],
createdAt: '2026-11-02',
},
{
id: 'n2',
title: '盒模型把内容、内边距、边框、外边距分开算',
content: 'width 默认只算内容区。加上 padding 和 border 之后,元素实际占的宽度会更大。',
sourceUrl: 'https://example.com/box-model',
tags: ['css'],
createdAt: '2026-11-05',
},
{
id: 'n3',
title: 'effect 的清理函数在下次执行前调用',
content: '清理不只是"卸载时",每次依赖变化导致的重新执行之前,也会先跑一遍清理。',
sourceUrl: 'https://example.com/effect',
tags: ['js', 'react'],
createdAt: '2026-11-09',
},
];
export const allTags = [...new Set(notes.flatMap((n) => n.tags))];
new Set(...) 去重,flatMap 把每条的标签摊平成一个数组。这两行在第 1 章的原生版本里也出现过。
NoteCard:一个只负责显示
src/components/NoteCard.jsx:
export default function NoteCard({ note, onDelete }) {
return (
<article className="card">
<h3>{note.title}</h3>
<p>{note.content}</p>
<ul className="tags">
{note.tags.map((tag) => (
<li key={tag}>{tag}</li>
))}
</ul>
<div className="card-foot">
<a href={note.sourceUrl} target="_blank" rel="noreferrer">原文</a>
<button type="button" onClick={() => onDelete(note.id)}>删除</button>
</div>
</article>
);
}
两个细节:
onClick={() => onDelete(note.id)}是包了一层函数。写成onClick={onDelete(note.id)}会在渲染时立刻执行删除,页面一打开数据就没了——这一章末尾的坑三讲的就是它。- 标签列表的
key={tag}用的是标签名。同名标签不会出现在同一条里(数据层已去重),所以它是稳定且唯一的。
NoteList:负责空态和计数
src/components/NoteList.jsx:
import NoteCard from './NoteCard';
export default function NoteList({ notes, onDelete }) {
if (notes.length === 0) {
return <p className="empty">没有匹配的摘录</p>;
}
return (
<section>
<p className="count">共 {notes.length} 条</p>
<div className="list">
{notes.map((note) => (
<NoteCard key={note.id} note={note} onDelete={onDelete} />
))}
</div>
</section>
);
}
注意 key 放在 map 返回的最外层元素上,不是放在 NoteCard 内部的 <article> 上。写在组件标签上,React 才拿得到。
TagFilter:受控的高亮
src/components/TagFilter.jsx:
export default function TagFilter({ tags, activeTag, onChange }) {
return (
<div className="filters">
<button
type="button"
className={activeTag === 'all' ? 'active' : ''}
onClick={() => onChange('all')}
>
全部
</button>
{tags.map((tag) => (
<button
key={tag}
type="button"
className={activeTag === tag ? 'active' : ''}
onClick={() => onChange(tag)}
>
{tag}
</button>
))}
</div>
);
}
这个组件没有自己的状态。它显示什么由 activeTag 决定,点哪个由 onChange 通知父级。这种"状态在父、组件只管显示"的结构,下一章会正式叫它"受控组件"。
App:把三个拼起来
src/App.jsx:
import { useState } from 'react';
import { notes as seedNotes, allTags } from './data/notes';
import NoteList from './components/NoteList';
import TagFilter from './components/TagFilter';
import './App.css';
export default function App() {
const [notes, setNotes] = useState(seedNotes);
const [activeTag, setActiveTag] = useState('all');
const visible = activeTag === 'all'
? notes
: notes.filter((n) => n.tags.includes(activeTag));
function handleDelete(id) {
setNotes(notes.filter((n) => n.id !== id));
}
return (
<main className="page">
<h1>读到</h1>
<TagFilter tags={allTags} activeTag={activeTag} onChange={setActiveTag} />
<NoteList notes={visible} onDelete={handleDelete} />
</main>
);
}
useState 下一章细讲。现在只需要知道:它让组件"记住"一个值,调用 setXxx 会让组件重新执行一遍。
src/App.css 给一点最低限度的样式,能看清结构就够:
.page { max-width: 680px; margin: 40px auto; padding: 0 16px; font-family: system-ui, sans-serif; }
.filters { display: flex; gap: 8px; margin-bottom: 16px; }
.filters button { padding: 4px 12px; border: 1px solid #ddd; background: #fff; border-radius: 999px; cursor: pointer; }
.filters button.active { background: #1f2937; color: #fff; border-color: #1f2937; }
.card { border: 1px solid #e5e7eb; border-radius: 8px; padding: 16px; margin-bottom: 12px; }
.card h3 { margin: 0 0 8px; font-size: 17px; }
.card-foot { display: flex; justify-content: space-between; align-items: center; }
.tags { display: flex; gap: 6px; list-style: none; padding: 0; }
.tags li { font-size: 12px; background: #f3f4f6; padding: 2px 8px; border-radius: 4px; }
.count { color: #6b7280; font-size: 14px; }
.empty { color: #6b7280; }
预期效果:一个标题、四个标签按钮、三张卡片、一行"共 3 条"。点 css,只剩一张卡片且计数变 1。点删除,卡片消失、计数同步减少。整个过程页面不刷新。
复现 key 的错位(本章最重要的一步)
在 NoteCard 里加一个自己的展开状态:
import { useState } from 'react';
export default function NoteCard({ note, onDelete }) {
const [open, setOpen] = useState(false);
return (
<article className="card">
<h3 onClick={() => setOpen(!open)}>{note.title}</h3>
{open && <p>{note.content}</p>}
<button type="button" onClick={() => onDelete(note.id)}>删除</button>
</article>
);
}
然后把 NoteList 里的 key={note.id} 改成 key={index}(map 的第二个参数)。操作顺序:
- 点开第三张卡片的标题,正文展开;
- 点第一张卡片的"删除";
- 观察:现在的第二张(原第三张)收起了,而现在的第一张(原第二张)展开了。
再把 key 改回 note.id,重复一次,错位消失。
这就是"用下标当身份"的代价:位置变了,状态不跟着数据走。 列表只追加时可以侥幸不出错,一旦有删除、排序、筛选,就会以各种奇怪的方式冒出来。
4.2.4 三个坑
坑一:key={index}
症状:删除中间一项后,展开状态、输入内容、勾选状态整体串位;排序后更明显。控制台没有任何警告。
成因:React 用 key 匹配"上一轮的哪个组件对应这一轮的哪个组件"。下标在增删后会重新编号,React 认为"还是那三个位置",于是保留组件实例和内部状态,只换 props。
修法:用数据自带的稳定 id。没有 id 时,在数据进入列表前生成一个(比如创建时用 crypto.randomUUID()),不要在下标上凑合。
坑二:{count && <List />} 渲染出一个 0
症状:列表为空时,页面上多了一个孤零零的 0,位置通常在标题下面。
成因:0 是 falsy,0 && x 的结果是 0,而 React 会把数字 0 当文本节点渲染。false、null、undefined 会被忽略,0 和空字符串不会。
修法:左边换成布尔表达式。
{notes.length > 0 && <NoteList notes={notes} />}
{error ? <p>{error}</p> : null}
同一个坑还会出现在 {items.length && ...}、{score && ...} 上。凡是左边可能是数字的,都加比较。
坑三:组件名小写,或者传了未定义的组件
症状:那块区域空白,DOM 里出现一个 <notecard> 这样的自定义标签,控制台报:
Warning: The tag <noteCard> is unrecognized in this browser. If you meant to render a React component, start its name with an uppercase letter.
成因:JSX 编译时按首字母判断——小写当字符串标签,大写当变量。另一种同源情况是 import 写错名字,变量是 undefined,React 会报 Element type is invalid。
修法:组件文件与组件名都用大驼峰(NoteCard),文件名保持一致;导入后先在 console.log(NoteCard) 确认不是 undefined。这条规则没有例外,记住"大写是变量,小写是标签"就不会再犯。
本章验收
- 能说出 JSX 编译后的样子,并解释为什么不能写
if语句 - 三个组件已拆好,
App.jsx里只剩拼装和数据 - 亲手复现了
key={index}导致的状态错位,并改回note.id修好 - 能说出
{count && ...}在什么情况下会渲染出0 - 能解释为什么子组件不能直接改 props
自测
Q1:为什么 key 不能随便用 Math.random()?
看答案
key 的作用是跨渲染识别"同一项"。随机值每次渲染都不同,React 会认为所有项都是全新的,于是卸载重建整个列表。后果是输入框失焦、动画重放、组件内部状态全部丢失,性能也变差。key 必须"同一条数据在多次渲染中保持不变"。Q2:<NoteCard note={note} onDelete={handleDelete} /> 和 <NoteCard note={note} onDelete={handleDelete()} /> 有什么区别?
看答案
前者把函数本身传下去,点删除时才调用;后者在渲染时立刻调用 `handleDelete()`,把返回值(通常是 undefined)当成 onDelete 传下去。如果 `handleDelete` 里调用了 setState,就会在渲染期间更新状态,轻则删错数据,重则报 `Too many re-renders`。判断口诀:括号是"现在执行",函数名是"以后执行"。Q3:一个组件拆不拆,你用什么标准判断?举一个"不该拆"的例子。
看答案
看它是否有独立状态、是否在列表里重复、描述它时是否需要用"和/或"、文件是否过长。不该拆的例子:只为了避免重复写 `下一步
组件有了,但界面还是"死"的:点按钮改的是父组件的变量,输入框的值还散在 DOM 里。下一章把状态收拢到一处,并让表单真正受控。