一个超轻量级的微信小程序状态管理库
An super lightweight state management tool for Weapp.
Redux太复杂了,有没有! 好吧,其实我只想同步一下全局变量所绑定的视图而已。那么试试这个轻量的状态管理工具把。Usage
先下载WeappStore.js,并把它放在根目录下的utils目录里。
在app.js里,先初始化WeappStore,并把它存在app上。
var WeappStore = require('./utils/store.js') // 创建store实例,并定义state,也就是希望在全局使用的状态变量。 var store = new WeappStore({ userName: 'Rebecca', userEmail: undefined }) // 可以开启debug模式 store.debug = true // 把store存在app上 App({ onLaunch: function () {}, onError: function () {}, $store: store })
在需要使用全局状态变量的页面的onLoad函数里,将页面变量和全局状态变量进行连接。
var app = getApp() Page({ data: {}, onLoad: function () { app.$store.link(this, 'userName') } })
<view class="Page"> Username: {{userName}} </view>
好了,现在如果需要改变全局状态变量的时候,就可以这么写啦:
app.$store.setState('userName', 'Alice')
所有绑定这个全局状态变量的页面,都会自动更新啦。
同时在页面的wxml也可以直接这么写
<view data-state=" userName: {{someVariable}} " catchtap="setState" />
因为在将页面link的时候,就自动为页面添加了setState方法,同时约定,data-state可以用于传递state的值。但是这里有一个限制,就是data-state只能是下面几种形式:
data-state=" userName: Alice " { userName: 'Alice' } data-state=" userNumber: 15 " { userNumber: 15 } date-state=" userBool: false" { userBool: false }
string,number和boolean可以直接解析成对应的类型。
下面是几种错误的写法:
date-state=" {{userBool: myBoolVariable}}" date-state=" userName: {{myNameVariable}}, userEmail: {{email}}"
目前在data-state里,仅支持一对键-值,如果需要设置更多的,那么可以在page里在写一个方法,在方法里再去设置state。很简单!有没有!
再重复一下,只有三个api
// 创建store实例 var weappStore = new WeappStore(stateObject) // 将全局状态变量绑定到页面, 如果状态名空缺的话,则只会把为页面赋予setState的方法,这样页面相当于只能设置state。 weappStore.link(page, stateName='') // 更新全局变量 weappStore.setState(stateName, newValue)
Redux什么的,暂时先放放吧。