如何利用webpack实现一键换肤(CSS变量替换)

最近公司项目中有一个需要更换web端主题的需求,基本实现效果如下:
如何利用webpack实现一键换肤

接收到这个需求的时候有三种思路:

  • 打包的时候同时冗余打包多套CSS文件,并在切换主题的时候加载相应的样式文件。
  • 在根组件上加上主题类名,并在切换主题的时候改变类名,然后通过CSS类来覆盖已有样式。
  • 利用 antd-theme-webpack-plugin将less文件加载,并在线解析less文件后覆盖已有CSS
  • 线上解析所有样式代码,并根据新的颜色重新生成样式,并加入HTML中 下面逐个方案分析:

方案一:打包的时候同时冗余打包多套CSS文件

劣势相当明显,第一是打包速度严重拖慢,第二是切换主题的时候还需要重新从服务器上获取CSS文件,意味着切换个主题需要等上好几秒之后才能见效。优势的话,估计就是实现起来稍微简单一点了。但这个很明显不是我想要的结果。

方案二:在根组件上加上主题类名

优势在于切换成本比较低,但是劣势也比较明显:第一是打包体积严重增加(多加一套主题样式文件几乎增加一倍),第二是后续代码维护困难,需要把所有需要更换主题的样式文件全部写进所有主题类里面,工作量太大,而且是个无底洞。

方案三:利用 antd-theme-webpack-plugin

这套方案的可以根据antd里面的所有less文件中的变量进行替换,正好我们的项目又是基于Reactantd,简直完美融合。于是欣然试用,最终试用结果是:我水土不服了。做个简单的demo的时候运行很好,没问题,但是移植到已有项目的时候就出现各种不适应,首先是版本问题,这个好解决。然后又出现其他报错,一个一个解决完了之后发现实际运行起来之后还是水土不服。

另外这种模式还有另外的劣势,必须额外加载less文件,并且在线上解析所有less文件,然后应用到DOM中,对于我们这个光是样式文件打包(还是minify之后的)起来都有1M左右的项目来说简直是灾难。

方案四:线上解析所有样式代码

这种方案其实是比较讨巧的做法,将所有的linkstyle标签的样式取出来,然后替换相应的变量,再注入到DOM节点中,完成样式替换。不需要太多额外的文件引入,是一个比较好的实现思路,唯一的问题就在于前面提到的1M多的样式文件,考虑到本身项目已经比较庞大,在加上这么大的额外开销还是忍痛拒绝了。

于是主题到了:并非所有的样式代码都需要解析的,因为毕竟换肤一般来说只会更换一两个颜色,而不会更换所有的样式文件,那么何不在发布线上之前就将CSS解析好,线上的时候只需要解析这些已经处理好的样式文件即可,实际操作下来之后1M左右的样式文件只需要处理几KB的数据。在实际线上运行之后发现也确实比较流畅,也就是文章开头的GIF的效果了。

这个方案灵感来源于 webpack-theme-color-replacer,该项目通过webpack插件形式将样式文件解析后将更换主题的代码注入到每个js头部,实现思路很漂亮,只是看了代码之后有几个问题:

  • 样式加载到每个js头部,冗余!
  • 颜色匹配必须对应array中的顺序,而且不直观
  • 需要额外再代码中引入样式替换的js

综合起来觉得使用起来比较繁琐,于是自己动手撸了一个webpack插件:webpack-stylesheet-variable-replacer-plugin,只需要在webpack配置中增加一个plugin,其他的就OK了,支持key--value方式来定义需要替换的变量,还有就是注入文件可控,不会重复注入。下面介绍一下使用方法,简单三步走:

  • 引入插件
const WebpackVariableReplacer = require('webpack-stylesheet-variable-replacer-plugin');

  • 定义插件配置信息
new WebpackVariableReplacer({
     publicPath: '',
     buildPath: 'static/',
     nextSupport: true,
     specifyEntry: /_app\.js/,
     matchVariables: {
           main: '#209CEE',
         }
     }),

  • 客户端调用替换主题的方法:
 window.replaceStyleVariable && window.replaceStyleVariable({main: color});

运行效果还是看文章开头的GIF,总结来说,效率高,代码侵入性低,方便使用。理论上来说,在angular和vue中使用也没有任何问题。不过本人主要技术栈还是react,其他没有测试。 下面解释一下使用参数:

参数 默认值 详细说明
fileName webpack-variable-replacer-[hash].js
publicPath '' 资源访问路径
htmlFileName '' 需要注入的HTML文件名
buildPath ‘’ 文件打包后存放的位置前缀
nextSupport false 是否需要支持next.js,如果后端服务用next.js搭建,此参数需传true
injectToEntry false 是否需要将生成后的代码注入到打包的js中,如果穿了htmlFileName,此参数可传false,否则必须为true
excludeEntry null 需要排除的entry文件名,支持传入正则或者正则字符串
specifyEntry null 需要指定的entry文件名,支持传入正则或者正则字符串,不传默认所有
matchVariables {} 需要匹配的字符串,通过key-value模式传入,例如:{main:'#123456'}

我的主页:eaTong个人站

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,670评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,928评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,926评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,238评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,112评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,138评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,545评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,232评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,496评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,596评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,369评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,226评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,600评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,906评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,185评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,516评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,721评论 2 335

推荐阅读更多精彩内容

  • 在现在的前端开发中,前后端分离、模块化开发、版本控制、文件合并与压缩、mock数据等等一些原本后端的思想开始...
    Charlot阅读 5,415评论 1 32
  • 1. 新建一个文件夹,命名为 webpack-cli , webpack-cli 就是你的项目名,项目名建议使用小...
    鲁大师666阅读 1,443评论 1 3
  • 前提: 安装webpack、webpack-cli 一、首先先让出来一个页面有内容 先添加.gitignore,将...
    codingQi阅读 1,445评论 0 0
  • 本项目基于 入门 Webpack,看这篇就够了创建。本例程通过从头构建一个基于npm管理的前端项目,一步步的让读者...
    尤利西斯U阅读 2,609评论 0 8
  • 星空百亿年,不过幻起灭; 庸人多争讻,高人只观天。 时来茶花园,花色一时明; 命数与人心,交互成一体。
    道听俗说阅读 355评论 0 2