Custom Theme

Intro

Vant provides a set of default themes, if you want to custom the theme color or other styles, you can use the following methods:

Less variables

Vant use Less as css preprocessor，you can modify less variables to custom theme.

There are some basic variables below, all available variables could be found in var.less。

// Component Colors
@text-color: #323233;
@border-color: #ebedf0;
@active-color: #f2f3f5;
@background-color: #f7f8fa;
@background-color-light: #fafafa;

How to custom theme

Step 1: import less file

First you should import the less source file to your project. you can use babel-plugin-import to automatically import or just manually import less file.

Automatically import style

Configure babel plugin in babel.config.js, if you are using babel6, please manually import less file.

module.exports = {
  plugins: [
    [
      'import',
      {
        libraryName: 'vant',
        libraryDirectory: 'es',
        // specify less file path
        style: name => `${name}/style/less`
      },
      'vant'
    ]
  ]
};

Manually import style

// import all styles
import 'vant/lib/index.less';

// import style of single component
import 'vant/lib/button/style/less';

Step 2: modify less variables

Use modifyVars provided by less.js to modify less variables，webpack config for reference:

// webpack.config.js
module.exports = {
  rules: [
    {
      test: /\.less$/,
      use: [
        // ...other loaders
        {
          loader: 'less-loader',
          options: {
            modifyVars: {
              // overide with less vars
              'text-color': '#111',
              'border-color': '#eee'
              // or override with less file
              'hack': `true; @import "your-less-file-path.less";`
            }
          }
        }
      ]
    }
  ]
};

2.0 KiB Raw Blame History Unescape Escape