完全学会element-ui按需引入和纯净主题定制

时间  2021-08-15
标签 css html vue node webpack git github web vue-cli shell 栏目 CSS 繁體版
原文   原文链接

前言

手上有些项目用的element-ui，恰好有空琢磨一下怎么减少打包文件大小和打包速度方面，为了演示实验，用 vue-cli 生成初始项目，在这仅对 element-ui 主题和组件方面来优化。css

vue init webpack vuecli
复制代码

完整引入

完整地将 ui 和样式引入。html

import ElementUI from 'element-ui'
import 'element-ui/lib/theme-chalk/index.css'
复制代码

在页面简单使用 2 个组件，看看效果。vue

<el-tabs v-model="activeName" @tab-click="handleClick">
  <el-tab-pane label="用户管理" name="first">用户管理</el-tab-pane>
  <el-tab-pane label="配置管理" name="second">配置管理</el-tab-pane>
  <el-tab-pane label="角色管理" name="third">角色管理</el-tab-pane>
  <el-tab-pane label="定时任务补偿" name="fourth">定时任务补偿</el-tab-pane>
</el-tabs>

<el-steps :active="2" align-center>
  <el-step title="步骤1" description="这是一段很长很长很长的描述性文字"></el-step>
  <el-step title="步骤2" description="这是一段很长很长很长的描述性文字"></el-step>
  <el-step title="步骤3" description="这是一段很长很长很长的描述性文字"></el-step>
  <el-step title="步骤4" description="这是一段很长很长很长的描述性文字"></el-step
></el-steps>
复制代码

组件效果

再看一下打包后的资源大小状况npm run build --report。node

Hash: 40db03677fe41f7369f6
Version: webpack 3.12.0
Time: 20874ms
                                                  Asset       Size  Chunks                    Chunk Names
    static/css/app.cb8131545d15085cee647fe45f1d5561.css     234 kB       1  [emitted]         app
                 static/fonts/element-icons.732389d.ttf      56 kB          [emitted]
               static/js/vendor.a753ce0919c8d42e4488.js     824 kB       0  [emitted]  [big]  vendor
                  static/js/app.8c4c97edfce9c9069ea3.js    3.56 kB       1  [emitted]         app
             static/js/manifest.2ae2e69a05c33dfc65f8.js  857 bytes       2  [emitted]         manifest
                static/fonts/element-icons.535877f.woff    28.2 kB          [emitted]
static/css/app.cb8131545d15085cee647fe45f1d5561.css.map     332 kB          [emitted]
           static/js/vendor.a753ce0919c8d42e4488.js.map    3.26 MB       0  [emitted]         vendor
              static/js/app.8c4c97edfce9c9069ea3.js.map    16.6 kB       1  [emitted]         app
         static/js/manifest.2ae2e69a05c33dfc65f8.js.map    4.97 kB       2  [emitted]         manifest
                                             index.html  506 bytes          [emitted]
复制代码

发现打包后提取公共模块 static/js/vendor.js 有 824kbwebpack

再看一下各个模块占用状况：git

各个模块占用状况

发现 elment-ui.common.js 占用最大。全部模块资源总共有 642kb。怎么才能减少打包后的大小呢？很容易就会想到 ui 的引入和样式的引入中，实际咱们只使用了三个组件，却总体都被打包了，在这里引入这三个组件便可。github

按需引入组件样式

新建一个 element-variables.scss 文件（为何是 SCSS 文件，后面自定义主题会用到）。web

/*icon字体路径变量*/
$--font-path: "~element-ui/lib/theme-chalk/fonts";

/*按需引入用到的组件的scss文件和基础scss文件*/
@import "~element-ui/packages/theme-chalk/src/base.scss";
@import "~element-ui/packages/theme-chalk/src/rate.scss";
@import "~element-ui/packages/theme-chalk/src/button.scss";
@import "~element-ui/packages/theme-chalk/src/row.scss";
复制代码

按需引入组件

新建一个 element-config.js 文件，将项目用到的 element 组件引入。vue-cli

