使用create-react-app2.0搭配antd-mobile构建项目后,发现官网的定制主题流程有些不符,经过一系列的探索后,决定记录下,2.0定制主题的方法。
使用create-react-app脚手架构建项目的过程就不说了,详情参考创建React应用
(注意:如果您以前_create-react-app_通过进行了全局安装_npm install -g create-react-app_,建议您使用卸载软件包,_npm uninstall -g create-react-app_以确保npx始终使用最新版本。)
导入antd-mobile,参照Ant Design Mobile of React,这里不展开。
以下从成功创建create-react-app@2.xApp及导入antd-mobile后开始。

开始

首先,你的项目里需要包含如下依赖 babel-plugin-import less less-loader style-loader css-loader

  1. npm install --save-dev babel-plugin-import less less-loader style-loader css-loader

安装完后的依赖版本:

  1. "devDependencies": {
  2. "babel-plugin-import": "^1.13.0",
  3. "css-loader": "^3.2.1",
  4. "less": "^3.10.3",
  5. "less-loader": "^5.0.0",
  6. "style-loader": "^1.0.1"
  7. }

在不暴露webpack配置文件的情况下,需要使用customize-crawebpack配置进行覆盖,再添加react-app-rewired customize-cra两项依赖:

  1. npm install react-app-rewired customize-cra --save-dev
  2. "customize-cra": "^0.9.1",
  3. "react-app-rewired": "^2.1.5",

修改package.json文件,使用react-app-rewired启动、编译项目:

  1. /* package.json */
  2. "scripts": {
  3. "start": "react-app-rewired start",
  4. "build": "react-app-rewired build",
  5. "test": "react-app-rewired test",
  6. }

然后在项目根目录创建一个 config-overrides.js 用于修改默认配置:

  1. module.exports = function override(config, env) {
  2. // do stuff with the webpack config...
  3. return config;
  4. };

① antd-mobile按需加载

从这一步开始,官网步骤已经开始出现繁琐及错误,在不暴露webpack配置的情况下,是无法完成的,而一旦执行eject则不可逆。所以这里使用customize-crawebpack配置进行覆盖,避免将webpack直接暴露出来。
修改 config-overrides.js 文件:

  1. const { override, fixBabelImports } = require('customize-cra');
  2. module.exports = override(
  3. fixBabelImports('import', {
  4. libraryName: 'antd-mobile',
  5. libraryDirectory: 'es',
  6. style: 'css',
  7. }),
  8. );

修改antd-mobile组件导入方式:

  1. import { Button } from 'antd-mobile';

之后npm start重新启动项目,就可以看到组件样式已经是有了的。

② antd-mobile定制主题

定制主题,也是在config-overrides.js文件进行更改

  1. const { override, fixBabelImports, addLessLoader } = require('customize-cra');
  2. module.exports = override(
  3. addLessLoader({
  4. javascriptEnabled: true,
  5. modifyVars: {'@brand-primary': '#1DA57A'},
  6. }),
  7. fixBabelImports('import', {
  8. libraryName: 'antd-mobile',
  9. libraryDirectory: 'es',
  10. style: true,
  11. }),
  12. );

使用addLessLoader插入less-loader,修改styletrue,确保加载less文件。
根据modifyVars项自由定制主题,一般由外部导入主题包赋值给modifyVars,这里写例子就直接写死了。关于antd-mobile所有可修改样式参考如下链接全部主题样式参考这里
再将样式封装一下,在项目根目录创建一个json文件antd-theme.json:

  1. {
  2. "@brand-primary": "#ff5722",
  3. "@brand-primary-tap": "#ffccbc",
  4. "@color-text-base-inverse": "#3f51b5"
  5. }

用来存在定制的主题样式,这里修改了primary颜色跟字体颜色,然后在config-overrides.js中引入:

  1. const theme = require('./antd-theme');
  2. //...
  3. modifyVars: theme,
  4. //...

修改modifyVarstheme,再修改下App.js做一个简单的展示:

  1. import React from 'react';
  2. import { Button } from 'antd-mobile';
  3. const App = () => {
  4. return (
  5. <div>
  6. <Button type="primary">antd-mobile定制主题</Button>
  7. </div>
  8. );
  9. };
  10. export default App;

最后运行npm start重新启动项目,就能看到效果了。
image.png
1575621602936.jpg
如此,关于antd-mobile定制主题就成功了,也不需要暴露webpack配置,也没有antd-mobile官网写的那么多乱七八糟的步骤,保持项目的整洁。

最后

什么?你的定制主题还是没显示?

  1. 请检查项目构建流程是否有按照以上步骤进行;
  2. 请检查你的定制主题属性,是否与你显示的组件对应
    比如:你写了这一条定制样式'@brand-primary': '#1DA57A',对应的是组件primary样式,则你的组件需要加上type='primary'属性才生效;
  3. 请确认style属性已经设置成true;
  4. 请确认各项依赖版本号,react-app-rewired需要2.0.0以上;

作者:讨厌西红柿
链接:https://www.jianshu.com/p/7097348cd900
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。