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

总结

到此这篇关于React UI组件库之快速实现antd的按需引入和自定义主题的文章就介绍到这了,更多相关React UI antd按需引入和自定义主题内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

你可能感兴趣的:(React UI组件库之快速实现antd的按需引入和自定义主题)