Vue3 使用ArcoDesign

关于 ArcoDesign

ArcoDesign 是基于字节跳动公司内部的 Byte Design 升级而来,在打磨了近 3 年之后,通过字节内部大量业务沉淀和验证在前两天由掘金举办的《稀土开发者大会2021》上开源了,这不仅仅是一款 UI 组件库,而是一个能力全面的企业级产品设计系统。

开始使用

安装

1
npm install --save-dev @arco-design/web-vue

在main.js内引入

1
2
3
4
5
6
7
8
9
import { createApp } from 'vue'
import ArcoVue from '@arco-design/web-vue';
import App from './App.vue';
//完整引入css -不推荐
// import '@arco-design/web-vue/dist/arco.css';

const app = createApp(App);
app.use(ArcoVue); //将acro挂载到vue上
app.mount('#app')

按需加载(模板)

安装所需插件 npm install -D unplugin-vue-components unplugin-auto-import

安装完成,对 vite.config.ts 文件进行配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import AutoImport from 'unplugin-auto-import/vite'
import Components from 'unplugin-vue-components/vite';
import { ArcoResolver } from 'unplugin-vue-components/resolvers';

export default defineConfig({
plugins: [
vue(),
AutoImport({
resolvers: [ArcoResolver()],
}),
Components({
resolvers: [
ArcoResolver({
sideEffect: true
})
]
})
]
});

按需加载(样式)

安装所需插件 npm install vite-plugin-style-import –save-dev

安装完成,对 vite.config.ts 文件进行配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'


// 自动导入vue中hook reactive ref等
import AutoImport from "unplugin-auto-import/vite"
//自动导入ui-组件 比如说ant-design-vue element-plus等
import Components from 'unplugin-vue-components/vite'
import { ArcoResolver } from 'unplugin-vue-components/resolvers';
import { createStyleImportPlugin } from 'vite-plugin-style-import'

// https://vitejs.dev/config/
export default defineConfig({
plugins: [
vue(),
AutoImport({
//安装两行后你会发现在组件中不用再导入ref,reactive等
imports: ['vue', 'vue-router'],
//存放的位置
dts: "src/auto-import.d.ts",
resolvers: [ArcoResolver()],
}),
Components({
// 引入组件的,包括自定义组件
// 存放的位置
dts: "src/components.d.ts",
resolvers: [
ArcoResolver({
sideEffect: true
})
]
}),
createStyleImportPlugin({
libs: [
{
libraryName: '@arco-design/web-vue',
esModule: true,
resolveStyle: (name) => {
// css
return `@arco-design/web-vue/es/${name}/style/css.js`
// less
return `@arco-design/web-vue/es/${name}/style/index.js`
},
}
]
})
],
})

若报 Cannot find module ‘consola’ 这个错误
可在控制台输入 npm i consola -D 安装对应插件即可

完成以上步骤 就可以正常使用AcroDesign ui库了

vue3+vite+ts+router+pinia+axios 一把梭推荐文章


Vue3 使用ArcoDesign
https://blog.moxccc.com/2023/04/18/vue3-ArcoDesign/
作者
阿呆
发布于
2023年4月18日
许可协议