SuperAPI AI 工具集

arco-design-vue

前端与建站

查看项目

更新于 10-16 15:11

技能介绍

Arco Design Vue Skill 是围绕 @arco-design/web-vue(Arco Design 的 Vue 3 组件库)整理的参考型技能,目标是帮助开发者按 Vue 3 的写法正确使用 Arco 组件来构建页面与界面。

关键约定

编写 Arco Design Vue 代码时需遵守下列规则:

  • 使用 Vue 3,新代码优先使用 <script setup lang="ts"> 与 Composition API。
  • 完整引入方式:
import { createApp } from 'vue'
import ArcoVue from '@arco-design/web-vue'
import '@arco-design/web-vue/dist/arco.css'
import App from './App.vue'

const app = createApp(App)
app.use(ArcoVue)
app.mount('#app')
  • 组件与服务从根包导入:import { Button, Table, Form, Message } from '@arco-design/web-vue'。
  • 图标从图标入口导入:import { IconSearch, IconPlus } from '@arco-design/web-vue/es/icon'。
  • 样式完整引入使用 @arco-design/web-vue/dist/arco.css;手动按需引入时使用组件样式,例如 @arco-design/web-vue/es/button/style/css.js。
  • 默认全局组件标签使用 a- 前缀:<a-button>、<a-table>、<a-form>、<a-form-item>。
  • 模板中的属性使用 kebab-case:html-type、show-jumper、row-selection。
  • 事件使用 Vue 语法:@click、@change、@page-change、@submit-success。
  • 双向绑定使用 v-model 或命名形式:v-model:visible、v-model:selected-keys、v-model:current。
  • 插槽使用 #slot-name;作用域插槽参数以组件文档为准。
  • 表单使用 :model、field 和校验规则;子输入控件使用 v-model。
  • 日期时间组件内部使用 dayjs,不要引入 Moment.js。
  • 优先使用本技能中的 Vue 示例;不要套用 React 专属 API,例如 Form.useForm、JSX children 或 Component.Sub。

主要能力与参考范围

技能内含一份索引,需要完整属性、事件、插槽、示例与使用要点时加载对应参考文件。

安装与配置

  • 安装:安装 @arco-design/web-vue、注册 ArcoVue、引入样式、配置按需加载。
  • 全局配置:使用 app.use(ArcoVue, options) 或 <a-config-provider> 配置语言、前缀、尺寸等。
  • 主题:Less 变量、主题包、暗黑模式、CSS/样式引入。
  • 国际化:语言包与 <a-config-provider :locale="...">。
  • 架构约定:Vue 3 SFC 结构、导入、v-model、属性、事件、插槽、组件注册。

组件覆盖

通用:Button、ConfigProvider、Icon、Link、Typography。

布局:Divider、Grid(24 栅格、响应式行列)、Layout(页面骨架、页头、侧边栏、内容区、页脚)、Space。

导航:Breadcrumb、Dropdown、Menu、PageHeader、Pagination、Steps。

数据录入:AutoComplete、Cascader、Checkbox、ColorPicker、DatePicker、Form、Input、InputNumber、InputTag、Mention、Radio、Rate、Select、Slider、Switch、Textarea、TimePicker、Transfer、TreeSelect、Upload、VerificationCode。

数据展示:Avatar、Badge、Calendar、Card、Carousel、Collapse、Comment、Descriptions、Empty、Image、List、OverflowList、Popover、Statistic、Table、Tabs、Tag、Timeline、Tooltip、Tree。

反馈:Alert、Drawer、Message、Modal、Notification、Popconfirm、Progress、Result、Skeleton、Spin。

其他:Affix、Anchor、BackTop、ResizeBox、Scrollbar、Split、Trigger、Watermark。

模式

  • 表单模式:复杂表单、校验、动态字段、表单提交。
  • 表格模式:远程表格、插槽、行选择、分页。
  • 弹窗模式:弹窗表单、确认、全局反馈。
  • 受控值:v-model、default-*、受控/非受控状态。
  • 响应式设计:栅格断点、响应式表单、自适应仪表盘。

使用方式

在编写 Vue 3 + Arco Design Vue 代码时,按上述约定使用组件与服务;遇到需要完整属性、事件、插槽或示例时,查阅技能内对应的参考文件。

适用场景

适合需要构建 Vue 页面、创建 Vue UI、使用 Arco Vue 编写前端代码、开发 Vue 仪表盘或应用的场景,以及在使用 Arco Design Vue 各组件时查询用法与约定。

限制

该技能面向 Vue 3 与 @arco-design/web-vue,不适用于 React 专属 API 写法;日期时间组件内部使用 dayjs,不应引入 Moment.js。其余关于收费、价格、平台等信息暂未提供。