ElementPlus的自定義主題
https://element-plus.org/zh-CN/ ElementPlus官方文件有很多詳細的配置內容 有興趣可以深入了解
基於WEB有時候全局需要特定風格的主題色
這時候就可以用上自定義主題啦~~
安裝ElementPlus
# 选择一个你喜欢的包管理器
# NPM
$ npm install element-plus --save
# Yarn
$ yarn add element-plus
# pnpm
$ pnpm install element-plus
完整引入
// main.ts
import { createApp } from 'vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import App from './App.vue'
const app = createApp(App)
app.use(ElementPlus)
app.mount('#app')
Volar 支持
如果您使用 Volar,请在 tsconfig.json 中通过 compilerOptions.type 指定全局组件类型
// tsconfig.json
{
"compilerOptions": {
// ...
"types": ["element-plus/global"]
}
}
按需导入
ElementPlus #官方推薦自动导入#
首先你需要安装unplugin-vue-components 和 unplugin-auto-import这两款插件
npm install -D unplugin-vue-components unplugin-auto-import
然後把下列程式碼插入你的Vite或Webpack的設定檔中
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()],
}),
],
})
Webpack# 和 Nuxt# 用戶這邊不再贅述, 可以參考ElementPlus官方文件
以上ElementPlus的 完整引入 和 按需導入 的安裝就完成了
以下開始進入
自定義主題
更換主題色#
新建一个样式文件,例如 styles/element/index.scss:
// styles/element/index.scss
/* 只需要重写你需要的即可 */
@forward 'element-plus/theme-chalk/src/common/var.scss' with (
$colors: (
'primary': (
'base': green,
),
),
);
// 如果只是按需导入,则可以忽略以下内容。
// 如果你想导入所有样式:
// @use "element-plus/theme-chalk/src/index.scss" as *; // 全局導入解開這行註釋
全局導入 與 按需導入 的樣式文件覆蓋是一樣的
注意: 全局導入 => 最後一行註釋要解開
全局導入
main.js 註釋原來全局導入的樣式
導入自己新建的樣式 styles/element/index.scss'
```
// main.js
import { createApp } from 'vue'
import ElementPlus from 'element-plus'
// import 'element-plus/dist/index.css' // 原樣式註釋
import './styles/element/index.scss' // 引入自己新建的樣式
import App from './App.vue'
const app = createApp(App)
app.use(ElementPlus)
app.mount('#app')
全局導入完成#
按需導入
修改vite.confing.js配置
// vite.confing.js
import AutoImport from 'unplugin-auto-import/vite'
import Components from 'unplugin-vue-components/vite'
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
plugins: [
vue(),
AutoImport({
resolvers: [ElementPlusResolver()]
}),
Components({
resolvers: [ElementPlusResolver({ importStyle: 'sass' })]
// 配置組件導入,使用sass覆蓋
})
],
resolve: {..省略..},
css: {
preprocessorOptions: {
scss: {
// 導入並解析你的scss文件
additionalData: `
@use "@/styles/element/index.scss" as *;
`
}
}
}
})
以上配置完成就可以看見自己的自定義主題顏色了(灑花)