优秀的编程知识分享平台

网站首页 > 技术文章 正文

react移动端项目构建,react+react_vant+vite+axios+redux+sass

nanyue 2024-07-25 06:01:24 技术文章 18 ℃

react:https://react.nodejs.cn/reference/react/hooks

vant:https://vant-contrib.gitee.io/vant/#/zh-CN

axios:https://www.axios-http.cn/docs/api_intro

vite:https://vitejs.cn/

redux:https://cn.redux.js.org/index.html

redux-persist:https://github.com/rt2zz/redux-persist

sass:https://blog.csdn.net/randy521520/article/details/131242242

前言:

本文主要讲解react V18移动端项目构建,在构建项目前请确保已安装node、yarn工具,node版本18+,此项目构建主要集成:axios、pinia、vant、sass、vite和react V18,其中还会介绍到如何跨页面传递数据、国际化配置、rem适配等功能

本文讲解的功能代码只是简要说明,完整代码可点击以下链接下载,下载后请先看README.md文档说明,已踩过大部分坑:

react@18.2.0+antd+vite+axios+redux+sass+ts 完整版代码下载:

reactPC端项目构建TS,react@18.2.0+antd+vite+axios+redux+sass+ts资源-CSDN文库

react@18.2.0+antd+vite+axios+redux+sass完整版代码下载:

reactPC端项目构建,react@18.2.0+antd+vite+axios+redux+sass资源-CSDN文库

react@18.2.0+react-vant+vite+axios+redux+sass+ts完整版代码下载:

react移动端项目构建TS,react@18.2.0+react-vant+vite+axios+redux+sass+ts资源-CSDN文库

react@18.2.0+react-vant+vite+axios+redux+sass完整版代码下载:

react移动端项目构建,react@18.2.0+react-vant+vite+axios+redux+sass资源-CSDN文库

一、初始化项目

  1. cmd打开终端工具,运行:yarn create vite
  1. 输入项目名称,键盘方向键选择React
  1. 键盘方向键选择JavaScript或JavaScript+SWC,SWC是JavaScript编译工具比Babel要快,但是在功能和插件生态系统方面Babel更完善;这里选择JavaScript
  1. 项目创建成功
  1. 开发者工具打开项目,打开开发者工具的终端,运行yarn install,安装package.json中的依赖包
  1. 修改package.json脚本中的dev为 vite --open,运行yarn dev,就会启动项目并在浏览器中自动打开,不加--open不会在浏览器中自动打开,项目初始化成功
  1. vite相关命令

vite [root]:启动开发服务器,可以指定一个根目录(可选)。 build [root]:构建生产环境的应用程序,可以指定一个根目录(可选)。 optimize [root]:预打包依赖项,用于优化构建性能。 preview [root]:本地预览生产环境的构建结果,可以指定一个根目录(可选)。 --open:启动开发服务器后自动打开默认浏览器并访问应用程序 --cors:启用 CORS(跨域资源共享)。 --strictPort:如果指定的端口已被占用,则退出。 --force:强制优化器忽略缓存并重新打包。 -c, --config <file>:使用指定的配置文件。 --base <path>:设置公共基础路径,默认为 /。 -l, --logLevel <level>:设置日志级别,可选值为 info、warn、error、silent。 --clearScreen:允许或禁用日志时的清屏操作。 -d, --debug [feat]:显示调试日志,可选参数为特定功能的名称。 -f, --filter <filter>:过滤调试日志的输出。 -m, --mode <mode>:设置环境模式。 -h, --help:显示帮助信息。 -v, --version:显示版本号。

二、集成vant

  1. 终端运行:yarn add react-vant,安装vant
  1. 新建pages>home>home.jsx,在home.jsx中使用Buton组件,并在vite.config.js配置路径别名
  1. 修改App.jsx,使用Home
  1. react-vant 支持基于 Tree Shaking 的按需加载,大部分的构建工具(例如 webpack 4+ 和 rollup)都支持 Tree Shaking,所以绝大多数情况下无需做额外的配置

三、集成sass

sass是css预处理器,可以声明变量、函数、嵌套等功能,可以减少重复的代码,使得样式表的结构更清晰、更易读。sass还内置了许多函数,处理颜色、数值等,也可以自定义函数扩展sass,还可以通过Mixin定义一组样式,并在需要的地方进行引用,可以避免重复的样式代码,并且方便进行样式的修改和维护

  1. 终端运行:yarn add sass -D,安装sass
  1. 在assets中新建scss>global.scss、scss>globalMixin.scss、scss>globalVar.scss、scss>iframe.scss,global.scss用于通用的样式、globalMixin.scss用于Mixin通用的样式、globalVar.scss用于全局变量、iframe.scss用于导出scss文件,修改vite.config.js,将iframe.scss文件引入到项目中
  1. 新建pages>home>home.module.scss,修改home.jsx,div样式使用了scss变量、Mixin函数、scss通用样式已生效

四、路由配置

  1. 终端运行:yarn add react-router-dom,安装react-router-dom
  1. 在src新建router.jsx
  1. 修改App.jsx、main.jsx

