从实际项目深入理解ElementPlus的导入方式

简介: ElementPlus官网中介绍了三种导入方式,分别是完整导入、按需自动导入、(按需)手动导入。但在实际项目中还会有全局导入部分组件以及全局导入和按需导入组合的方式。本文通过github上几个高star数的项目来展示几种导入ElementPlus的方式,并对关键知识加以解释从而加深对这些导入方式的理解。

1.完整导入
本部分内容参考了element-plus官网和vue3.0-ts-admin项目。
正如官方文档所言,如果你对打包后的文件大小不是很在乎,那么使用完整的导入比较方便。
注意:完整导入后,使用的时候直接用
1.1 导入
main.ts文件
import { createApp } from 'vue'
import ElementPlus from "element-plus";
import "element-plus/lib/theme-chalk/index.css";
import App from './App.vue'

const app = createApp(App)

app.use(ElementPlus)
app.mount('#app')
复制代码
1.2 使用
如下代码中用到了el-menu,直接使用即可:


复制代码
2.按需自动导入
按需自动导入是推荐的导入方式。本节内容参考了vue3-music项目,您可以clone代码进行详细学习。
注意:如果采用自动按需导入的方式,则在使用组件的时候直接使用,不需要任何显示的导入语句。我们看一下按需导入的几个关键环节:
2.1 安装插件
m install -D unplugin-vue-components unplugin-auto-import
复制代码
2.2 vite配置文件
// vite.config.ts
import { defineConfig } from 'vite'
import AutoImport from 'unplugin-auto-import/vite'
import Components from 'unplugin-vue-components/vite'
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'

export default defineConfig({
// ...
plugins: [

// ...
AutoImport({
  resolvers: [ElementPlusResolver()],
}),
Components({
  resolvers: [ElementPlusResolver()],
}),

],
})
复制代码
unplugin-vue-components/vite是负责组件自动导入的,你可以在不导入和注册组件的情况下在模板中使用想要用到的组件。
unplugin-vue-components内置了流行UI组件库的resolvers(例如element-plus的),我们可以看一下unplugin-vue-components中element-plus的resolver部分源码:
// https://github.com/antfu/unplugin-vue-components/blob/main/src/core/resolvers/element-plus.ts
// resolveComponent方法中有一段代码:
return {
from: element-plus/lib/el-${partialName},
sideEffects: getSideEffectsLegacy(partialName, options),
}
// getSideEffectsLegacy:
function getSideEffects(dirName: string, options: ElementPlusResolverOptionsResolved): SideEffectsInfo | undefined {
const { importStyle, ssr } = options
const themeFolder = 'element-plus/theme-chalk'
const esComponentsFolder = 'element-plus/es/components'

if (importStyle === 'sass')

return ssr ? `${themeFolder}/src/${dirName}.scss` : `${esComponentsFolder}/${dirName}/style/index`

else if (importStyle === true || importStyle === 'css')

return ssr ? `${themeFolder}/el-${dirName}.css` : `${esComponentsFolder}/${dirName}/style/css`

}
复制代码
看到这些代码也大概知道其作用了:引入组件和样式。
unplugin-auto-import/vite是用于自动导入API的。例如下面这段代码,可以在不引入ref的情况下使用ref
const count = ref(0)
const doubled = computed(() => count.value * 2)
复制代码
2.3 使用
下面代码中使用了ElScrollbar,既没有引入组件也没有引入样式:

    </ElScrollbar>
  </div>
</div>  
<PlayList/>  




相关文章
|
10月前
|
前端开发
从0搭建Vue3组件库(七):使用 gulp 打包组件库并实现按需加载
从0搭建Vue3组件库(七):使用 gulp 打包组件库并实现按需加载
238 0
|
3天前
|
JavaScript
Vue 如何新建一个项目(如何安装依赖)
Vue 如何新建一个项目(如何安装依赖)
10 0
|
7天前
|
JavaScript 前端开发
若依 自定义实现导入功能
若依 自定义实现导入功能
9 1
|
3月前
|
JavaScript
用命令窗口的方式创建Vue项目
用命令窗口的方式创建Vue项目
20 0
|
4月前
elementPlus引入
elementPlus引入
27 1
|
4月前
|
JavaScript
Vue项目常见的文档导入调接口
Vue项目常见的文档导入调接口
|
6月前
|
JavaScript
vue3新建的项目如何配置
vue3新建的项目如何配置
30 0
|
8月前
|
JavaScript
如何使用vue3导出excel表格
如何使用vue3导出excel表格
213 0
|
8月前
|
JSON 小程序 前端开发
小程序引入第三方插件Vant和小程序WeUl组件库
现如今前端的技术再向框架化的发展,框架的使用提高我们的编码的效率和性能的优化,同样CSS样式也是越来越高的要求,今天我要向大家介绍的就是较火的前端UI框架Vant UI组件库
199 0
|
8月前
|
JavaScript
npm 上传发布自定义组件以及使用详细流程(Vue包含)(下)
npm 上传发布自定义组件以及使用详细流程(Vue包含)(下)
101 0