Skip to content

Reson-a/wx-store

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wx-store 小程序状态管理方案

介绍

多页面间的状态管理和页面通信是一个老生常谈的问题,目前在前端领域已经有非常成熟的解决方案比如redux,也可以通过在app中建立事件总线利用发布订阅模式的方式来实现。

但对于小程序而言,上述方案都存在着一些问题

  • redux的概念较为复杂,初学者很难迅速上手掌握,并且代码量比较大,不够精简。绝大部分情况下小程序并不需要这么复杂的管理方案。
  • 事件总线的方式只是作为一种通信手段,页面数量多了之后比较混乱,并且需要适时地移除监听。
  • 对小程序而言,后台调用setData会影响前台页面的展示,当影响后台页面多,数据量较大时很容易造成卡顿,参见官方文档小程序-优化建议

当页面进入后台态(用户不可见),不应该继续去进行setData,后台态页面的渲染用户是无法感受的,另外后台态页面去setData也会抢占前台页面的执行。

事实上在很多情况下,我们并不需要状态一直保持及时更新,只需要在适当的时机展示正确的数据即可。

于是突发奇想(脑袋进水)做了一个简单的状态管理方案,这里借鉴了redux和vuex的部分思想和代码风格,源码非常精简,相信基本都能看懂。

使用方法

在app.js中引入全局的store

const store = require('/assets/plugins/wx-store/index.js')

App({
  store:{
      // inital State
      state: {},
      // actions
      actions: {}
  }
})

在page中:

  • 调用mapState将全局state映射到page中(并不需要在data中初始化,而是在onShow中调用,会自动更新对应数据,load之后再次show是很快的,执行setData的副作用很小)
  • 调用dispatch修改state(唯一方法), 传入this实例,页面会自动更新数据
const app = getApp()
const store = app.store


Page({
  data: {
  },
  onLoad() {
    // 派发action
    store.dispatch('login', this).then(()=>{})
  },
  onShow() {
    // 更新state
    store.mapState(['userInfo'], this)
  }
})

action的写法,返回值会直接setState到store,注意数据结构(可返回promise)

{
  login({ state }, payload) {
    return new Promise((resolve, reject) => {
      wx.getUserInfo({
        withCredentials: false,
        success: res => {
          let userInfo = res.userInfo
          resolve({
            userInfo
          })
        },
        fail: err => reject(err)
      })
    })
  },
  /* { index:0, todo:{content:''} } */
  addTodo({ state }, payload) {
    let todos = [...state.todos, payload.todo]
    return {
      todos
    }
  }
}

具体请参考本仓库的todolist项目实例

待添加

  • 支持以.分隔的key值
  • 提供方法合并页面内部数据的setData调用,最小化调用次数
  • 简单的模块管理

About

小程序简单状态管理方案

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published