Skip to content

Latest commit

 

History

History
85 lines (69 loc) · 2.9 KB

custom-theme.md

File metadata and controls

85 lines (69 loc) · 2.9 KB
Raw

自定义主题

Element 默认提供一套主题，CSS 命名采用 BEM 的风格方便使用者覆盖样式。如果你想完全替换主题色或者部分样式，可以使用下面方法。

安装工具

首先安装「主题生成工具」，可以全局安装或者安装在当前项目下，推荐安装在项目里，方便别人 clone 项目时能直接安装依赖并启动。

npm i element-theme -D

安装默认主题，可以从 npm 安装或者从 GitHub 拉取最新代码。

npm i element-theme-default -D

# 从 GitHub
npm i https://github.com/ElementUI/theme-default -D

初始化变量文件

主题生成工具安装成功后，如果全局安装可以在命令行里通过 et 调用工具，如果安装在当前目录下，需要通过 node_modules/.bin/et 访问到命令。执行 -i 初始化变量文件。默认输出到 element-variables.css，当然你可以传参数指定文件输出目录。

node_modules/.bin/et -i [可以自定义变量文件目录]

> ✔ Generator variables file

如果使用默认配置，执行后当前目录会有一个 element-variables.css 文件。内部包含了主题所用到了所有变量，它们使用 CSS4 的风格定义。大致结构如下：

:root {

  /* Colors
  -------------------------- */
  --color-primary: #20a0ff;
  --color-success: #13ce66;
  --color-warning: #f7ba2a;
  --color-danger: #ff4949;
  --color-info: #50BFFF;
  --color-blue: #2e90fe;
  --color-blue-light: #5da9ff;
  --color-blue-lighter: rgba(var(--color-blue), 0.12);
  --color-white: #fff;
  --color-black: #000;
  --color-grey: #C0CCDA;

修改变量

直接编辑 element-variables.css 文件，例如修改主题色为红色。

--color-primary: red;

编译主题

保存文件后，到命令行里执行 et 编译主题，如果你想启用 watch 模式，实时编译主题，增加 -w 参数。

node_modules/.bin/et

> ✔ build theme font
> ✔ build element theme

引入自定义主题

默认情况下编译的主题目录是放在 ./theme 下，你可以通过 -o 参数指定打包目录。像引入默认主题一样，在代码里直接引用 theme/index.css 文件即可。

import './theme/index.css'
import ElementUI from 'element-ui'
import Vue from 'vue'

Vue.use(ElementUI)

搭配插件按需引入组件主题

如果是搭配 babel-plugin-component 一起使用，只需要修改 .babelrc 的配置，指定 styleLibraryName 路径为自定义主题相对于 .babelrc 的路径，注意要加 ~。

{
  "plugins": [["component", [
    {
      "libraryName": "element-ui",
      "styleLibraryName": "~theme"
    }
  ]]]
}

如果不清楚 babel-plugin-component 是什么，请阅读 快速上手 一节。更多 element-theme 用法请参考项目仓库。