用React-Native+Mobx做一个迷你水果商城APP

前言

最近一直在学习微信小程序,在学习过程中,看到了wxapp-mall这个微信小程序的项目,觉得很不错,UI挺小清新的,便clone下来研究研究,在看源码过程中,发现并不复杂,用不多的代码来实现丰富的功能确实令我十分惊喜,于是,我就想,如果用react-native来做一个类似这种小项目难不难呢,何况,写一套代码还能同时跑Android和IOS(小程序也是。。。),要不写一个来玩玩?有了这个想法,我便直接react-native init 一个project来写一下吧(๑•̀ㅂ•́)و✧

先来张动图,dengdengdeng~~

show

技术框架和组件

  • react “16.0.0”
  • react-native “0.51.0”
  • mobx: “3.4.1”
  • mobx-react: “4.3.5”
  • react-navigation: “1.0.0-beta.21”
  • react-native-scrollable-tab-view: “0.8.0”
  • react-native-easy-toast: “1.0.9”
  • react-native-loading-spinner-overlay: “0.5.2”

为什么要用Mobx?

Mobx是可扩展的状态管理工具,比react-redux要简单,上手也比较快。在这个小项目中,因为没有后台服务接口,用的都是本地的假数据,为了模拟实现 浏览商品 =>加入购物车=>结账=>清空购物车=>还原商品原始状态 这么一个流程,便用Mobx来管理所有的数据以及商品的状态(有没有选中,有没有加入购物车),这样,所有的页面都可以共享数据以及改变商品的状态,页面之间的数据和商品状态都是同步更新的。具体用Mobx怎么来实现这流程,在下面会分享使用感受和遇到的一些小坑。

开始

react-native init一个project,然后用yarn或者npm装好所有的依赖和组件。因为使用Mobx会用到ES7中装饰器,所以还要安装babel-plugin-transform-decorators-legacy这个插件,然后在.babelrc文件下添加以下内容即可。

1
2
3
4
{
"presets": ["react-native"],
"plugins": ["transform-decorators-legacy"]
}

项目结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|-- android
|-- ios
|-- node_modules
|-- src
|-- common // 公用组件
|-- img // 静态图片
|-- mobx // mobx store
|-- newGoods.js // 首页新品数据
|-- cartGoods.js // 购物车数据
|-- categoryGoods.js // 分类页数据
|-- store.js // store仓库,管理数据状态
|-- scene
|-- Cart // 购物车页面
|-- Category // 分类页
|-- Home // 首页
|-- ItemDetail // 商品信息页
|-- Mine // 我的页面
|-- Root.js // root.js主要内容是配置react-navigation(导航器)
|-- index.js // 主入口

Root.js文件中,有关react-navigation的配置和使用方法可以参考下 官方文档这篇博客 ,里面都写得十分详细,有关react-navigation的疑问我都在这2篇文章中找到答案,在这里相关react-navigation配置,使用方法和项目里面页面布局,组件写法,在这里不打算细说,因为都比较简单,更多的是讨论Mobx实现功能的一些逻辑和方法,screen文件夹下的组件都写有注释的(°ー°〃)

主要还是来聊聊Mobx吧

先来看看用Mobx实现的具体流程,看下面的动图(⊙﹏⊙)

ps: 可能图片太大,加载有点慢,请稍等……

pay

1. 数据存储和获取

这些都是用假数据来模拟实现的,在最开始,先写好假数据的数据结构,例如:

1
2
3
4
5
6
7
8
"data":
[{
"name": "那么大西瓜",
"price": "2.0",
"image": require('../img/a11.png'),
"count": 0,
"isSelected": true
},...]

在Mobx文件夹下的store.js,在这里主要是存储和管理app用到的所有商品的数据,将逻辑和状态从组件中移至一个独立的,可测试的单元,这个单元在每个页面下都可以用到。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
import { observable, computed, action } from 'mobx'
import cartGoods from './cartGoods'
import newGoods from './newGoods'
import categoryGoods from './catetgoryGoods'
/**
* 根store
* @class RootStore
* CartStore 为购物车页面的数据
* NewGoodsStore 为首页的数据
* categoryGoodsStore 为分类页的数据
*/
class RootStore {
constructor() {
this.CartStore = new CartStore(cartGoods,this)
this.NewGoodsStore = new NewGoodsStore(newGoods,this)
this.categoryGoodsStore = new categoryGoodsStore(categoryGoods,this)
}}
Class CartStore{
@observable allDatas = {}
constructor(data,rootStore) {
this.allDatas = data
this.rootStore = rootStore
}
}
Class NewGoodsStore{
...跟上面一样
}
Class categoryGoodsStore{
...跟上面一样
}
// 返回RootStore实例
export default new RootStore()

这里用了RootStore来实例化所有了stores(购物车,首页,分类页分别拥有各自的store),

这样,可以通过RootStore 来管理和操作stores,从而实现它们之间的相互通信,共享引用。

