React+Redux仿Web追书神器
引言
由于 10 月份做的 React Native 项目没有使用到 Redux 等库,写了一段时间想深入学习 React,有个想法想做个 demo 练手下,那时候其实还没想好要做哪一个类型的,也看了些动漫的,小说阅读,聚合资源的开源项目。由于正好在学习开源的 Android 小说阅读器 -- 任阅,开始边学边做,已完成的功能列在下面。项目地址 在这里,如果有好的意见欢迎提 issue或pr。
效果图
目标功能
目录结构
.
├─actions #redux的action,业务逻辑
├─components #页面容器
│ └─common #公共目录
│ ├─component-module #封装的组件
│ ├─images #项目图片
│ │ └─icon
│ └─style #组件样式
├─modules #公用模块
│ ├─api #管理api请求类
│ └─constants #公共字段类
├─reducers #redux中的reducers,处理action发送的数据流
├─router #路由管理模块
├─store #redux中的store,联结reducers
└─template #存放html模版
.
项目的初始结构和说明已罗列如上。
下面对目录结构作以下说明
-
项目最初始是参考 react-pxq 初始化的。
-
中间件引人日志中间件 —— redux-logger,异步 API 调用 —— redux-thunk 等;
-
component-module 和 components 存放的都是 react 组件,区别是:容器组件就放在components中,和模块组件(比如左侧菜单组件、书籍列表组件等)就放到 component-module中;
-
页面状态等公共部分最好是独立起来,统一管理;
-
跨域配置使用 pathRewrite 字段,需要注意 webpack-dev-server 的版本
准备工作
-
- 整理 API
-
- 学习 Redux(搭建脚手架)
API 数据
- 数据来源主要是两个地方:一个是开源的Android项目与RN版本的数据,另一个是追书神器h5移动端
- 数据跨域:网上查了不少方法,考虑到便捷,使用反向代理的方式处理
学习 Redux
- 刚开始我差不多用一个星期多学习了 Github 上的 从零开始学 ReactJS(ReactJS 101),基本上每一天看个 1-2 章,玩的也很开心,浅显易懂,适合初学者阅读。
前面 8 章:主要是熟悉接下来会用到的基础概念,当然每一章讲完理论,后面都会有例子自己可以动手实践,加深对于前面概念的理解。
后面 9、10 两章开始运用上面学到的内容,做一个简单的项目。
- 接着是用了 5-6 天学习网上开源项目的脚手架 —— 一个 react + redux 的完整项目 和 个人总结,基本上是看
参考所使用的库、编译打包的脚本以及 redux 代码。
- 最后,大概花了 3 天看了阮一峰老师写的 Redux 入门教程
这部分内容是后面在搭建项目整体结构的时候看的,对于 reducers、action、store 的内容比较深入,加深理解。
技术栈
- 虽然列了众多核心库,但是自己也谈不上熟练运用,所以列了一些遇到的问题和后期改进的东西。
Webpack(3.10.0)
-
本项目主要用了第三方的脚手架,学习了反向代理部分,当然自己也搭建过 webpack,后续会升级 webpack。
-
这里提下反向代理部分,关于使用 webpack-dev-server 进行配置反向代理的时候,如果使用 pathRewrite 到属性需要注意 webpack-dev-server 版本,这个属性是在 1.15.0 中,不然是不起作用的。特此说明,网上查到相同问题没有这个解释,以免浪费时间。
-
升级Webpack到3.10版本并更新其他老的包,比如file-loader,css-loader等,出现的问题在下发表格中。
Webpack1.x升级到Webpack3.10
问题 | 1.x | 3.10 | 备注 | 参考 |
---|---|---|---|---|
webpack 2 cannot resolve empty extensions |
extensions数组中不能出现空字符或者字符串 | resolve: {extensions: ['','.css']} |
resolve: {extensions: ['.css']} |
参考1 |
Error: Chunk.entry was removed. Use hasRuntime() |
"extract-text-webpack-plugin": "^1.10.0", |
"extract-text-webpack-plugin": "^2.1.2", |
版本问题 | 参考1 |
Error: Breaking change: extract now only takes a single argument. Either an options object *or* the loader(s). |
loader: ExtractTextPlugin.extract('style', ['css', 'autoprefixer']), |
ExtractTextPlugin.extract({ fallback: 'style-loader', use: 'css-loader' }) |
新的版本只支持一个参数 | npm run dev 命令运行结果错误提示 |
找不到API Schema | modulesDirectories |
modules |
属性名称变更 | npm run dist 命令运行结果错误提示 |
找不到OccurenceOrderPlugin | new webpack.optimize.OccurenceOrderPlugin(),newwebpack.HotModuleReplacementPlugin(),new webpack.NoErrorsPlugin(),new webpack.optimize.UglifyJsPlugin() |
new webpack.HotModuleReplacementPlugin(),new webpack.optimize.UglifyJsPlugin() |
移除了OccurenceOrderPlugin 和 NoErrorsPlugin | 参考1 |
Redux
- 简单的讲他是一个管理单向数据流的框架,根据业务复杂度可以把控其中颗粒度。一开始学习的时候感觉反而把项目复杂化,看原理也是半懂不懂,后面不断实践理解前面看的内容,总归理论要与实践结合起来。
模型如下:简单的数据流向可以看作 View -> Action -> (Middleware) -> Reducer
React-router(2.x)
react-router(2.x)与react-router(4.x)的还是不同的,当然主要是写法上,所以没更新到4.0
另外, 发布打包时使用nginx等应用服务器托管的时候需要配置下,所用路由走index.html文件,不然路由会被拦截。
Antd(2.13)
-
antd是(蚂蚁金服体验技术部)经过大量的项目实践和总结,沉淀出的一个中台设计语言 Ant Design,使用者包括蚂蚁金服、阿里巴巴、口碑、美团、滴滴等一系列知名公司,其中包括了移动端,Web端,Pro(最近刚出)
-
遇到错误可以翻看 Antd的issues,基本能解决。
-
提 Issues 的话要符合一定规范,一开始感觉麻烦,后来看了 提问的智慧,恍然大悟这部分的必要性。
扩展内容
功能扩展
- 讨论区数据统计分析,主要想知道一段时间的热点内容。
测试及优化
- 现在项目代码是没有进行单元测试,后续学习集成JEST测试
- 优化部分页面的组件以及一些 bugs