React / 系统课时

Context 跨层共享

Context 跨层共享

本课解决属性需要逐层传递的问题。你将创建一个 Context,把主题信息从顶层提供给深层组件,并掌握 Provider、消费组件与默认值之间的职责边界。

学习目标

  • 创建 Context 并在组件树上层提供数据
  • 使用 useContext 在任意后代组件中读取共享值
  • 识别 Context 的适用场景与性能边界

为什么需要 Context

当顶层组件的数据只被深层组件使用时,若仍通过 props 一层层转交,中间组件会被迫接收自己并不关心的参数。这种现象通常称为属性逐层传递。

Context 在组件树中建立一个共享范围:Provider 提供值,范围内的后代组件按需读取。中间组件无需声明或转发对应 props。

Context 跨层共享结构

创建并提供 Context

下面的完整示例创建主题 Context,并在顶层组件中提供当前主题及切换函数。深层的 ThemeButton 不需要经过 Layout 转发数据。

jsx
import { createContext, useContext, useState } from "react";

const ThemeContext = createContext(null);

function ThemeButton() {
  const context = useContext(ThemeContext);

  // 自定义错误能比读取 null 属性更快暴露 Provider 缺失问题
  if (context === null) {
    throw new Error("ThemeButton 必须位于 ThemeContext.Provider 内");
  }

  const { theme, toggleTheme } = context;

  return (
    <button type="button" onClick={toggleTheme}>
      当前主题:{theme}
    </button>
  );
}

function Layout() {
  return (
    <main>
      <h2>设置面板</h2>
      <ThemeButton />
    </main>
  );
}

export default function App() {
  const [theme, setTheme] = useState("light");

  function toggleTheme() {
    setTheme((current) => (current === "light" ? "dark" : "light"));
  }

  return (
    <ThemeContext.Provider value={{ theme, toggleTheme }}>
      <Layout />
    </ThemeContext.Provider>
  );
}

预期结果

text
页面初始显示“当前主题:light”。
点击按钮后显示“当前主题:dark”,再次点击切换回 light。
Layout 不需要接收或转发 theme 与 toggleTheme。

createContext(null) 创建上下文对象,Provider 的 value 决定当前共享值。useContext(ThemeContext) 会读取距离当前组件最近的同类 Provider;当 Provider 的值改变时,使用该 Context 的组件会重新渲染。

默认值与 Provider 范围

createContext 的参数只在组件上方找不到 Provider 时生效。默认值不是 Provider 初始值,也不会随着状态变化。对于必须依赖 Provider 的业务 Context,使用 null 作为默认值并在自定义 Hook 中检查,通常更容易发现配置错误。

可以把读取逻辑封装起来。下面是片段示例,依赖 React 运行环境,并要求调用方在组件树上层提供 UserContext.Provider:

jsx
import { createContext, useContext } from "react";

export const UserContext = createContext(null);

export function useCurrentUser() {
  const user = useContext(UserContext);

  if (user === null) {
    throw new Error("useCurrentUser 必须在 UserContext.Provider 内使用");
  }

  return user;
}

生效行为

text
Provider 范围内调用 useCurrentUser() 时返回当前用户对象。
Provider 缺失时立即抛出明确错误,而不是继续使用无效数据。

这段代码是可复用模块,使用时还需要在组件树上层渲染 UserContext.Provider 并传入真实用户对象。

适用场景与性能边界

Context 适合主题、登录用户、语言、权限摘要和全局配置等“许多后代组件需要、但更新频率不高”的数据。局部表单值或只在相邻组件间传递的数据,优先使用 props,数据来源会更清晰。

Provider 的 value 改变后,所有消费该 Context 的后代都可能重新渲染。若把大量无关字段放进同一个对象,任何字段变化都会扩大更新范围。可按职责拆分多个 Context,并用 useMemo 稳定包含函数的对象值,但不要在没有性能证据时过度优化。

Context 负责传递数据,不负责定义状态如何更新。复杂业务仍应把状态管理、请求和缓存逻辑放在清晰的 Hook 或专用状态层中,再通过 Context 暴露必要接口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Context 跨层共享

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通