其次,存储数据用了Mobx的@observable方法,就是把数据成为观察者,当用户操作视图,导致数据发生变化时,注意,配合react-mobx提供的@observer可以自动更新视图,非常方便。

此外,为了把MobxRootstore注入到react-native的组件中,要通过mobx-react提供的Provider实现,在Root.js下,我是这么写的:

1
2
3
4
5
6
7
8
9
10
11
// 全局注册并注入mobx的Rootstore实例,首页新品,分类页,商品详情页,购物车页面都要用到store
import {Provider} from 'mobx-react'
// 获取store实例
import store from './mobx/store'
const Navigation = () => {
return (
<Provider rootStore={store}>
<Navigator/>
</Provider>
)}

把Rootstore实例注入到组件树中后,那么,是不是在组件中直接使用this.props.rootStore就可以取到了呢?

“不是的”,我们还需要在要用到Rootstore的组件里,要加点小玩意,在HomeScreen.js(首页中这么写:

1
2
3
4
5
6
7
import { inject, observer } from 'mobx-react'
@inject('rootStore') // 缓存rootStore,也就是在Root.js注入的
@observer // 将react组件转变为响应式组件, 数据改变自动触发render函数
export default class HomeScreen extends Component {
......
}

加上了@inject('rootStore'),我们就可以愉快地使用 this.props.rootStore 来拿到我们想要的数据啦^_^ ,同样,在商品信息,分类页,购物车页面js下,也需要使用@inject('rootStore')来实现数据的获取,然后再一步步地把数据传到它们的子组件中。

2. 加入购物车的实现

在首页和分类页中,都可以点击跳转到商品信息页,然后再加入到购物车里

add

实现方法:

itemDetail.js下,也就是商品信息页面下,加入购物车的逻辑是这样子的:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
addCart(value) {
if(this.state.num == 0) {
this.refs.toast.show('添加数量不能为0哦~')
return;
}
// 加入购物车页面的列表上
// 点一次,购物车数据同步刷新
this.updateCartScreen(value)
this.refs.toast.show('添加成功^_^请前往购物车页面查看')
}
// 同步更新购物车页面的数据
updateCartScreen (value) {
let name = this.props.navigation.state.params.value.name;
// 判断购物车页面是否存在同样名字的物品
let index;
if(this.props.rootStore.CartStore)
index = this.props.rootStore.CartStore.allDatas.data.findIndex(e => (e.name === name))
// 不存在
if(index == -1) {
this.props.rootStore.CartStore.allDatas.data.push(value)
// 加入CartStore里
// 并让购物车icon更新
let length = this.props.rootStore.CartStore.allDatas.data.length
this.props.rootStore.CartStore.allDatas.data[length - 1].count += this.state.num}
else {
// 增加对应name的count
this.props.rootStore.CartStore.allDatas.data[index].count += this.state.num
}
}

简单的说,先获取水果的名称name,然后再去判断MobxCartStore里面是否存在同样的名称的水果,如果有就增加对应name的数量count,如果没有,就往CartStore中增加数据,切换到购物车页面时,视图会同步刷新,看到已加入购物车的水果。

3. 改变商品状态同步更新视图

当用户在购物车页面操作商品状态时,数据改变时,视图会跟着同步刷新。

例如,商品的增加数量,减少数据,选中状态,商品全选和商品删除,总价格都会随着商品的数量变化而变化。

图又来了~~

state

实现上面的功能,主要用到了Mobx提供的action方法,action是用来修改状态的,也就是用action来修改商品的各种状态(数量,选中状态…),这些action,我是写在store.js的CartStore类中的,下面贴出代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
// 购物车store
class CartStore {
@observable allDatas = {}
constructor(data,rootStore) {
this.allDatas = data
this.rootStore = rootStore
}
//加
@action
add(money) {
this.allDatas.totalMoney += money
}
// 减
@action
reduce(money) {
this.allDatas.totalMoney -= money
}
// checkbox true
@action
checkTrue(money) {
this.allDatas.totalMoney += money
}
// checkbox false
@action
checkFalse(money) {
if(this.allDatas.totalMoney <=0 )
return
this.allDatas.totalMoney -= money
}
// 全选
@action
allSelect() {
if(this.allDatas.isAllSelected) {
// 重置totalMoney
this.allDatas.totalMoney = 0
this.allDatas.data.forEach(e=> {
this.allDatas.totalMoney += e.count * e.price})}
else {
this.allDatas.totalMoney = 0
}}
// check全选
@action
check() {
// 所有checkbox为true时全选才为true
let allTrue = this.allDatas.data.every(v => ( v.isSelected === true ))
if(allTrue) {
this.allDatas.isAllSelected = true
}else {
this.allDatas.isAllSelected = false
}}
// 删
@action
delect(name) {
this.allDatas.data = this.allDatas.data.filter (e => (e.name !== name ))
}
// 总价格
@computed get totalMoney() {
let money = 0;
let arr = this.allDatas.data.filter(e => (e.isSelected === true))
arr.forEach(e=> (money += e.price * e.count))
return money
}}

所有修改商品状态的逻辑都在上面代码里面,其中,totalMoney是用了Mobx的@computed方法,totalMoney是依赖于CartStoredata数据,也就是商品数据,但data的值发生改变时,它会重新计算返回。如果了解vue的话,这个就相当于vue的计算属性。

4. 结算商品

商品结算和清空购物车的逻辑都写在CartCheckOut.js里面,实现过程很简单,贴上代码吧:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// 付款
pay() {
Alert.alert('您好',`总计:¥ ${this.props.mobx.CartStore.totalMoney}`,
{text: '确认支付', onPress: () => this.clear()},
{text: '下次再买', onPress: () => null}],{ cancelable: false })}
// 清空购物车
clear() {
this.setState({visible: !this.state.visible})
setTimeout(()=>{
this.setState({ loadText: '支付成功!欢迎下次光临!' })
setTimeout(()=> { this.setState({ visible: false },
()=>{ this.props.mobx.CartStore.allDatas.data = []
// 把所有商品count都变为0
this.props.mobx.NewGoodsStore.allDatas.data.forEach(e=> e.count = 0)
this.props.mobx.categoryGoodsStore.allDatas.data.forEach( e => {
e.detail.forEach(value => { value.count = 0 })
})
})},1500)},2000)}

