react 引入antd并制定主题

引入antd并制定主题

本节引用于antd的官方文档

这是 create-react-app 生成的默认目录结构。

├── README.md
├── package.json
├── public
│   ├── favicon.ico
│   └── index.html
├── src
│   ├── App.css
│   ├── App.js
│   ├── App.test.js
│   ├── index.css
│   ├── index.js
│   └── logo.svg
└── yarn.lock
复制代码

如今从 yarn 或 npm 安装并引入 antd。

yarn add antd
复制代码

修改 src/App.js，引入 antd 的按钮组件。

import React from 'react';
import {Button} from 'antd'
import './App.css';

function App() {
  return (
    <div className="App">
      <Button type="primary">Button</Button>
    </div>
  );
}

export default App;
复制代码

修改 src/App.css，在文件顶部引入 antd/dist/antd.css。

@import '~antd/dist/antd.css';

.App {
  text-align: center;
}

...
复制代码

好了，如今你应该能看到页面上已经有了 antd 的蓝色按钮组件，接下来就能够继续选用其余组件开发应用了。

高级配置

咱们如今已经把组件成功运行起来了，可是在实际开发过程当中还有不少问题，例如上面的例子实际上加载了所有的 antd 组件的样式。

此时咱们须要对 create-react-app 的默认配置进行自定义，这里咱们使用 react-app-rewired （一个对 create-react-app 进行自定义配置的社区解决方案）。

yarn add react-app-rewired customize-cra
复制代码

/* package.json */
"scripts": {
-   "start": "react-scripts start",
+   "start": "react-app-rewired start",
-   "build": "react-scripts build",
+   "build": "react-app-rewired build",
-   "test": "react-scripts test",
+   "test": "react-app-rewired test",
}
复制代码

而后在项目根目录建立一个 config-overrides.js 用于修改默认配置。

使用 babel-plugin-import

注意：antd 默认支持基于 ES module 的 tree shaking，js 代码部分不使用这个插件也会有按需加载的效果。

babel-plugin-import 是一个用于按需加载组件代码和样式的 babel 插件（原理），如今咱们尝试安装它并修改 config-overrides.js 文件。

yarn add babel-plugin-import
复制代码

而后移除前面在 src/App.css 里全量添加的 @import '~antd/dist/antd.css'; 样式代码，而且按下面的格式引入模块。

+ const { override, fixBabelImports } = require('customize-cra');

- module.exports = function override(config, env) {
-   // do stuff with the webpack config...
-   return config;
- };
+ module.exports = override(
+   fixBabelImports('import', {
+     libraryName: 'antd',
+     libraryDirectory: 'es',
+     style: 'css',
+   }),
+ );
复制代码

最后重启yarn start访问页面，antd 组件的 js 和 css 代码都会按需加载

自定义主题

按照 配置主题 的要求，自定义主题须要用到 less 变量覆盖功能。咱们能够引入 customize-cra 中提供的 less 相关的函数 addLessLoader 来帮助加载 less 样式，同时修改 config-overrides.js 文件以下。

yarn add less less-loader
复制代码

- const { override, fixBabelImports } = require('customize-cra');
+ const { override, fixBabelImports, addLessLoader } = require('customize-cra');

module.exports = override(
  fixBabelImports('import', {
    libraryName: 'antd',
    libraryDirectory: 'es',
-   style: 'css',
+   style: true,
  }),
+ addLessLoader({
+   javascriptEnabled: true,
+   modifyVars: { 
+    '@primary-color': '#1DA57A'
+    '@link-color': '#1890ff', // 连接色
+    '@success-color': '#52c41a', // 成功色
+    '@warning-color': '#faad14', // 警告色
+    '@error-color': '#f5222d', // 错误色
+    '@font-size-base': '14px', // 主字号
+    '@heading-color': 'rgba(0, 0, 0, 0.85)', // 标题色
+    '@text-color': 'rgba(0, 0, 0, 0.65)', // 主文本色
+    '@text-color-secondary' : 'rgba(0, 0, 0, .45)', // 次文本色
+    '@disabled-color' : 'rgba(0, 0, 0, .25)', // 失效色
+    '@border-radius-base': '4px', // 组件/浮层圆角
+    '@border-color-base': '#d9d9d9', // 边框色
+    '@box-shadow-base':' 0 2px 8px rgba(0, 0, 0, 0.15)', // 浮层阴影},
+ }),
);
复制代码

这里利用了 less-loader 的 modifyVars 来进行主题配置，变量和其余配置方式能够参考 配置主题 文档。

修改后重启 yarn start，若是看到一个绿色的按钮就说明配置成功了。

更多主题定制方案可参考官网【定制主题】

eject

你也可使用 create-react-app 提供的 yarn run eject 命令将全部内建的配置暴露出来。

参考如下文章进行antd配置： react暴露后，webpack4.19.1实现按需加载antd