import { Tabs, TabPane, Steps, Step } from 'element-ui'

export default {
  install(V) {
    V.use(Tabs)
    V.use(TabPane)
    V.use(Steps)
    V.use(Step)
  }
}
复制代码

第一次优化后打包分析

将以上 element-variables.scss 和 element-config.js 引入到 main.js 中。shell

import ElementUI from '@/assets/js/element-config'
import '@/assets/css/element-variables.scss'

Vue.use(ElementUI)
复制代码

貌似上面一切都很瓜熟蒂落，打包后大小会减少。

Hash: 2ef987c23a5d612e00e1
Version: webpack 3.12.0
Time: 17430ms
                                                  Asset       Size  Chunks                    Chunk Names
    static/css/app.3c70d8d75c176393318b232a345e3f0f.css    38.8 kB       1  [emitted]         app
                 static/fonts/element-icons.732389d.ttf      56 kB          [emitted]
               static/js/vendor.caa5978bb1eb0a15b097.js     824 kB       0  [emitted]  [big]  vendor
                  static/js/app.5ebb19489355acc3167b.js    3.64 kB       1  [emitted]         app
             static/js/manifest.2ae2e69a05c33dfc65f8.js  857 bytes       2  [emitted]         manifest
                static/fonts/element-icons.535877f.woff    28.2 kB          [emitted]
static/css/app.3c70d8d75c176393318b232a345e3f0f.css.map    53.9 kB          [emitted]
           static/js/vendor.caa5978bb1eb0a15b097.js.map    3.26 MB       0  [emitted]         vendor
              static/js/app.5ebb19489355acc3167b.js.map      17 kB       1  [emitted]         app
         static/js/manifest.2ae2e69a05c33dfc65f8.js.map    4.97 kB       2  [emitted]         manifest
                                             index.html  506 bytes          [emitted]
复制代码

结果可知，static/js/vendor.js 仍是 824kb！

再看各个模块占用状况：

第一次优化后各个模块占用状况

WHAT? 居然模块都没什么变化，岂不是竹篮打水，事与愿违。

再次打包优化尝试

后来查到有人一样遇到这个问题，提出一个issues#6362，原来只引入须要的element-ui组件，webpack仍是把总体的 UI 库和样式都打包了，须要一个 webpack 的 babel 插件 babel-plugin-component，这样才能真正按需引入打包。这块其实被写到官方文档更换 自定义主题 的配置了。

因而 npm i babel-pugin-componet -D 安装后，在增长 .babelrc 文件插件配置

{
  "presets": [
    ["env", {
      "modules": false,
      "targets": {
        "browsers": ["> 1%", "last 2 versions", "not ie <= 8"]
      }
    }],
    "stage-2"
  ],
  "plugins": [
    "transform-vue-jsx",
    "transform-runtime",
    [
      "component",
      {
        "libraryName": "element-ui",
        "styleLibraryName": "theme-chalk"
      }
    ]
  ]
}
复制代码

页面运行正常，再次打包。

Hash: f182f70cb4ceee63b5d5
Version: webpack 3.12.0
Time: 10912ms
                                                  Asset       Size  Chunks             Chunk Names
    static/css/app.95c94c90ab11fdd4dfb413718f444d0c.css    39.9 kB       1  [emitted]  app
                 static/fonts/element-icons.732389d.ttf      56 kB          [emitted]
               static/js/vendor.befb0a8962f74af4b7e2.js     157 kB       0  [emitted]  vendor
                  static/js/app.5343843cc20a78e80469.js    3.86 kB       1  [emitted]  app
             static/js/manifest.2ae2e69a05c33dfc65f8.js  857 bytes       2  [emitted]  manifest
                static/fonts/element-icons.535877f.woff    28.2 kB          [emitted]
static/css/app.95c94c90ab11fdd4dfb413718f444d0c.css.map    93.5 kB          [emitted]
           static/js/vendor.befb0a8962f74af4b7e2.js.map     776 kB       0  [emitted]  vendor
              static/js/app.5343843cc20a78e80469.js.map    17.1 kB       1  [emitted]  app
         static/js/manifest.2ae2e69a05c33dfc65f8.js.map    4.97 kB       2  [emitted]  manifest
                                             index.html  506 bytes          [emitted]
