小程序功能增强库 moonjs ,基于Proxy构建的全局数据中心、connect函数为小程序提供model数逻辑层支持
moon
可能是世界上最小巧的小程序功能增强库. https://github.com/MatrixAge/moon
install
[代码]npm i @matrixage/moon[代码]
微信开发者工具 -> 工具 -> 构建npm
usage
moon (全局状态管理)
在app.js中定义全局变量
[代码]import { moon } from '@matrixage/moon'
App({
onLaunch () {
moon(wx).define({
userinfo:{},
loaded: false
})
}
})
[代码]
在A页面修改已经定义的值
[代码]wx.$set({
loaded:true
})
[代码]
在B页面监听字段的变化
[代码]wx.$watch('loaded',(new_val,old_val)=>{
this.setData({
visible_ads: new_val
})
console.log(old_val)
})
[代码]
connect (支持dva model)
页面的js文件 (index.js)
[代码]import { connect } from '@matrixage/moon'
import model from './model'
const page = {
onLoad () {
this.dispatch({
type: 'query',
payload:{
shop_id: 1
}
})
}
}
connect(page, model)
[代码]
页面的model文件 (model.js)
[代码]import { Service_getContent, Service_getUserinfo } from './services'
export default {
data: {
list: [],
userinfo: {},
loading: false
},
effects: {
async query ({ payload }) {
const { result, success } = await Service_getContent(Object.assign(payload,{ type: 1 }))
if (!success) return
this.setData({
list: result
})
},
async getUserinfo () {
const {result, success} = await Service_getUserinfo()
if (!success) return
this.setData({
userinfo: result
})
}
},
reducers: {
showLoading () {
this.setData({ loading: true })
},
hideLoading () {
this.setData({ loading: false })
}
}
}
[代码]
model只支持三种对象:
data (同小程序data)
effects (异步方法,通常用于获取异步数据)
reducers (同步方法,通常用于控制模态框或是loading的显示隐藏)
在index.js中使用[代码]this.dispatch({type,payload})[代码]调用model.js中的函数,在model.js中直接使用[代码]this.setData({data})[代码]对数据进行变更。
index.html负责视图展现 (view),index.js负责页面逻辑 (controller),model.js负责数据逻辑 (model)。基于“0入侵”的原则,简化了dva的一些概念,尽可能地让经验较少的开发者也能体会到标准MVC编程的快乐。
modelExtend (扩展model)
[代码]import { modelExtend } from '@matrixage/modelExtend'
import model from 'path/to/public_model'
export default modelExtend(model,{
...
})
[代码]
promisifyAll (Promise化wxapi )
在app.js onLaunch函数的第一行执行绑定
[代码]import { promisifyAll } from '@matrixage/moon'
App({
onLaunch () {
promisifyAll(wx, wx.$)
}
})
[代码]
在其他地方直接使用
[代码]try {
await wx.$.requestPayment(data)
} catch ( e ) {
wx.$messageInfo( '支付失败' )
return
}
wx.$messageSuccess( '预约成功' )
//wx.$messageInfo和wx.$messageSuccess是项目中封装的方法
[代码]
typescript使用
小程序使用typescript打包出来的文件有点问题,先暂时手动复制粘贴声明文件
[代码]declare namespace WechatMiniprogram {
interface Wx {
$: any
$set: () => void
$watch: () => void
$getData: object
}
}
interface IModel {
data:object
effects:object
reducers:object
}
declare module '@matrixage/moon'{
export const moon:(wx:any)=>void
export const connect:(page:object,model:object)=>any
export const modelExtend:(page_model:IModel,public_model:IModel)=>IModel
export const promisifyAll:(wx:any,wx$:any)=>void
}
[代码]
理念
moon将始终保持小而美,要保证使用moon不会对现有代码造成任何侵入式破坏.