# 更换主题
本项目基于 element-ui 默认视觉风格搭建了。如果对视觉风格有额外的要求可以按照官方自定义主题指导。该方案是通过样式变量覆盖的方式。
# 样式覆盖
element-ui 的通用样式变量可能无法满足所有定制需求,你可以通过覆盖默认的组件样式的方式实现。
由于 element-ui 的样式我们是在全局引入的,所以你想在某个view
里面覆盖它的样式就不能加 scoped,但你又想只覆盖这个页面的 element 样式,你就可在它的父级加一个 class,以用命名空间来解决问题。或者使用深度作用选择器。
/* 你的命名空间 */
.article-page {
/* element-ui 元素 */
.el-tag {
margin-right: 0px;
}
}
一些全局的 element-ui 样式修改可以在 @/styles/element-ui.scss 中进行设置。
# 动态换肤
本项目提供了两种动态换肤的功能,各有利弊,请结合个人需求自行选择。
# element-ui 官方文档页面 换肤方式
element-ui 升级为 2.0 之后官方文档的右上角提供了动态换肤的功能,本项目也提供了该功能。 代码地址:@/components/ThemePicker。
简单说明一下它的原理:
element-ui 2.0 版本之后所有的样式都是基于 SCSS 编写的,所有的颜色都是基于几个基础颜色变量来设置的,所以就不难实现动态换肤了,只要找到那几个颜色变量修改它就可以了。
首先我们需要拿到通过 package.json
拿到 element-ui 的版本号,根据该版本号去请求相应的样式。拿到样式之后将样色,通过正则匹配和替换,将颜色变量替换成你需要的,之后动态添加 style
标签来覆盖原有的 css 样式。
TIP
这里需要获取 element-ui 的版本号,从而锁定版本,以免将来 Element 升级时受到非兼容性更新的影响。
const version = require('element-ui/package.json').version
const url = `https://unpkg.com/element-ui@${version}/lib/theme-chalk/index.css`
this.getCSSString(url, chalkHandler, 'chalk')
getCSSString(url, callback, variable) {
const xhr = new XMLHttpRequest()
xhr.onreadystatechange = () => {
if (xhr.readyState === 4 && xhr.status === 200) {
this[variable] = xhr.responseText.replace(/@font-face{[^}]+}/, '')
callback()
}
}
xhr.open('GET', url)
xhr.send()
}
使用方式
在项目中引入 ThemePicker 组件即可
import ThemePicker from '@/components/ThemePicker'
- 优点
- 无需准备多套主题,可以自由动态换肤
- 缺点
- 自定义不够,只支持基础颜色的切换
# 多套主题换肤
本方法就是最常见的换肤方式,本地存放多套主题,两者有不同的命名空间,如写两套主题,一套叫 day-theme
,一套叫 night-theme
,night-theme
主题都在一个 .night-theme
的命名空间下,我们动态的在 body 上 add .night-theme
; remove .night-theme
。
# 使用
我们这里基于官方的主题生成库 element-theme 进行了相应的改造。
首先我们下载 custom-element-theme 项目
git@github.com:PanJiaChen/custom-element-theme.git
之后全局安装主题生成工具
npm i element-theme -g
进入项目目录 安装相关依赖
npm install
首先执行 et -i
生成 element-variables.scss
存放样式变量的文件,然后进入 element-variables.scss
文件 修改你自己需要的变量,修改完成之后执行 et
, 编译主题,最后执行gulp
生成命名空间。所有生成文件在 dist
目录下,你只需复制文件下所有内容到 adempiere-vue
项目中 src/assets/custom-theme
进行覆盖替换就行
TIP
如果需要修改打包生成样式命名空间的名字 只要修改该变量即可