Vue / 系统课时
插槽与作用域插槽
插槽与作用域插槽
插槽解决的是“组件控制结构,调用方控制局部内容”的接口设计问题。本节通过一个可复用卡片组件,组合默认插槽、具名插槽和作用域插槽,并说明数据究竟属于父组件还是子组件,避免插槽接口演变成难维护的隐式依赖。
学习目标
- 使用默认插槽和具名插槽定义可替换的内容区域
- 通过作用域插槽把子组件数据安全暴露给调用方
- 为插槽名称、数据类型和默认内容建立稳定接口
先确定内容由谁控制
普通 Props 适合传入结构化数据,插槽则适合传入需要由调用方决定的模板内容。子组件负责页面骨架、布局和默认行为,父组件通过插槽替换某个局部区域,而不是接管整个组件实现。
默认插槽处理组件最主要的内容区域;具名插槽适合头部、操作区等具有明确职责的位置。只有当父组件渲染插槽时还需要使用子组件内部的数据,才需要作用域插槽。

关键规则是:父组件提供的模板始终在父组件作用域中求值。 子组件里的局部变量不会因为 <slot> 出现就自动暴露出去;如果调用方需要这些数据,子组件必须显式把它们作为 slot props 传出。
设计默认与具名插槽
下面的 DataCard 固定卡片结构,并开放头部、主体和操作区。头部提供默认标题,主体提供默认用户名称,因此调用方即使不填写全部插槽,组件仍然可以正常呈现。
这是片段示例,依赖 Vue 3 + TypeScript 项目,并假设调用方传入符合 User 结构的数据。
<!-- 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 没有默认内容,因此页脚保持为空。
成员详情
Alice默认内容适合“没有定制也能工作”的组件。如果某个插槽是业务必填区域,不应再放一个看似可用但语义错误的占位内容来掩盖遗漏。
消费作用域插槽数据
调用方使用 <template #名称="slotProps"> 接收具名插槽的数据;默认插槽则使用 #default。解构后的 user、title 来自子组件主动暴露的 slot props,而点击处理函数仍属于父组件。
<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。
成员详情 · Reviewer
Alice / Reviewer
选择 Alice
selected: 7这里没有发生“子组件执行父组件模板”。更准确地说,子组件决定插槽出现的位置并提供数据,父组件决定这些数据如何被渲染以及触发什么业务行为。
用 TypeScript 固定插槽接口
企业组件库中,插槽也应该像 Props 和 Emits 一样有明确类型。使用 defineSlots 可以声明哪些插槽存在,以及每个插槽能够接收哪些数据,使调用方在模板中获得类型检查和编辑器提示。
<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;错误读取不存在的字段会被类型检查发现。
header -> { title: string }
default -> { user: User }
actions -> { user: User }defineSlots 只声明编译期接口,不会替代模板中的实际 <slot> 出口。类型声明与模板出口应同步维护,否则类型看似存在,运行时却没有对应渲染位置。
控制插槽 API 的复杂度
插槽名称应该描述区域职责,例如 header、actions、empty,而不是 top1、custom2。slot props 只暴露调用方真正需要的数据和操作能力,不要直接把子组件的全部响应式状态向外泄露。
一个稳定的插槽组件应该同时回答三个问题:哪些区域允许替换、每个区域有没有合理默认内容、调用方能从该区域获得什么数据。把这三点固定下来,插槽才会成为清晰的组件接口,而不是任意注入模板的后门。