---
tags: [React, JSX, TSX, Frontend]
create time: 2026-04-29 22:01
---

# JSX 语法

## 概述

JSX（JavaScript XML）是 React 的核心语法糖。它让开发者能够在 JavaScript 中直接编写类似 HTML 的结构，经编译后转化为 `React.createElement()` 调用。理解 JSX 的底层机制是掌握 React 渲染原理的基础。

## JSX 的本质

JSX 并不是模板字符串，编译后会变成普通的 JavaScript 对象：

```jsx
// 你写的 JSX
const element = <h1 className="title">Hello, World!</h1>;

// 编译后的产物
const element = React.createElement(
  "h1",
  { className: "title" },
  "Hello, World!"
);
```

> [!warning] 关键点
> - `React.createElement` 返回的是一个 **Plain Object**（虚拟 DOM 节点），不是真实的 DOM 元素
> - 这也是为什么 JSX 不会直接操作浏览器 API，而是由 React 的 Reconciler 统一管理

## 表达式嵌入

在 JSX 中用 `{}` 包裹 JavaScript 表达式：

```jsx
function FormattedDate({ date }) {
  return (
    <>
      <h1>Hello!</h1>
      <h2>今天 {date.toLocaleDateString()}.</h2>
      {/* 条件：JSX 不能用 if-else，用三元运算符或逻辑与 */}
      {date.getTime() < Date.now() && <p>日期已过期</p>}
      {/* 数组渲染：每个元素需要 key prop */}
      {[1, 2, 3].map(n => (
        <span key={n}>{n}</span>
      ))}
    </>
  );
}
```

### 允许与不允许的表达式

| ✅ 允许 | ❌ 不允许 |
|---------|----------|
| `{variable}` | `{if (x) ...}` — JSX 中不支持语句 |
| `{arr.map(...)}` | `{for (let i...)}` — 同上 |
| `{cond && <Comp />}` | `{func()}` — 函数无返回值时渲染 `undefined`（不报错但不生效）|
| `{null}`, `{false}` | `{""}`, `{0}` — 会渲染空字符串或数字 `0`，常见陷阱 |

> [!question] 为什么 `{cond ? <A /> : func()}` 能跑？
> - 这是合法的 JS 表达式——只要 `func()` 返回一个值即可
> - 但建议写成 `{cond ? <A /> : <B />}`，保持视觉一致性，避免混用 JSX 和函数调用

> [!note] null / undefined / boolean vs "" / 0
> - `null`、`undefined`、`true`、`false` 渲染结果为空——这是有意设计
> - `0` 和 `""` 会输出到 DOM，常见陷阱

## 条件渲染模式

```jsx
// 模式1：&& 短路（推荐用于简单场景）
{isLoggedIn && <AdminDashboard />}

// 模式2：三元运算符（适合两种视图切换）
{isLoading ? <Spinner /> : <Content />}

// 模式3：提取为组件（复杂条件逻辑）
return <UserCard user={user} showActions={isAdmin} />;

// 模式4：IIFE（极少使用，仅临时调试）
{(function () {
  if (!data) return <EmptyState />;
  return <DataDisplay data={data} />;
})()}
```

## 列表渲染与 Key

```tsx
interface TodoItem {
  id: number;
  text: string;
  completed: boolean;
}

function TodoList({ items }: { items: TodoItem[] }) {
  return (
    <ul>
      {items.map((item) => (
        <li key={item.id}>
          <input type="checkbox" checked={item.completed} readOnly />
          {item.text}
        </li>
      ))}
    </ul>
  );
}
```

> [!question] 思考：为什么 React 要求列表项必须有 key？
> - Key 帮助 React 识别哪些条目变了/增了/删了，从而最小化重渲染次数
> - 不建议用 index 作为 key（当列表顺序变化时会导致状态错乱）

## JSX 事件绑定

```jsx
function ClickCounter() {
  const [count, setCount] = useState(0);

  // 驼峰命名，不要写 onClick="handler()"
  const handleClick = () => setCount(c => c + 1);

  // 阻止默认行为
  const handleSubmit = (e: React.FormEvent) => {
    e.preventDefault();
  };

  return (
    <div>
      <button onClick={handleClick}>Count: {count}</button>
      <form onSubmit={handleSubmit}>
        <input type="text" name="q" />
      </form>
    </div>
  );
}
```

### 事件传参

当需要向事件处理函数传递参数时，有两种写法：

```tsx
interface TodoItemProps {
  id: number;
  onDelete: (id: number) => void;
}

function TodoItem({ id, onDelete }: TodoItemProps) {
  return (
    <button onClick={() => onDelete(id)}>
      {/* ⚡ 箭头函数包裹：创建闭包捕获当前 id */}
      删除
    </button>
  );
}
```

