Vue / 系统课时

插槽与作用域插槽

插槽与作用域插槽

插槽解决的是“组件控制结构,调用方控制局部内容”的接口设计问题。本节通过一个可复用卡片组件,组合默认插槽、具名插槽和作用域插槽,并说明数据究竟属于父组件还是子组件,避免插槽接口演变成难维护的隐式依赖。

学习目标

  • 使用默认插槽和具名插槽定义可替换的内容区域
  • 通过作用域插槽把子组件数据安全暴露给调用方
  • 为插槽名称、数据类型和默认内容建立稳定接口

先确定内容由谁控制

普通 Props 适合传入结构化数据,插槽则适合传入需要由调用方决定的模板内容。子组件负责页面骨架、布局和默认行为,父组件通过插槽替换某个局部区域,而不是接管整个组件实现。

默认插槽处理组件最主要的内容区域;具名插槽适合头部、操作区等具有明确职责的位置。只有当父组件渲染插槽时还需要使用子组件内部的数据,才需要作用域插槽。

Vue 插槽内容与数据作用域关系

关键规则是:父组件提供的模板始终在父组件作用域中求值。 子组件里的局部变量不会因为 <slot> 出现就自动暴露出去;如果调用方需要这些数据,子组件必须显式把它们作为 slot props 传出。

设计默认与具名插槽

下面的 DataCard 固定卡片结构,并开放头部、主体和操作区。头部提供默认标题,主体提供默认用户名称,因此调用方即使不填写全部插槽,组件仍然可以正常呈现。

这是片段示例,依赖 Vue 3 + TypeScript 项目,并假设调用方传入符合 User 结构的数据。

vue
<!-- DataCard.vue -->
<script setup lang="ts">
interface User {
  id: number
  name: string
  role: string
}

const props = defineProps<{
  title: string
  user: User
}>()
</script>

<template>
  <section class="data-card">
    <header>
      <slot name="header" :title="props.title">
        <h2>{{ props.title }}</h2>
      </slot>
    </header>

    <main>
      <slot :user="props.user">
        <p>{{ props.user.name }}</p>
      </slot>
    </main>

    <footer>
      <slot name="actions" :user="props.user" />
    </footer>
  </section>
</template>

预期结果:未提供自定义内容时,header 使用默认标题,默认插槽显示用户名;actions 没有默认内容,因此页脚保持为空。

text
成员详情
Alice

默认内容适合“没有定制也能工作”的组件。如果某个插槽是业务必填区域,不应再放一个看似可用但语义错误的占位内容来掩盖遗漏。

消费作用域插槽数据

调用方使用 <template #名称="slotProps"> 接收具名插槽的数据;默认插槽则使用 #default。解构后的 user、title 来自子组件主动暴露的 slot props,而点击处理函数仍属于父组件。

vue
<script setup lang="ts">
import { ref } from 'vue'
import DataCard from './DataCard.vue'

const selectedId = ref<number | null>(null)
const user = {
  id: 7,
  name: 'Alice',
  role: 'Reviewer'
}

function selectUser(id: number) {
  selectedId.value = id
}
</script>

<template>
  <DataCard title="成员详情" :user="user">
    <template #header="{ title }">
      <h2>{{ title }} · {{ user.role }}</h2>
    </template>

    <template #default="{ user: cardUser }">
      <p>{{ cardUser.name }} / {{ cardUser.role }}</p>
    </template>

    <template #actions="{ user: cardUser }">
      <button @click="selectUser(cardUser.id)">
        选择 {{ cardUser.name }}
      </button>
    </template>
  </DataCard>

  <p>selected: {{ selectedId ?? 'none' }}</p>
</template>

预期结果:页面显示自定义标题、用户信息和操作按钮;点击按钮后,父组件的 selectedId 更新为 7。

text
成员详情 · Reviewer
Alice / Reviewer
选择 Alice
selected: 7

这里没有发生“子组件执行父组件模板”。更准确地说,子组件决定插槽出现的位置并提供数据,父组件决定这些数据如何被渲染以及触发什么业务行为。

用 TypeScript 固定插槽接口

企业组件库中,插槽也应该像 Props 和 Emits 一样有明确类型。使用 defineSlots 可以声明哪些插槽存在,以及每个插槽能够接收哪些数据,使调用方在模板中获得类型检查和编辑器提示。

vue
<script setup lang="ts">
interface User {
  id: number
  name: string
  role: string
}

defineSlots<{
  header(props: { title: string }): unknown
  default(props: { user: User }): unknown
  actions(props: { user: User }): unknown
}>()
</script>

预期结果:在支持 Vue TypeScript 模板检查的开发环境中,调用方能够获知 header、default、actions 的名称以及对应 slot props;错误读取不存在的字段会被类型检查发现。

text
header  -> { title: string }
default -> { user: User }
actions -> { user: User }

defineSlots 只声明编译期接口,不会替代模板中的实际 <slot> 出口。类型声明与模板出口应同步维护,否则类型看似存在,运行时却没有对应渲染位置。

控制插槽 API 的复杂度

插槽名称应该描述区域职责,例如 header、actions、empty,而不是 top1、custom2。slot props 只暴露调用方真正需要的数据和操作能力,不要直接把子组件的全部响应式状态向外泄露。

一个稳定的插槽组件应该同时回答三个问题:哪些区域允许替换、每个区域有没有合理默认内容、调用方能从该区域获得什么数据。把这三点固定下来,插槽才会成为清晰的组件接口,而不是任意注入模板的后门。

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

目录与阅读设置

阅读设置

17

记录一个想法

插槽与作用域插槽

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

登录哪都通