这里主要用了setTimeout和一些方法来模拟实现 支付中 => 支付完成 => 清空购物车 => 还原商品状态

好了,这个流程就搞定了,哈哈。

5.遇到的小坑

1.我写了一个数组的乱序方法,里面有用到Array.isArray()这个方法来判断是否为数组,但是,我用这个乱序函数时,想用来搞乱store里面的数组时,发现一直没有执行,觉得很奇怪。然后我直接用Array.isArray()这个方法来判断store里面的数组,返回的一直都是false。。。于是我就懵了。。。后来,我去看了Mobx官方文档,终于找到了答案。原来,store里面存放的数组,并不是真正的数组,而是obverableArray,如果要让Array.isArray()判断为true,就要在取到store的数组时,加个.slice()方法,或者Array.from()都可以。

2.同样,也是obverableArray的问题。在购物车页面时,我用了FlatList来渲染购物车的item,起初,当我增加商品到购物车,发现购物车页面并没有刷新。有了上面的踩坑经验,我认为是obverableArray引起的,因为FlatList的data接收的是real Array,于是,我用这样的方法:

1
2
3
4
5
@computed get dataSource() {
return this.props.rootStore.CartStore.allDatas.data.slice();
}
...
<FlatList data={this.dataSource} .../>

于是,购物车视图就可以自动地刷新了,在官方文档上也有写到。

3.还有一个就是自己粗心造成的。我写完这个项目后,和朋友出去玩时,顺便发给朋友看看,他在删除商品时发现,从上往下删删不了,从下往上删就可以。后来我用模拟器测试也是如此,于是就去看看删除商品的逻辑,发现没有问题,再去看store的数据,发现也是可以同步更新的,只是视图没有更新,于是我又在FlatList去找原因,终于,原因找到了,主要是在keyExtractor里面,用数组的index是不可以的,要用name来作为key,也就是说这里的key值,要足够稳定的,不能用index(索引)去绑定key,这也是react的语法之一。因为我删除商品方法其实是根据name来删的,而不是index,所以用index来作为FlatList的Item的key时是会出现bug的。

1
2
3
4
_keyExtractor = (item,index)=> {
// 千万别用index,不然在删购物车数据时,如果从第一个item开始删会产生节点渲染错乱的bug
return item.name
}

写在最后

总结

断断续续花了差不多一个星期才写好,总得来说,我感觉用react-native来写这么一个商城项目要比小程序实现要复杂点,主要是在写组件上花的时间要多一点,和这里用Mobx来模拟实现购物流程也花了我些时间。Android打包成apk可以在我的模拟器上和我朋友的Android手机上完美运行,还没发现什么bug,IOS的因为我没MAC,所以暂时还没打包测试T.T,希望有条件的小伙伴可以clone下来,帮我测测,有Issue的话可以提下,多谢多谢ヽ(✿゚▽゚)ノ

附上github项目地址: https://github.com/shooterRao/react-native-fruitStore (如果感兴趣,希望能点下Star,给予点鼓励,谢谢!)

致谢

这个小项目的灵感出于wxapp-mall,在此款小程序的基础上,优化了购物逻辑和一些交互上的修改。有些UI和Icon也沿用了此款小程序,我也得到了原作者的允许,非常感谢。此外,我还要特别感谢肖JerryShaw帮我作的水果图和App的logo,还有也要感谢Keson帮忙测试和提供建议。

文章作者: Rao Jinwei
文章链接: http://shooterblog.site/2017/12/27/用React-Native+Mobx做一个迷你水果商城APP/
版权声明: 本博客所有文章除特别声明外,均采用 CC BY-NC-SA 3.0 许可协议。转载请注明来自 Rao Jinwei's Blog