> [!warning] 常见陷阱
> - ~~`onClick={onDelete(id)}`~~ ❌ — 会在渲染时立即执行 `onDelete`，而非点击时执行
> - ~~`onClick={onDelete}`~~ — 缺少参数，不知道要删除哪个
> - ✅ **正确姿势**：`() => onDelete(id)` — 用箭头函数延迟执行并捕获参数
> - 💡 如果不需要参数，直接传引用即可：`onClick={handleClick}`（不要加括号）

### 常用合成事件类型

```ts
type MouseEvents    = React.MouseEvent<HTMLButtonElement>;
type FormEvents     = React.FormEvent<HTMLFormElement>;
type ChangeEvents   = React.ChangeEvent<HTMLInputElement>;
type KeyboardEvents = React.KeyboardEvent<HTMLDivElement>;
```

> [!tip] TypeScript 事件类型的推导技巧
> - 不传泛型时：`event.target` 类型为 `EventTarget`（信息最少）
> - 传入具体元素后：`event.currentTarget` 可以精确定位到对应 DOM 类型
> - 💡 **最佳实践**：优先使用 `currentTarget` 而非 `target`，避免类型收窄问题

## JSX 基本规则

写 JSX 时有几条硬性规则需要遵守：

```tsx
// 规则1：自闭合标签 —— 无子元素的元素必须加 /
<img src={avatar} alt="头像" />
<Input placeholder="搜索..." />

// 规则2：className 替代 class
<div className="card">内容</div>
// <div class="card"> ❌ — "class"是JS保留字

// 规则3：style 接收对象而非字符串
<div style={{ color: "red", fontSize: 16 }}>样式</div>
// 驼峰命名：fontSize, backgroundColor, gridColumn 等

// 规则4：单根节点或 Fragment
const Card = ({ title, children }) => (
  <> {/* ✅ Fragment：不产生额外 DOM 节点 */}
    <h2>{title}</h2>
    <div>{children}</div>
  </>
);
```

> [!note] key 属性的唯一要求
> - `key` 只在数组上下文中有效——它是 React 的元数据，不会被传递给组件
> - 在自定义组件上使用 key 会报错：**key 只能在列表子元素上使用**

## Props 传递方式

```tsx
interface CardProps {
  title: string;
  className?: string;
  children: React.ReactNode;
}

function Card({ title, className = "", children }: CardProps) {
  return (
    <div className={`card ${className}`}>
      <h3>{title}</h3>
      {children}
    </div>
  );
}

// 展开 props
const attrs = { className: "card", title: "详情" };
<Card {...attrs} />;

// 动态属性名
<div style={{ color: isActive ? "red" : "black" }}>

// 受控 props（父组件控制子组件内部 state）
<Select value={selectedValue} onChange={setSelectedValue} />

// 函数作为 prop（常见于表单回调）
<SearchBar onSearch={(q) => setQuery(q)} />
```

> [!question] 为什么 children 的类型是 React.ReactNode 而不是 JSX.Element？
> - `JSX.Element` 只代表 React 元素（如 `<div />`、`<Comp />`）
> - `React.ReactNode` 包含更多可能：字符串、数字、Fragment、甚至 null/undefined
> - 💡 使用 `JSX.Element` 会报错当子元素是纯文本或数组时

## JSX 与模板引擎对比

```mermaid
graph LR
    A[JSX] --> B["编译期检查"]
    A --> C["完整的 JavaScript 能力"]
    A --> D["类型安全（TS）"]
    
    E["模板引擎 v-html/v-if"] --> F["运行时解析"]
    E --> G["字符串插值 {{}}"]
    E --> H["有限的 JS 表达式"]
    
    style A fill:#61DAFB,color:#000
    style E fill:#42B883,color:#fff
```

> [!tip] JSX 的核心优势
> 1. **强类型** — 配合 TypeScript 编译期拦截错误
> 2. **零额外语法** — 没有 {{}} / v-if / v-for 等新规则，一切在 JS 中
> 3. **JS 全能力** — 解构、spread、闭包、高阶函数随时可用

## JSX 渲染流程

```mermaid
sequenceDiagram
    participant Dev as 开发者
    participant Babel as Babel/TSX
    participant React as React Runtime
    participant VDOM as Fiber (虚拟 DOM)
    participant Diff as Reconciler Diff
    participant BM as Browser API

    Dev->>Babel: 编写 JSX：<h1>Hello</h1>
    Note over Dev,Babel: "编译期转换，非运行时"
    Babel->>Babel: 转译成 createElement()
    Babel->>React: React.createElement("h1", null, "Hello")
    Note over React: 返回 VDOM Plain Object
    React->>VDOM: 创建/更新 Fiber 树
    VDOM->>Diff: Diff 算法比较新旧树
    Diff->>Diff: 找出最小变更集
    Diff->>BM: patch 真实 DOM
    Note over BM: "批量更新，一次 Reflow/Repaint"
```

> [!note] 一句话总结渲染流程
> JSX → `createElement()` → VDOM → **Diff** → patch 真实 DOM
> 
> JSX 的每次重新渲染都经历完整的 Diff 过程——这也是为什么理解 key 的作用至关重要。