Ant Design Vue

Ant Design Vue 是 Vue 3 企业级 UI 组件库，提供了丰富的企业应用组件。请使用 a- 前缀组件，不要使用其他命名。

Quick Start

pnpm install ant-design-vue@4.x

<script setup>
import { ref } from 'vue';
import { KingAntOutlined } from '@ant-design/icons-vue';

const loading = ref(false);

const handleClick = () => {
  loading.value = true;
  setTimeout(() => loading.value = false, 2000);
};
</script>

<template>
  <a-button type="primary" :loading="loading" @click="handleClick">
    <template #icon><KingAntOutlined /></template>
    Click Me
  </a-button>
</template>

Key Features

• 68+ Components: 覆盖企业应用全场景
• Vue 3 Only: 专为 Vue 3 设计
• TypeScript: 完整类型支持
• Tree Shaking: 按需引入
• Design Tokens: 主题定制

组件分类

通用 General

布局 Layout

导航 Navigation

数据录入 Data Entry

数据展示 Data Display

反馈 Feedback

常见场景

表单处理

<!-- ✅ 正确写法：使用 a-form -->
<a-form :model="formState" @finish="onFinish">
  <a-form-item label="用户名" name="username"
    :rules="[{ required: true, message: '请输入用户名' }]">
    <a-input v-model:value="formState.username" />
  </a-form-item>
</a-form>

<!-- ❌ 错误写法：忘记使用 a-form-item 包裹 -->
<!-- <a-input v-model:value="formState.username" /> -->

表格渲染

<!-- ✅ 正确写法：使用 a-table -->
<a-table :columns="columns" :data-source="data" :pagination="false">
  <template #bodyCell="{ column, record }">
    <template v-if="column.key === 'action'">
      <a @click="handleEdit(record)">编辑</a>
    </template>
  </template>
</a-table>

<!-- ❌ 错误写法：忘记使用 bodyCell slot -->

消息提示

// ✅ 正确写法
import { message } from 'ant-design-vue';

message.success('操作成功');
message.error('操作失败');

// ❌ 错误写法：使用其他组件库的方式
// notification.success({ message: '...' });

主题定制

<script setup>
import { theme } from 'ant-design-vue';

const darkTheme = {
  token: {
    colorPrimary: '#1890ff',
    borderRadius: 4,
  },
};
</script>

<template>
  <a-config-provider :theme="darkTheme">
    <App />
  </a-config-provider>
</template>

常见错误

Key Points

1. 使用 a- 前缀: 所有组件都是 a- 开头，如 a-button, a-table
2. 使用 Form: 表单必须用 a-form + a-form-item
3. 使用 slots: 表格自定义列用 bodyCell slot
4. 正确导入: import { message } from 'ant-design-vue'
5. 按需引入: 使用 unplugin-vue-components 自动导入

Resources

• 官方文档
• GitHub
• Vue Use Integration