初探react技术栈（一）-优快云博客

作者开始使用React技术栈搭建后台项目，记录了配置过程与项目分层思路。介绍了官方脚手架create-react-app，为提升样式编写效率采用less/sass并修改配置，还提及配置路径摆脱繁琐相对路径，以及使用React + Ant Design的体验和遇到的问题。

react

最近已经开始使用react技术栈了，从头开始搭建项目，有必要的记录一下配置的过程以及项目分层的思路，这次后台项目采用的主要采用react-create-app脚手架以及Ant DesignUI 以及多语言react-intl

create-react-app

这是官方维护的脚手架应用我们一般也采用这个

$ npm or cnpm

$ npm install create-react-app -g #全局下载

$ create-react-app #[项目名称] 新建项目

# 如果想要把 webpack 配置暴露出来 可以执行以下命令
$ npm run eject # 初始时可以在package.json中找到
复制代码

less/sass

为了提升我们写样式的效率一般采用 less/sass

# less
$ npm i less less-loader

# sass
$ npm i node-sass sass-loader
复制代码

并在webpack.config.js修改以下配置:

# 添加sass支持
# 找到 file-loader
{
    loader: require.resolve('file-loader'),
    exclude: [/\.(js|mjs|jsx|ts|tsx)$/, /\.html$/, /\.json$/, /\.scss$/],
    options: {
    name: 'static/media/[name].[hash:8].[ext]',
    },
},
# 在exclude中加上`/\.scss$/` 并且在后面加上
{ 
    test: /\.scss$/,
    loader: ['node-sass', 'sass-loader']
}
复制代码

// 添加less支持 这种是省事的写法 如果需要 antd 的个性化主题定制 请参看下文 antd less 配置
// 找到 `/\.css$/` 改成 `/\.(?:le|c)ss$/`
// 找到 `getStyleLoaders` 函数 在其中 loaders 中添加
{
    loader: require.resolve('less-loader'),
    options: cssOptions,
}
// 这样就完成 less 支持
// 如果想要样式模块化那么就需要加上  modules: true
{
    test: cssRegex, // cssRegex这个代表着就是 匹配文件的正则表达式
    exclude: cssModuleRegex,
    use: getStyleLoaders({
    importLoaders: 1,
    modules: true,  //模块化
    sourceMap: isEnvProduction && shouldUseSourceMap,
    }),
    sideEffects: true,
},
复制代码

完成对less/sass支持，!注意样式模块化需要不同的文件命名方式比如 app.scss 模块化 -> app.module.scss 否则编译器也不知道那个文件是私有的

配置路径

一般情况下我们引入文件都是需要相对路径但是如果嵌套层级少还可以但是如果层级很多我们就需要寻找一种办法帮助我们来摆脱繁琐的 ./../......

同样还是在webpack.config.js 找到alias在其中添加 '@': paths.appSrc

Ant Design

之前一直使用的 vue + element 的布局方式，而这次写项目则是主要使用 React + Ant Design

不得不说Ant Design整体的动画以及各种方案让我耳目一新！天啦噜这个动画爱了爱了

# 下载antd
$ npm or cnpm
$ npm i antd --save 
复制代码

首先在全局样式文件中写@import '~antd/dist/antd.css';此时就可以看到antd已经引入成功了

根据 Ant Design 官方文档推荐其中定制主题介绍了less

所有可定制的less变量

@import '~antd/dist/antd.less'; // 引入官方提供的 less 样式入口文件
@import 'your-theme-file.less'; // 用于覆盖上面定义的变量
复制代码

警告根据antd issues 7929中提示 css less 不要都采用less-loader

// 首先在webpack中定义两种变量
const lessRegex = /\.less$/; // 可以找到 `style files regexes` 处声明
const lessModuleRegex = /\.module\.less$/;
// 这是为了匹配 .less / .module.less 文件
// 找到 `getStyleLoaders` 函数 在其中 loaders 中添加
{
    loader: require.resolve('less-loader'),
    options: cssOptions,
}
// 找到 sassModuleRegex 位置处 在对象后加上 以下代码
{
    test: lessRegex,
    exclude: lessModuleRegex,
    use: getStyleLoaders(
    {
        importLoaders: 1,
        sourceMap: isEnvProduction && shouldUseSourceMap
    }
    ),
    sideEffects: true,
},
{
    test: lessModuleRegex,
    use: getStyleLoaders(
    {
        importLoaders: 1,
        sourceMap: isEnvProduction && shouldUseSourceMap,
        modules: true, // 模块化
        getLocalIdent: getCSSModuleLocalIdent,
    }
    ),
}
复制代码

此时还没有完成但是less / module.less 但是在改主题色的时候，我们发现会报错

// 此时需要修改以下代码
// 找到 `getStyleLoaders` 函数 在其中 loaders 中添加
{
    loader: require.resolve('less-loader'),
    options: {...cssOptions, javascriptEnabled: true}, // 启用js编译。。。
}
复制代码

相信用scss/sass的同学也不少

// 找到 `getStyleLoaders` 函数 在其中 loaders 中添加
{
    loader: require.resolve('less-loader'),
    options: {...cssOptions, javascriptEnabled: true, modifyVars: {'primary-color': '#000',}}, // 启用js编译。。。
}
复制代码