# Theme

This project is based on the element-ui default visual style. If you have additional requirements for visual style, you can follow the official custom theme guide. The method is implemented by covering style variables.

# Style override

The generic style variables for element-ui may not satisfy all custom requirements, and you can do this by overriding the default component style.Since the element-ui style is introduced globally, you can't add scoped if you want to override its style in a view, but if you want to override only the element style of the page, you can use it. Add a class to the parent to use the namespace to solve the problem.

Or use Deep Selectors

/* Your namespace */
.article-page {
  /* element-ui tag */
  .el-tag {
    margin-right: 0px;
  }
}

Some global element-ui style modifications can be set in @/styles/element-ui.scss.


# Dynamic theme

This project provides two kinds of dynamic skinning functions, each has its own advantages and disadvantages. Please choose according to your own needs.

# Element-ui official method

After the element-ui is upgraded to 2.0, the dynamic peel function is provided in the upper right corner of the official document. This project also provides a change function.

Code: @/components/ThemePicker

Briefly explain its principle: All styles after element-ui version 2.0 are based on SCSS, all colors are set based on a few basic color variables, so it is not difficult to achieve dynamic skinning, as long as find a few color variables to modify it. First, we need to get the version number of element-ui through package.json and request the corresponding style according to the version number. After you get the style, you will change the color, replace it with the color variable you want, and then dynamically add the style tag to override the original CSS style.

TIP

It is necessary to obtain the version of element-ui to lock the version so as to avoid the impact of non-compatible updates when the Element is upgraded in the future.

const version = require('element-ui/package.json').version

const url = `https://unpkg.com/element-ui@${version}/lib/theme-chalk/index.css`
this.getCSSString(url, chalkHandler, 'chalk')

getCSSString(url, callback, variable) {
  const xhr = new XMLHttpRequest()
  xhr.onreadystatechange = () => {
    if (xhr.readyState === 4 && xhr.status === 200) {
      this[variable] = xhr.responseText.replace(/@font-face{[^}]+}/, '')
      callback()
    }
  }
  xhr.open('GET', url)
  xhr.send()
}

How to use

Import the ThemePicker component to your project

import ThemePicker from '@/components/ThemePicker'
  • Advantage
    • No need to prepare multiple sets of themes, free dynamic theme
  • Shortcomings
    • Not enough customization, only support switching of basic colors


# Multiple sets of theme

This method is the most common way of theme, storing multiple sets of themes locally, both with different namespaces, such as writing two sets of themes, a set called day-theme, a set called night-theme, and night-theme. Themes are all under a .night-theme namespace, and we dynamically add .night-theme on body; remove .night-theme.

# How to use

We have made corresponding changes here based on the official theme generation library element-theme.

First download custom-element-theme

git@github.com:PanJiaChen/custom-element-theme.git

Globally installed theme generation tool

npm i element-theme -g

Enter the project directory Install dependencies

npm install

First execute et -i to generate element-variables.scss file that stores style variables, then enter element-variables.scss file to modify your own variables, execute et after modification, compile subject, and finally Execute gulp to generate a namespace. All generated files are in the dist directory. You just copy all the contents of the file to src/assets/custom-theme in the adempiere-vue project.

TIP

If you need to modify the name of the package generation style namespace, just modify the variable.