跳到正文
零到全栈 · 卷 4 · 从页面到应用

组件、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 会让你亲手复现):列表三条,每张卡片里有一个自己的"展开"状态。

  1. 你点开第三条,它展开;
  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 的第二个参数)。操作顺序:

  1. 点开第三张卡片的标题,正文展开;
  2. 点第一张卡片的"删除";
  3. 观察:现在的第二张(原第三张)收起了,而现在的第一张(原第二张)展开了。

再把 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:一个组件拆不拆,你用什么标准判断?举一个"不该拆"的例子。

看答案 看它是否有独立状态、是否在列表里重复、描述它时是否需要用"和/或"、文件是否过长。不该拆的例子:只为了避免重复写 `
` 而包一层 `Row` 组件,结果 props 要透传三层,读代码时得来回跳文件——这种抽象没有降低理解成本,只增加了跳转次数。

下一步

组件有了,但界面还是"死"的:点按钮改的是父组件的变量,输入框的值还散在 DOM 里。下一章把状态收拢到一处,并让表单真正受控。

→ 卷4-03-状态与受控组件.md