复制代码

static/js/vendor.js 确实变小了，157kB。再来看各个模块分析图。

再次优化后各个模块分析图

模块总共 157.93KB，少了 5 倍！

更换主题-覆盖样式

element-ui 的 theme-chalk 使用 SCSS 编写，若是在本身的项目中也是用 SCSS，那么能够直接在项目中改变样式变量，所以能够在前面新建的 element-variables.scss 文件用新的主题颜色变量覆盖便可。

/** * 覆盖主题色 */
/*主题颜色变量*/
$--color-primary: #f0f;

/*icon字体路径变量*/
$--font-path: '~element-ui/lib/theme-chalk/fonts';

/* 引入所有默认样式 会引入没用到的组件样式 */
// @import '~element-ui/packages/theme-chalk/src/index';

/* 按需引入用到的组件的scss文件和基础scss文件 */
@import '~element-ui/packages/theme-chalk/src/base.scss';
@import '~element-ui/packages/theme-chalk/src/rate.scss';
@import '~element-ui/packages/theme-chalk/src/button.scss';
@import '~element-ui/packages/theme-chalk/src/row.scss';
复制代码

如今咱们的主题就变成了预期效果

主题改变了

可能你已经注意到了，这里推荐的是分别引入用到的组件样式，而不是引入所有默认样式，由于这样会致使引入没有使用到的组件样式。好比当前案例中咱们没有使用到 ColorPicker 组件，在打包输出的 css 文件中确有该组件样式。

打包样式文件出现没有使用的样式

更换主题-纯净样式

经过以上优化能够按需的将所用到组件打包，排除没用到的组件，减小包的大小。可是，仍是存在一个小瑕疵：一个用到的组件样式会被两次打包，一次是默认的样式，一次是覆盖的样式。

还存在默认样式

出现这个问题是因为咱们在两个地方对样式进行引入了，一个是在 .babelrc 文件中经过 babel-plugin-component 插件按需引入 element-ui 组件及其默认样式，一个是在 element-variables.scss 文件中覆盖默认样式生成的自定义样式。

因此怎样将两者结合，即babel-plugin-component 插件按需引入的组件样式改为用户自定义样式，达成纯净样式目标呢？这里就要用到 element-ui 的主题工具进行深层次的主题定制。

主题和主题工具安装

首先安装主题工具 element-theme，能够全局安装也可安装在项目目录。这里推荐安装在项目录，方便别人 clone 项目时能直接安装依赖并启动。

npm i element-theme -D
复制代码

而后安装白垩主题，能够从 npm 安装或者从 GitHub 拉取最新代码。

# 从 npm
npm i element-theme-chalk -D
 # 从 GitHub
npm i https://github.com/ElementUI/theme-chalk -D
复制代码

主题构建

element-theme 支持的构建有 Node API 和 CLI 方式。

经过 CLI 构建方式

若是全局安装能够在命令行里经过 et 调用工具，若是安装在当前目录下，须要经过 node_modules/.bin/et 访问到命令。执行 -i（--init） 初始化变量文件。默认输出到 element-variables.scss，固然你能够传参数指定文件输出目录。若是你想启用 watch 模式，实时编译主题，增长 -w（--watch） 参数；若是你在初始化时指定了自定义变量文件，则须要增长 -c（--config） 参数，并带上你的变量文件名。默认状况下编译的主题目录是放在 ./theme 下，你能够经过 -o（--out） 参数指定打包目录。

# 初始化变量文件
et --init [file path]
 # 实时编译
et --watch [--config variable file path] [--out theme path]
 # 编译
et [--config variable file path] [--out theme path] [--minimize]
复制代码

经过 Node API 构建方式

引入 element-theme 经过 Node API 形式构建

var et = require('element-theme')

// 实时编译模式
et.watch({
  config: 'variables/path',
  out: 'output/path'
})

