通过定义不同的主题色CSS变量,在html标签上增加自定义属性来选择不同的主题,实现一键换肤功能。
通过监听change事件,使用document.documentElement.setAttribute动态修改data-theme属性,CSS属性选择器将自动选择对应的css变量。
除了在CSS中修改样式,有时需要在JS文件中修改样式,例如修改echarts的配置文件,来改变图形的颜色。可以通过定义主题色TS类型,规定默认和暗黑两种,定义theme响应式变量,使用watch进行监听,重新绘制echarts图形。
在特殊的日子,可以通过CSS的filter属性,使用grayscale()改变图像灰度,实现网页整体变灰色的效果。
换肤功能是一项普遍的需求,尤其是在夜晚,用户更倾向于使用暗黑模式。在我负责的公司项目中,每个项目都有换肤功能的需求。
过去,我主要使用 SCSS 变量,并利用其提供的函数,如
@each
、
map-get
来实现换肤功能。但因其使用成本高,只能适用于SCSS项目,于是后来我改用 CSS 变量来实现换肤。这样无论是基于 LESS 的 React 项目,还是基于 SCSS 的 Vue 项目,都能应用换肤功能。并且使用时只需调用
var
函数,降低了使用成本。
https://github.com/cwjbjy/vite-vue-ts-seed/tree/feature/css
CSS变量:声明自定义CSS属性,它包含的值可以在整个文档中重复使用。属性名需要以两个减号(--)开始,属性值则可以是任何有效的 CSS 值
Var函数:用
于使用CSS变量。第一个参数为CSS变量名称,第二个可选参数作为默认值
CSS属性选择器:匹配具有特定属性或属性值的元素。例如[data-theme='black'],将选择所有 data-theme 属性值为 'black' 的元素
1. 新建src/assets/theme/theme-default.css
这里定义字体颜色与布局的背景色,更多CSS变量可根据项目的需求来定义
[data-theme='default'] {
--font-primary: #fff;
--font-highlight: #434a50;
--background-header: #2f3542;
--background-aside: #545c64;
--background-main: #0678be;
}
2. 新建src/assets/theme/theme-black.css
[data-theme='black'] {
--font-primary: #fff;
--font-highlight: #434a50;
--background-header: #303030;
--background-aside: #303030;
--background-main: #393939;
}
3. 新建src/assets/theme/index.css
@import './theme-default.css';
@import './theme-black.css';
import '@/assets/styles/theme/index.css';
修改index.html,在html标签上增加自定义属性data-theme
<html lang="en" data-theme="default">html>
这里使用data-theme是为了被CSS属性选择器[data-theme='default']选
中,也可更换为其他自定义属性,只需与CSS属性选择器对应上即可。
关键点:监听change事件,使用
document.documentElement.setAttribute
动态修改data-theme属性,然后CSS属性选择器将自动选择对应的css变量
<template>
<div>
<select name="pets" @change="handleChange">
<option value="default">默认色option>
<option value="black">黑色option>
select>
<div>登录页面div>
div>
template>
<script setup lang="ts">
const handleChange = (e: Event) => {
window.document.documentElement.setAttribute('data-theme', (e.target as HTMLSelectElement).value);
};
script>
<style lang="scss">
body {
color: var(--font-primary);
background-color: var(--background-main);
}
style>
效果图,暗黑色:
切换主题色,除了需要修改css样式,有时也需在js文件中修改样式,例如修改echarts的配置文件,来改变柱状图、饼图等的颜色。
定义图像的颜色,这里定义字体的颜色,默认情况下字体为黑色,暗黑模式下,字体为白色
const themeColor = {
default: {
font: '#333',
},
black: {
font: '#fff',
},
};
export default themeColor;
1. 定义主题色TS类型,规定默认和暗黑两种:type ThemeTypes = 'default' | 'black';
2. 定义theme响应式变量,用来记录当前主题色:const theme = ref
('default');
3. 监听change事件,将选中的值赋给theme:theme.value = selectTheme;
4. 使用watch进行监听,如果theme改变,则重新绘制echarts图形
<template>
<div>
<select name="pets" @change="handleChange">
<option value="default">默认色option>
<option value="black">黑色option>
select>
<div>登录页面div>
<div ref="echartRef" class="myChart">div>
div>
template>
<script setup lang="ts">
import { onMounted, ref, watch } from 'vue';
import themeColor from '@/config/theme';
import * as echarts from 'echarts';
type ThemeTypes = 'default' | 'black';
const echartRef = refnull>(null);
const theme = ref('default');
const handleChange = (e: Event) => {
const selectTheme = (e.target as HTMLSelectElement).value as ThemeTypes;
theme.value = selectTheme;
window.document.documentElement.setAttribute('data-theme', selectTheme);
};
const drawGraph = () => {
let echartsInstance = echarts.getInstanceByDom(echartRef.value!);
if (!echartsInstance) {
echartsInstance = echarts.init(echartRef.value);
}
echartsInstance.clear();
var option = {
color: ['#3398DB'],
title: {
text: '柱状图',
left: 'center',
textStyle: {
color: themeColor[theme.value].font,
},
},
xAxis: [
{
type: 'category',
data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'],
axisLabel: {
show: true,
color: themeColor[theme.value].font,
},
nameTextStyle: {
color: themeColor[theme.value].font,
},
},
],
yAxis: [
{
type: 'value'