指南
这套文档面向已经在 Vue 3 项目中使用 ant-design-vue 或 element-plus 的开发者。重点不是介绍仓库如何开发,而是帮助你判断是否值得替换现有表格、如何接入现有项目,以及在高频场景里怎样使用 vtable-guild。
建议阅读顺序
如果你正在评估是否替换
- 先看 为什么选择 vtable-guild,确认它解决的是哪一类表格问题。
- 再看 功能对比总览,快速判断和现有表格方案的差异。
- 如果你关心增强点,再看 增强与独有能力。
如果你已经准备接入
- 从 快速开始 完成安装、样式引入和插件初始化。
- 如果你已有 ant-design-vue Table,继续看 从 ant-design-vue 迁移。
- 继续看 安装与使用,确认样式入口、主题预设和常见接入方式。
如果你正在实现具体功能
如果你要统一视觉体系
- 先看 三层主题覆盖,建立
themePreset、全局theme、实例级ui的分工。 - 再看 Table CSS 变量参考,确认哪些场景只需要改 token。
- 然后看 ui Slot 参考,查完整 slot 和 variant 清单。
- 最后看 预设与语言,处理 preset 切换与 locale。
如果你要理解设计取舍
- 想理解为什么主题要分层、为什么接入方式保持单一: 看 为什么这样设计
- 想快速查字段名、事件、slot 和常用类型: 看 API Reference 和 类型参考