// 编译
et.run({
  config: 'variables/path', // 配置参数文件路径 默认`./element-variables.css`
  out: 'output/path', // 输出目录 默认`./theme`
  minimize: false, // 压缩文件
  browsers: ['ie > 9', 'last 2 versions'], // 浏览器支持
  components: ['button', 'input'] // 选定组件构建自定义主题
})
复制代码

应用 Node API 构建自定义主题

在这里，为了让主题的构建更加直观和被项目共享，采用 Node API 方式构建，在项目根目录下新建 theme.js文件。

const et = require('element-theme')
// 第一步生成样式变量文件
// et.init('./src/theme.scss')
// 第二步根据实际须要修改该文件
// ...
// 第三步根据该变量文件编译出自定义的主题样式文件
et.run({
  config: './src/theme.scss',
  out: './src/theme'
})
复制代码

在 package.json 中增长 scripts 指令

{
  "scripts": {
    "theme": "node theme.js"
  }
}
复制代码

这样就能够经过 npm run theme 指令来编译主题了。编译过程：

  • 运行该指令初始化主题变量文件 theme.scss。
  • 根据实际须要修改这个文件里主题样式。
  • 再运行该指令编译输出自定义的主题样式文件放在 theme 目录下。

这样就完成了全部自定义主题样式的构建。要想将这些自定义样式随着组件按需引入，须要将 .babelrc 文件中按需引入插件 babel-plugin-component 参数 styleLibraryName 从本来的 element-ui 默认样式目录变成如今自定义目录 ~src/theme。

"plugins": [
    "transform-vue-jsx",
    "transform-runtime",
    [
      "component",
      {
        "libraryName": "element-ui",
        "styleLibraryName": "~src/theme"
      }
    ]
  ]
复制代码

一切准备就绪，项目打包，打包后的 css 文件中只有惟一自定义样式，没有了默认样式，也不存在没被引入组件的样式，实现了咱们预期的纯净的自定义样式！

不存在默认样式

Hash: c442bcf9d471bddfdccf
Version: webpack 3.12.0
Time: 10174ms
                                                  Asset       Size  Chunks             Chunk Names
    static/css/app.52d411d0c1b344066ec1f456355aa7b9.css    38.8 kB       1  [emitted]  app
                static/fonts/element-icons.535877f.woff    28.2 kB          [emitted]
               static/js/vendor.befb0a8962f74af4b7e2.js     157 kB       0  [emitted]  vendor
                  static/js/app.43c09c1f16b24d371e07.js    3.82 kB       1  [emitted]  app
             static/js/manifest.2ae2e69a05c33dfc65f8.js  857 bytes       2  [emitted]  manifest
                 static/fonts/element-icons.732389d.ttf      56 kB          [emitted]
static/css/app.52d411d0c1b344066ec1f456355aa7b9.css.map    81.3 kB          [emitted]
           static/js/vendor.befb0a8962f74af4b7e2.js.map     776 kB       0  [emitted]  vendor
              static/js/app.43c09c1f16b24d371e07.js.map    17.1 kB       1  [emitted]  app
         static/js/manifest.2ae2e69a05c33dfc65f8.js.map    4.97 kB       2  [emitted]  manifest
                                             index.html  506 bytes          [emitted]
复制代码

因为样式是纯净的，css 文件大小从原来彻底引入的 234KB 变成 38.8KB，进一步减少了打包大小。

总结

经过以上实验分析咱们能够得知，element-ui 要想实现按需引入和纯净的主题样式：

  • 首先经过 babel-plugin-component 插件进行按需引入。
  • 再用 element-theme 工具生成样变量文件。
  • 而后根据项目需求修改自定义样式，依据该文件构建生成全部样式。
  • 最后将按需引入样式 styleLibraryName 指向自定义样式目录。

若是对样式提取要求不高，可直接采起变量覆盖形式（同时存在默认样式）。 还有不清楚能够戳这里查看案例源码，赠人 star，手有余香。

完~ps：我的看法有限，欢迎指正。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程