limingziqiang/vite-plugin-theme

Vite plugin for dynamically changing the theme color of the interface

@xlaoyu/vite-plugin-theme

原作者的 vite-plugin-theme 不再维护, 所以 fork 新仓库解决一些 vite 适配问题

English | 中文

Vite plugin for dynamically changing the theme color of the interface

After vite processes the css and dynamically analyzes the color value in the css text that matches the plug-in configuration, extract the specified color style code from all output css files. And create a app-theme-style.css file containing only color styles, dynamically insert it into the specified position (the bottom of the default body), and then replace the custom style/component library style color used with the new color, In order to achieve the purpose of dynamically changing the theme color of the project

Install (yarn or npm)

node version: >=12.0.0

vite version: >=2.0.0

yarn add @xlaoyu/vite-plugin-theme -D

or

npm i @xlaoyu/vite-plugin-theme -D

Usage

• Config plugin in vite.config.ts. In this way, the required functions can be introduced as needed

import { defineConfig, Plugin } from 'vite';
import vue from '@vitejs/plugin-vue';

import { viteThemePlugin, mixLighten, mixDarken, tinycolor } from '@xlaoyu/vite-plugin-theme';

export default defineConfig({
  plugins: [
    vue(),
    viteThemePlugin({
      // Match the color to be modified
       colorVariables: [],
    });
  ],
});

Options

viteThemePlugin(Options)

Options

param	type	default	desc
colorVariables	string[]	-	If css contains the color value in the array, css will be extracted
wrapperCssSelector	string	-	Universal outer selector. You can pass in'body' and other selectors to increase the level
resolveSelector	(selector:string)=>string	-	Custom selector conversion
customerExtractVariable	(css:string)=>string	-	Custom css matching color extraction logic
fileName	string	app-theme-style.hash.css	File name output after packaging
injectTo	body or head or body-prepend	body	The css loaded in the production environment is injected into the label body
isProd	boolean	true	默认不用设置,效果就可以切换主题, 设置为 false 则生产环境禁止切换主题

Sample project

Vben Admin

Reference project

• webpack-theme-color-replacer
• webpack-stylesheet-variable-replacer-plugin

License

MIT