微信小程序 + redux 简单实现

最终目的

全局共享的状态管理

全局状态能绑定到page的data上并同步更新

页面或组件能触发状态更新的action

无需构建

思路

使用npm下载redux并使用其dist目录中的redux.min.js
创建全局store，提供订阅和取消订阅钩子，在自定义中间件中执行钩子
store由多个reducer组成，每个reducer充当特定领域模型并提供action函数(支持异步)
实现pageWrapper函数，对page的参数进行预处理，对其connectData跟全局store作绑定

准备工作

从npm找一个redux.js

npm install redux
cp ./node_modules/redux/dist/redux.min.js ./utils/

开始

创建store store/index.js

...
function hookMiddleware({getState, dispatch}){
	return next => action => {
        // before dispatch

        // Call the next dispatch method in the middleware chain.
        let returnValue = next(action)

        let state = getState();

        // after dispatch

		// 触发页面钩子 按需更新page.data
		_hooks.forEach(hook=>{
			hook( action.type, state );
		})
        
        return returnValue;
    }
}
...

使用了redux提供的中间件api监听action变化，为同步更新试图提供了基础条件

仿照redux-actions创建handleActions函数utils/handleActions.js

module.exports = function(actionHandler, initialState){

    return function(state, action){
        state = initialState;

        if( action && typeof actionHandler[action.type] === 'function' ){
            state = actionHandler[action.type]( state, action );
        }

        return state;
    }
}

整个函数就几行代码，传参和redux-actions的handleActions函数一样，本来可以直接使用npm下载redux-actions来使用，但是新版本的redux-actions生成文件使用了window、eval关键字，不支持在小程序中直接引用，而且文件也比较多用不到的方法函数，所以几行简单代码替代了redux-actions

reducer示例

let personReducer = handleActions({

    ['person/CLEAR'] : (state, action) =>{
       state.list = [];
       return {...state};
    },

    ['person/SET'] : (state, action) => {
        state.list = action.payload;
        return {...state};
    }

}, {
   list : []
})

personReducer.getList = asyncActionWrapper(function(payload, {store, state, dispatch}){

    return new Promise((resolve, reject)=>{

        setTimeout(()=>{
            dispatch({
                type : 'person/SET',
                payload : ['Jack Ma', 'Jackon Ma', 'Pony Ma', 'Tony Ma']
            })
            resolve();
        }, 1500);
        
    })

})

其中asyncActionWrapper为封装函数，其实也可以在生成action的时候统一用asyncActionWrapper，省去了每个action都要包装一次的麻烦

实现pageWrapper函数，供页面绑定store中的数据。utils/pageWrapper.js

这里的思路是： onload的时候初始化其绑定数据并建立钩子函数； onShow时把钩子扔到store的钩子数组中； onHide和onUnload时移除钩子。

具体实现可看源码，这里有几个注意点：

在拿到新的store数据(newConnectData)准备更新页面的data时,如果newConnectData中含有undefined的值，小程序进行page.setData会报错，所以把undefined置换成null
一个页面可能有多个connectData项，为了减少setData的调用，把所有需要更新的项计算出来之后才进行一次setData
在判断connectData某一项是否要更新时，是采用了react-redux中一样的shallowEqual算法，所以在某些场景可能造成意料之外的结果例如 connectData中某一项是原样返回state.person.list <Array>

   connectData : {
       list({state , page})=>{
           return state.person.list;
       }
   }

而同时personReducer中的某个actionHandler中没有对对象属性做特殊处理

   ['person/INSERT'] : (state, action) => {
       state.list.push('Mark John');
       return {...state}; // state.list引用没变
       /*return {
           ...state, 
           list: [...state.list]
       }; 
           state.list引用变了
       */
   }

这时候connectData在对list的脏值判断中，因为shallowEqual对同一引用视作相等，所以'person/INSERT'不会触发页面的更新,解决方法之一就是像上述代码的注释一样，对对象类型的属性做特殊处理，另一个方法是在connectData中对对象类型的数据用解构赋值产生新的对象

   connectData : {
       list({state , page})=>{
           return [...state.person.list];
       }
   }

page的示例用法

...
Page(pageWrapper({
    connectData : {
        counterNum : depsWrapper(['counter'], ({state , page})=>{
            return state.counter.num + page.data.afterAddon;
        }),
        persons : depsWrapper(['person'], ({state , page})=>{
            return [...state.person.list];
        })
    }
},{
    data: {
        afterAddon : '个',
    },
    onShow(){
        console.log(this.$store);
        console.log(this._update);
    }
})
...

其中depsWrapper封装函数是用来注明依赖的reducer的，action.type不属于依赖的reducer则会跳过脏值判断，更geek的做法是用UglifyJs对connectData函数做AST(抽象语法数)解析，找出其中对哪些reducer有依赖，但是这意味着需要对代码做构建，和这次的简单实现有悖，所以不做实现。

最后参照index.wxml看一下实际的效果

<view class='container'>
    counterNum : {{counterNum}}
    <view class='btns'>
        <button size='mini' bind:tap='onReduce'>-</button>
        <button size='mini' bind:tap='onAdd'>+</button>
    </view>

    <view class='list'>
        <view wx:for="{{persons}}" wx:key="*">{{item}}</view>
    </view>

    <view class='btns'>
        <button size='mini' bind:tap='onGetList'>getList</button>
        <button size='mini' bind:tap='onClear'>clear</button>
    </view>
</view>

chocking/weapp-redux

微信小程序 + redux 简单实现

最终目的

思路

准备工作

开始