泛型 Vue 组件
使用泛型 defineComponent、泛型 script setup，以及带类型的插槽 props
泛型 Vue 组件 是 CoddyKit 上的免费 Vue Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Vue Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Vue Academy 课程共包含 4 节课。
泛型组件
有些组件可以处理任意数据类型，例如带类型的列表、选择框或表格。Vue 3.3 允许您编写泛型组件，这样使用方就能保留完整的类型推断，而不会退回到 any。
泛型属性
将 generic 属性添加到 <script setup> 中。它会声明可在整个脚本中使用的类型参数，原理与泛型函数完全相同。
<script setup lang="ts" generic="T">
// T can now be used below
</script>泛型 Props
在 defineProps 中使用类型参数。这里，组件可以接受任意类型 T 的数组。
<script setup lang="ts" generic="T">
defineProps<{
items: T[]
selected: T
}>()
</script>调用位置的类型推断
父组件传入 items 时，TypeScript 会根据数据推断出 T，不需要显式指定类型。传入数字后，selected 就必须是数字。
<MyList :items="[1, 2, 3]" :selected="2" />
<!-- T inferred as number -->约束类型
添加 extends 来要求特定结构。这里的 T 必须包含 id，这对带键列表很有用。
<script setup lang="ts" generic="T extends { id: number }">
defineProps<{ items: T[] }>()
</script>多个类型参数
用逗号分隔声明多个参数，就像声明泛型函数签名一样。
<script setup lang="ts" generic="T, K extends keyof T">
defineProps<{
items: T[]
field: K
}>()
</script>带类型的插槽 Props
将泛型与带类型的插槽结合使用，这样插槽内容也会获得类型。使用 defineSlots 声明插槽签名。
<script setup lang="ts" generic="T">
defineProps<{ items: T[] }>()
defineSlots<{
default(props: { item: T }): any
}>()
</script>渲染泛型插槽
在模板中，将每个项目传给插槽。父组件会接收到类型正确的插槽 props。
<template>
<ul>
<li v-for="item in items" :key="String(item)">
<slot :item="item" />
</li>
</ul>
</template>利用类型推断使用
父组件会根据传入的数组，自动在插槽作用域中获得带类型的 item。
<MyList :items="users">
<template #default="{ item }">
{{ item.name }}
</template>
</MyList>泛型 Emits
类型参数也会传入 defineEmits，因此事件负载可以携带泛型类型。
<script setup lang="ts" generic="T">
defineProps<{ items: T[] }>()
const emit = defineEmits<{
select: [item: T]
}>()
</script>何时使用泛型
当组件真正与类型无关，并且您希望类型推断贯穿组件时，请使用泛型组件，例如列表、表格和自动补全组件。对于固定的数据结构，普通的带类型组件更加简单。
快速检查
测试您对泛型组件的了解。
总结
您已经学会了泛型组件：
- 在 script setup 上使用 generic 属性声明类型参数。
- 在 defineProps 中使用这些参数处理 items: T[] 这类与类型无关的数据。
- 使用 extends 添加约束，并声明多个参数。
- 使用 defineSlots 为插槽 props 添加类型，让使用方获得完整的类型推断。
常见问题解答
「泛型 Vue 组件」课时是免费的吗？
是的 — 「泛型 Vue 组件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Vue Academy 课程的其余内容，请升级到 CoddyKit PRO。 Vue Academy 课程共包含 4 节课。
「泛型 Vue 组件」这节课中我会学到什么？
使用泛型 defineComponent、泛型 script setup，以及带类型的插槽 props 你通过在浏览器中直接运行的动手代码来练习 Vue Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Vue Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Vue Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「泛型 Vue 组件」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Vue Academy 课中编写并运行代码吗？
能。每节 Vue Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。