Vue Academy · 课时

高阶组件（HOC）模式

Q: 「高阶组件（HOC）模式」这节课中我会学到什么？

使用 HOC 包装组件、透传 props 与插槽，以及了解何时使用 HOC 而非组合式函数 你通过在浏览器中直接运行的动手代码来练习 Vue Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用 HOC 包装组件、透传 props 与插槽，以及了解何时使用 HOC 而非组合式函数

高阶组件（HOC）模式 是 CoddyKit 上的免费 Vue Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Vue Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Vue Academy 课程共包含 4 节课。

什么是高阶组件

高阶组件（HOC）是一个接收组件并返回新组件的函数，新组件会包装原组件。它可以在不修改原组件的情况下添加日志记录、身份验证检查或数据加载等横切行为。

函数签名

按照惯例，HOC 的名称以 with 开头。它接收被包装的组件，并返回增强后的组件。

function withLogging(Wrapped) {
  // return a new component
}

返回 defineComponent

新组件通过 defineComponent 构建。它的 setup 函数会使用 h 渲染被包装的组件。

import { defineComponent, h } from "vue";

function withLogging(Wrapped) {
  return defineComponent({
    setup(props, ctx) {
      return () => h(Wrapped, props, ctx.slots);
    }
  });
}

转发属性

为了让包装器保持透明，请将 ctx.attrs 展开到被包装的组件上。这样可以传递类、样式以及其他无法识别的属性。

setup(props, { attrs, slots }) {
  return () => h(Wrapped, { ...attrs }, slots);
}

转发插槽

将包装器的 slots 对象作为子节点参数传入，这样被包装的组件仍能接收到使用者提供的所有插槽内容。

return () => h(Wrapped, attrs, slots);

添加横切行为

包装器的核心目的就是注入行为。这里会在被包装组件挂载和卸载前后记录日志。

import { onMounted, onUnmounted } from "vue";

function withLogging(Wrapped) {
  return defineComponent({
    setup(props, { attrs, slots }) {
      onMounted(() => console.log("mounted"));
      onUnmounted(() => console.log("unmounted"));
      return () => h(Wrapped, attrs, slots);
    }
  });
}

使用 HOC

您可以包装任意组件，并像使用普通组件一样在模板或其他渲染函数中使用结果。

import BaseTable from "./BaseTable.vue";

const LoggedTable = withLogging(BaseTable);
// register or use LoggedTable like any component

命名包装器

设置 name，以便在 Vue DevTools 中识别包装器。组合被包装组件的名称可以让组件树更易读。

return defineComponent({
  name: "WithLogging(" + (Wrapped.name || "Anonymous") + ")",
  setup(props, ctx) { /* ... */ }
});

注入额外属性

HOC 可以向被包装组件提供额外属性，例如获取的数据集或功能开关。

function withUser(Wrapped) {
  return defineComponent({
    setup(props, { attrs, slots }) {
      const user = inject("currentUser");
      return () => h(Wrapped, { ...attrs, user }, slots);
    }
  });
}

HOC 与组合式函数

组合式函数共享逻辑，在 Vue 3 中通常更受推荐。当您必须包装无法编辑的现有组件的渲染过程，或需要通过统一边界处理错误时，HOC 更适合。

组合多个 HOC

由于每个 HOC 都会返回一个组件，因此可以通过嵌套进行组合。请最后应用最外层的 HOC。

const Enhanced = withLogging(withUser(BaseTable));

快速检查

要让 HOC 包装器保持透明，它必须向被包装组件转发什么内容？

回顾

像 withLogging(Wrapped) 这样的 HOC 会返回一个新的 defineComponent，其 setup 使用 h(Wrapped, attrs, slots) 渲染被包装组件，同时添加日志记录或注入属性等横切行为。请转发属性和插槽以保持透明；如果只需要共享逻辑，请优先使用组合式函数。

常见问题解答

「高阶组件（HOC）模式」课时是免费的吗？

是的 — 「高阶组件（HOC）模式」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Vue Academy 课程的其余内容，请升级到 CoddyKit PRO。 Vue Academy 课程共包含 4 节课。

「高阶组件（HOC）模式」这节课中我会学到什么？

使用 HOC 包装组件、透传 props 与插槽，以及了解何时使用 HOC 而非组合式函数你通过在浏览器中直接运行的动手代码来练习 Vue Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Vue Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Vue Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「高阶组件（HOC）模式」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Vue Academy 课中编写并运行代码吗？

能。每节 Vue Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Vue Academy