luffyZh / Dynamic Antd Theme

A simple plugin to dynamic change ant-design theme whether less or css.

English | 简体中文

After gzip: 42.7kB

This project was initially targeted at 'ant-design', that means it's used in the React project. However, the core style was also applicable to 'ant-design-vue' || 'ant-design-angular'. In addition, for the convenience of one-key and auto use, the color-picker was also packaged into the project, resulting in too large a volume of the project. Aiming at this problem, I develope a new minor version —— mini-dynamic-antd-theme.

🏠 HomePage

Dynamic-Antd-Theme-Demo

🌍 Browser Support

Chrome 39.0+ ✔	Edge 12.0+ ✔	Firefox 30.0+ ✔	IE 11+ ✔	Safari 9.1+ ✔

📦 Install

npm install dynamic-antd-theme or yarn add dynamic-antd-theme

🔨 Usage

The best usage of the dynamic-antd-theme is in the common compnent (Layout/Header etc...) of your application.

// Layout.js
...
import DynamicAntdTheme from 'dynamic-antd-theme';
...

<div className='theme-container'>
  <span>Change antd theme: </span>
  <DynamicAntdTheme />
</div>

✨ Props

How to use the primaryColors in customCss?

You can do this using the following four variables（just like scss）：

• $primary-color
• $primary-hover-color
• $primary-active-color
• $primary-shadow-color

const customCss = `
  .ant-btn {
    font-family: fantasy;
  }
  .custom-title {
    color: $primary-color;
  }
  .custom-title:hover {
    color: $primary-hover-color;
    cursor: pointer;
  }
  #custom-id {
    color: $primary-shadow-color;
  }
`;

🌞 Export

🌰 More Example

Basic Use

<DynamicAntdTheme primaryColor='#77dd66' />

<DynamicAntdTheme storageName='my-custom-define-color' />

<DynamicAntdTheme style={{ display: 'margin: 10px' }} />

function themeChangeCallback (color) {
  document.getElementById('my-header-bar').style.backgroundColor = color;
}

<DynamicAntdTheme themeChangeCallback={this.themeChangeCallback} />

Define Custom CSS

// define custom css
const customCss = `
  .ant-btn {
    font-family: fantasy;
  }
  .custom-title {
    color: $primary-color;
  }
  .custom-title:hover {
    color: $primary-hover-color;
    cursor: pointer;
  }
  #custom-id {
    color: $primary-shadow-color;
  }
`;

<DynamicAntdTheme
  customCss={customCss}
/>

The effects as flow:

No Color-Picker

If u don't need the color-picker，mini-dynamic-antd-theme is more suitable for you.

import { generateThemeColor, changeAntdTheme } from 'dynamic-antd-theme';
...

<Button
  onClick={
    () => {
      const color = 'blue';
      changeAntdTheme(color);
    }
  }
>Change Theme</Button>

⚠️ Attention

This solution is easy to use, so it is prone to problems. We hope you can give us timely feedback. For example, if there is a problem with any component, we will fix the updated version as soon as possible.

• The current version requires your antd version to be lower than v3.19.0

The antd version is higher than v3.19.0 you can also use it, if have some problems remember give me an issue.

• ...Plugin versions are updated from time to time based on antd (new antd components are updated)

🔗 Changelogs

• v0.1.3

  Fix the Slider Component.

• v0.1.4

  Fix repeat insert <style> tag.

• v0.1.5

  Add placement props, bottom, bottomRight, right, topRight, top, topLeft, left, bottomLeft. Default is bottomRight.

• v0.1.6

  Add themeChangeCallback props, you can do something use themeColor when themeColor changed.

• v0.2.0

  Fix ant-design table tr background when cursor hovered.

• v0.2.4

  Support IE 11+.

• v0.2.6

  Fix DatePicker current date color.

• v0.3.0

  Export { generateThemeColor, changeAntdTheme } methods to help the developer who don't need react-colorPicker

• v0.3.2

  Fix <Button type='danger' /> bug, when hover the font color is primary-color.

• v0.3.6

  Fix DateRangePicker some bugs.

• v0.3.7

  Fixtable:hoverin antd^3.20.0+

• v0.3.8

  Fixcalendersome bugs.

• v0.3.9

  Fixtree-table-iconbug.

• v0.4.0

  Add /examples for users to use && look for bugs.

• v0.5.0

  Add index.d.ts to support Typescript.

• v0.6.0

  Add customCss Props to support user custom define css.

• v0.7.0

  Add options in the changeAntdTheme.

• v0.8.0

  Remove generateThemeColor, now changeAntdTheme first param only need primary color.

🍎 Follow-Up Plan

• More custom type: border-color, border-radius, etc.

If you're interested in this repository, Fork/PR/Issue all are welcome.