React UI antd按需引入和自定义主题

时间:2022-09-28 蜡笔雏田学代码人气:1

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

总结

加载全部内容