你可以直接使用已经准备好的模版项目快速开始,或者参考下面内容自行搭建
在开始前你可能需要 vue3 版本脚手架工具,同时需要提前安装 vue vue-router element-plus
npm i element-pro-components
# 或者
yarn add element-pro-components
# 或者
pnpm add element-pro-components
import { createApp } from 'vue'
import App from './App.vue'
import ElementPro from 'element-pro-components'
import 'element-pro-components/lib/styles/index'
const app = createApp(App)
app.use(ElementPro)
app.mount('#app')
提示
自 0.12.0
起,推荐使用按需引入样式文件夹中的 js 文件替代 css 文件,避免样式的重复引用
自 1.0.0
起,增加对 CommonJS 支持,导入 .cjs
使用
安装及使用查看 unplugin-vue-components
import { ElementProResolver } from 'element-pro-components'
Components({
resolvers: [
ElementProResolver(/* options */),
],
}),
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
importStyle | 导入组件的样式文件后缀 | 'js' | 'cjs' | 'css' | js |
exclude | 排除不需要自动导入的组件 | RegExp | - |
noStylesComponents | 没有样式的组件名称列表 | string[] | - |
安装及使用查看 vite-plugin-style-import
import styleImport from 'vite-plugin-style-import'
export default {
plugins: [
styleImport({
libs: [
{
importTest: /^Pro/,
libraryName: 'element-pro-components',
esModule: true,
ensureStyleFile: true,
resolveStyle: (name) => {
return `element-pro-components/lib/styles/${name.slice(4)}`
},
},
],
}),
],
}
例如:
import { ProLayout } from 'element-pro-components'
import 'element-pro-components/lib/styles/layout'
对于使用 VS Code 配合 typescript 开发,推荐使用插件 Volar。只需要中向 tsconfig.json
文件中增加全局组件类型
{
"compilerOptions": {
+ "types": ["element-pro-components/types/components"]
}
}
或者
{
"include": [
+ "node_modules/element-pro-components/types/components.d.ts"
]
}
也可以向全局类型定义文件中中增加,例如:env.d.ts
+ /// <reference types="element-pro-components/types/components" />
对于 webstorm 也提供了完整的组件、属性、事件补全