五、ConfigProvider定制化主题

  1. 在src下新建theme.js,之所以采用theme.js配置主题,是为了写内联样式时可以使用一样的主题配置
  1. 修改app.jsx,通过theme.js配置主题,有个缺点就是无法和globalVar.scss变量中的值保持统一,如果需要同一个基本变量,就要写两编,就像示例中globalVar.scss已配置红色值,但是要改变vant中button的背景色就要重新配置
  1. 解决globalVar.scss的sass变量无法和theme.js保持统一的问题,可通过在vite.config.js读取globalVar.scss文件,再配置全局变量
  1. 新建hooks>useCommon.js,并在vite.config.js中配置别名
  1. 修改globalVar.scss
  1. 修改App.jsx,重新运行yarn dev;这样配置有个缺点:import.meta.env是构建得时候生成得,项目运行后无法更改,修改globalVar.scss原有的值是不会变的,需要重新运行项目;可通过自定义插件解决该问题:插件配置configureServer,通过server.ws.on、server.ws.send把已改变的globalVar.scss后的值发送到客户端,客户端在useEnv中通过import.meta.hot.on接受值;可通过自定义插件解决该问题:插件配置configureServer,通过server.ws.on、server.ws.send把已改变的globalVar.scss后的值发送到客户端,客户端在useEnv中通过import.meta.hot.on接受值

六、集成postcss,适配

  1. 终端运行:yarn add postcss-px-to-viewport-8-plugin -D,安装postcss-px-to-viewport-8-plugin
  1. 在根目录上新建postcss.config.js,重新运行项目,会发现之前div中的px已转换为vw,vant框架内部定义的变量也转为vw
  1. 只使用postcss.config.js是无法转换内联样式中的像素,可以自己写个hooks转换
  1. 修改vite.config.js配置postcssConfig全局变量
  1. 在hooks下新建usePxTransform.js
  1. 修改home.jsx使用usePxTransform

七、集成redux,状态管理

  1. 终端运行:yarn add @reduxjs/toolkit react-redux redux-persist ,安装@reduxjs/toolkit、react-redux、redux-persist
  1. 在src下新建store>redux.js、store>persistConfig.js、store>demoStore.js,在vite.config.js配置路径别
  1. 修改App.jsx
  1. 修改home.jsx,使用demoStore

八、国际化配置

  1. 终端运行:yarn add i18next react-i18next,安装i18next、react-i18next
  1. 在src下新建common>enum.js,enum.js公共枚举文件,并在vite.config.js中配置路径别名
  1. 在src下新建lang>en_us.js、lang>zh_cn.js、lang>lang.js,用于创建国际化,并在main.js中使用该配置,在vite.config.js中配置路径别名,把语言配置存入localStorage是为了保证语言改变之后,刷新页面之后也可以使用之前改变后的语言
  1. 修改home.jsx

九、创建page.jsx组件作为项目的页面组件

  1. 终端运行:yarn add prop-types,安装prop-types
  1. 新建components>common>slot>Slot.jsx、components>common>slot>SlotContext.jsx、components>common>slot>SlotProvider.jsx、components>common>slot>SlotTemplate.jsx并把src/components在vite.config.js中配置路径别名
  1. 在components下新建layout>page>Page.jsx
  1. 删除index.css,把App.css修改为App.scss,修改App.jsx
  1. 修改home.jsx

十、集成字体图标

  1. 字体图标集成以阿里icon为例,访问:https://www.iconfont.cn/ 图标库,搜索返回,任选一个图标加入购物车
  1. 去购物车中,选择下载代码
  1. 在assets下新建font文件,把下载好的字体图标解压到该文件,然后在App.scss中引入iconfont.css
  1. 在components下新建commpon>icon>Icon.jsx
  1. 修改Page.jsx,增加返回图标

十一、集成axios

  1. 终端运行:yarn add axios,安装axios
  1. 在common下新增requests.js
  1. 修改home.jsx

十二、开发环境配置

  1. 在根目录下新建.env.development、.env.production
  1. 修改package.json中的脚本命令
  1. 修改useCommon.js中的useEnv
  1. 重新运行yarn dev

十三、路由跳转

  1. 修改Page.jsx、Icon.jsx,给Page.jsx增加返回事件,新建icon.modue.scss
  1. 在pages下新建三个页面:list.jsx、add.jsx、detail.jsx,分别为列表页、添加页、详情页,并配置路由
  1. 路由跳转home>list>add >detail 或 home>list>detail,下图中演示了两种路由跳转传参的方式,第一种params传参:需要提前在路由上配置相关参数,跳转成之后url上会显示参数,页面刷新之后不会丢失,通过useParams获取参数;第二种state传参,跳转成之后url上不会显示参数,页面刷新之后不会丢失,通过useLocation获取参数;不过返回页面时不能向返回页面传递参数,不需要该功能的可以忽略下面教程

十四、路由封装

在刚才的路由跳转中,分析了一些路由跳转的弱势,而且路由的封装可以完善Page.jsx的返回功能。可以参考微信小程序的路由跳转功能,通过消息事件发布和订阅(事件发射器)来封装路由,再由状态管理器储存路由。事件发射器有三个基本的功能:注册事件、移除事件、触发事件

  1. 终端运行:yarn add react-activation,安装react-activation,路由缓存
  1. 修改router.jsx、main.jsx,使用路由缓存
  1. 在根目录下新建tabBar.js,可使用该js扩展Page.tsx组件增加tabbar功能
  1. 新建utils>commonUtil.js,并配置路由别名
  1. 在stroe下新建routerStore.js,并在redux.js配置routerStore
  1. 在hooks下新建useRouter.js
  1. 修改Page.jsx
  1. 修改home.jsx、list.jsx、add.jsx、detail.jsx路由跳转,list中的useEffect、useActivate可以一起封装成hook
  1. 页面效果

十五、结语

本文只是大致讲了下react移动端项目搭建,具体的细节还是需要根据自己项目的需要进行调整。路由只封装了navigateTo、navigateBack,可以根据微信小程序路由api的逻辑https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.switchTab.html 封装switchTab、reLaunch、redirectTo,如果有更好的方法可以忽略该路由封装,个人觉得小程序路由做的挺好。路径别名可配可不配,根据自己喜好就行

Tags:

最近发表
标签列表