React UI组件库——如何快速实现antd的按需引入和自定义主题

Posted 2022-08-10 蜡笔雏田学代码

文章目录

• 🔻React UI组件库
• • 🔥流行的开源React UI组件库
  • 🔥antd的基本使用
  • 🔥antd样式按需引入
  • 🔥antd自定义主题

大家上午好呀~
今天来学习一下React的UI组件库以及antd的使用相关的知识点。
感兴趣的小伙伴可以给个三连哦~

🔻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，如果看到一个绿色的按钮就说明配置成功了。

今天的分享就到这里啦 ✨
如果对你有帮助的话，还请👉🏻关注💖点赞🤞收藏⭐评论🔥哦
不定时回访哟🌹