React UI組件庫之快速實現antd的按需引入和自定義主題

Posted on by

React UI組件庫

流行的開源React UI組件庫

  • material-ui（國外）
  • ant-design（國內螞蟻金服）

antd的基本使用

antd 是基於 Ant Design 設計體系的 React UI 組件庫，主要用於研發企業級中後臺產品。

安裝antd組件庫：

npm install antd --save
yarn add antd

默認按需引入antd組件：

import { Button, DatePicker } from 'antd';

默認按需引入icons圖標：

import { WechatOutlined, SearchOutlined } from '@ant-design/icons';

默認全部引入antd組件庫樣式：

import 'antd/dist/antd.css';

由於全部引入antd組件庫樣式，會導致文件太大，影響性能問題，所以應該按需引入。

antd樣式按需引入

用到哪個組件的樣式，就引入哪個組件的樣式。參考文檔

1.安裝 react-app-rewired，customize-cra庫

npm add react-app-rewired customize-cra

react-app-rewired：用於啟動react腳手架（因為更新瞭腳手架的配置，所以不能用原來的命令啟動）。

customize-cra：用於執行修改配置的命令。

2.修改package.json文件

"scripts": {
    "start": "react-app-rewired start",
    "build": "react-app-rewired build",
    "test": "react-app-rewired test",
    "eject": "react-scripts eject"
 }

3.在項目根目錄創建一個 config-overrides.js 用於修改默認配置

// 配置具體的修改規則
module.exports = function override(config, env) {
  // do stuff with the webpack config...
  return config;
};

4.安裝並使用 babel-plugin-import，它是一個用於按需加載組件代碼和樣式的 babel 插件。

npm add babel-plugin-import

5.修改 config-overrides.js 文件

// 配置具體的修改規則
const { override, fixBabelImports } = require('customize-cra');

module.exports = override(
  fixBabelImports('import', {
    libraryName: 'antd',
    libraryDirectory: 'es',
    style: 'css',
  }),
);

完成上述操作，可以移除前面在 src/App.css 裡全部添加樣式的代碼： import 'antd/dist/antd.css'。最後重啟 npm start 訪問頁面，antd 組件的 js 和 css 代碼都會按需加載。

antd自定義主題

按照配置主題的要求，自定義主題需要用到 less 變量覆蓋功能。我們可以引入 customize-cra 中提供的 less 相關的函數 addLessLoader 來幫助加載 less 樣式，同時修改 config-overrides.js 文件。

1.安裝less和less-loader：

npm add less@5 
npm add less-loader@5
// npm add less less-loader@5

less：想要修改less文件需要安裝less。

less-loader：修改完之後編譯less文件需要安裝less-loader。

2.修改config-overrides.js文件：

// 配置具體的修改規則
const { override, fixBabelImports, addLessLoader } = require('customize-cra');

module.exports = override(
  fixBabelImports('import', {
    libraryName: 'antd',
    libraryDirectory: 'es',
    style: true,
  }),
  addLessLoader({
    javascriptEnabled: true,
    modifyVars: { '@primary-color': 'green' },
  }),
);

這裡利用瞭less-loader的 modifyVars 來進行主題配置，變量和其他配置方式可以參考 配置主題 文檔。

修改後重啟 npm start，如果看到一個綠色的按鈕就說明配置成功瞭。

總結

到此這篇關於React UI組件庫之快速實現antd的按需引入和自定義主題的文章就介紹到這瞭,更多相關React UI antd按需引入和自定義主題內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：