ant-design-vue 组件 — 学习参考指南

一份面向 所有 ant-design-vue v4（Vue 3）组件 的学习与速查手册。针对每个组件，您将获得：用途说明 · 可用变体 · 可直接运行的 Vue 3 单文件组件（SFC）示例 · 核心 Props/事件/插槽 · 实用提示。

阅读前须知

• 本指南面向 ant-design-vue v4.2.x（基于 Vue 3）。全局注册的组件使用 a- 前缀（例如 、）。它 不是 React 版本的 antd —— 其 Props、事件与插槽均不相同（详见「约定」章节）。
• 请首先阅读 references/conventions.md —— 该文件汇总了 所有 组件共用的设计模式（组件注册方式、图标使用、v-model:* 语法、事件命名规范、插槽类型、表单集成、主题配置、message/Modal/notification 等全局 API、以及如何运行任意示例）。掌握这些通用约定后，下方所有组件的文档都将清晰易懂。

如何帮助他人学习某个组件

当被问及“如何使用 ？”（或询问其变体、示例、代码等）时，请按以下步骤操作：

1. 定位组件：在下方索引中找到对应条目，并打开 references/ 目录下的分类文档文件。
2. 讲解顺序如下：一句话说明 用途 → 变体（即该组件提供的不同形态，如尺寸、类型、模式、形状、状态等）→ 一个 最小可运行的 Vue 3 SFC 示例 → 核心 API（关键 Props / 事件 / 插槽）→ 实用提示 及与同类组件（sibling）的选用建议。
3. 匹配学习者水平：面向初学者时，优先展示最小示例；再逐步引入变体与边界情况。若用户正从 React 迁移而来，请引导其查阅 conventions.md 中的 React→Vue 映射说明。
4. 始终采用 Vue 3 编程范式：使用 v-model:value / v-model:checked / v-model:open 等语义化绑定；事件统一使用 @change 等 Composition API 风格写法；并仅使用 具名插槽（named slots）与作用域插槽（scoped slots）（切勿使用 React 风格的 render props 或 onChange 回调）。
5. 运行示例：提供 conventions.md 中的 Vite 快速启动指引，或主动协助搭建本地 Playground 环境。

组件索引

单个组件的文档结构

每个分类文档中的组件均遵循统一模板，确保学习路径一致、高效：

### 名称  ``
用途：     一句话概括。
变体：     具有实际意义的不同形式（尺寸 / 类型 / 模式 / 形状 / 状态等）。
示例：     一个完整的、含