原生小程序开发中我们可以通过 mobx-miniprogram 配合 mobx-miniprogram-bindings 实现全局数据共享。二者为外部依赖,我们需要npm或yarn去安装构建相关依赖,才能正常使用.
npm安装及其注意事项
小程序对 npm 的支持与限制
在小程序中已经支持使用 npm 安装第三方包,从而来提高小程序的开发效率。
- 但是小程序中使用npm 包有如下5个限制:
- 只支持纯 js 包,不支持自定义组件,不支持依赖于 Node.js 内置库的包
- 必须有入口文件,即需要保证 package.json 中的 main 字段是指向一个正确的入口,如果 package.json 中没有 main 字段,则以 npm 包根目录下的 index.js 作为入口文件。
- 测试、构建相关的依赖请放入 devDependencies 字段中避免被一起打包到小程序包中,这一点和小程序 npm 包的要求相同。
- 不支持依赖 c++ 插件的包
- 小程序环境比较特殊,一些全局变量(如 window 对象)和构造器(如 Function 构造器)是无法使用的。
- 【javascript|微信小程序--数据共享与方法共享】初始化小程序生成package.json
npm init -y
- 安装 npm 包
在小程序 package.json 所在的目录中执行命令安装 npm 包:
npm install pageName
此处要求参与构建 npm 的 package.json 需要在 project.config.js 定义的 miniprogramRoot 之内。
- 构建 npm
点击开发者工具中的菜单栏:工具 --> 构建 npm
文章图片
- 勾选“使用 npm 模块”选项:
文章图片
- 构建完成后即可使用 npm 包。
js 中引入 npm 包:
const myPackage = require('packageName') const packageOther = require('packageName/other')
使用 npm 包中的自定义组件:
{ "usingComponents": { "myPackage": "packageName", "package-other": "packageName/other" } }
1. 全局数据共享
- 共享数据是指多个进程都可以访问的数据,而全局变量是一个进程内的多个单元可共享的数据。
- 解决组件之间数据共享的问题。
- 开发中常用的全局数据共享方案有:Vuex、Redux、MobX、hooks等。
- mobx-miniprogram: 用来创建 Store 实例对象
- mobx-miniprogram-bindings: 用来把 Store 中的共享数据或方法,绑定到组件或页面中使用
- 安装 MobX 相关的包
在项目中运行如下的命令,安装 MobX 相关的包:npm i -S mobx-miniprogram mobx-miniprogram-bindings
2. 创建 MobX 的 Store 实例
```
import {observable ,action} from 'mobx-miniprogram'
export const store=observable({
num1:1,
num2:2,get sum(){
return this.num1+this.num2
},updateNum1:action(function(step){
this.num1+=tep
})
})
```
- 将 Store 中的成员绑定到页面中
import { createStoreBindings } from 'mobx-miniprogram-bindings' import { store } from '../../store/store'Page({data: {}, onLoad: function (options) { this.storeBindings = createStoreBindings(this, { store, fields: ['num1', 'num2', 'sum'], actions: ['updateNum1'] }) },btnHandler1(e) {this.updateNum1(e.target.dataset.step) },onUnload: function () { this.storeBindings.detroyStoreBindings() } })
- 将 Store 中的成员绑定到组件中
- 通过storeBindingsBehavior实现自动绑定
- store:指定要绑定的store
- fields:置顶绑定的数据字段
- 绑定字段方式一:
numA:()=>store.num1
- 绑定字段方式二:
numA:(store)=>store.num1
- 绑定字段方式三:
numA:'num1'
- 绑定字段方式一:
- actions:指定要绑定的方法
import { storeBindingsBehavior } from 'mobx-miniprogram-bindings' import { store } from '../../store/store' Component({ behaviors: [storeBindingsBehavior], storeBindings: { // 数据源 store, fields: { numA: 'num1', numB: 'num2', sum: 'sum' }, actions: { updateNum2: 'updateNum2' } }, })
behaviors 是小程序中,用于实现组件间代码共享的特性,类似于 Vue.js 中的 “mixins”。
2. behaviors 的工作方式
每个 behavior 可以包含一组属性、数据、生命周期函数和方法。组件引用它时,它的属性、数据和方法会被
合并到组件中。
每个组件可以引用多个 behavior,behavior 也可以引用其它 behavior。
3. 创建 behavior
调用 Behavior(Object object) 方法即可创建一个共享的 behavior 实例对象,供所有的组件使用:
/*
调用Behavior()方法,创建对象实例
使用module.exports讲behevior 实例对象共享出去
*/
module.exports = Behavior({
// 属性节点
properties: {},
// 私有数据节点
data: {},
// 事件处理函数和自定义方法节点
methods: {}
})
4. 导入并使用 behavior
在组件中,使用 require() 方法导入需要的 behavior,挂载后即可访问 behavior 中的数据或方法,示例代码
// components/test5/test5.js
const myBehavior = require('../../behaviors/my-behavior')Component({
behaviors: [myBehavior],
/**
* 组件的属性列表
*/
properties: {
count: Number
},
})
5. behavior 中所有可用的节点
可用的节点 | 类型 | 是否必填 | 描述 |
---|---|---|---|
properties | Object Map | 否 | 同组件的属性 |
data | Object | 否 | 同组件的数据 |
methods | Object | 否 | 同自定义组件的方法 |
behaviors | String Array | 否 | 引入其它的 behavior |
created | Function | 否 | 生命周期函数 |
attached | Function | 否 | 生命周期函数 |
ready | Function | 否 | 生命周期函数 |
moved | Function | 否 | 生命周期函数 |
detached | Function | 否 | 生命周期函数 |
组件和它引用的 behavior 中可以包含同名的字段,此时可以参考如下 3 种同名时的处理规则:
① 同名的数据字段 (data)
② 同名的属性 (properties) 或方法 (methods)
③ 同名的生命周期函数
如果有同名的数据字段 (data):
- 若同名的数据字段都是对象类型,会进行对象合并;
- 其余情况会进行数据覆盖,覆盖规则为:组件 > 父 behavior > 子 behavior 、 靠后的 behavior > 靠前的 behavior。(优先级高的覆盖优先级低的,最大的为优先级最高)
- 若组件本身有这个属性或方法,则组件的属性或方法会覆盖 behavior 中的同名属性或方法;
- 若组件本身无这个属性或方法,则在组件的 behaviors 字段中定义靠后的 behavior 的属性或方法会覆盖靠前的同名属性或方法;
- 在 2 的基础上,若存在嵌套引用 behavior 的情况,则规则为:父 behavior 覆盖 子 behavior 中的同名属性或方法。
- 对于不同的生命周期函数之间,遵循组件生命周期函数的执行顺序;
- 对于同种生命周期函数,遵循如下规则:
- behavior 优先于组件执行;
- 子 behavior 优先于 父 behavior 执行;
- 靠前的 behavior 优先于 靠后的 behavior 执行;
- 如果同一个 behavior 被一个组件多次引用,它定义的生命周期函数只会被执行一次。
如果你觉得本文对你有帮助,麻烦点赞关注支持一下
推荐阅读
- 微信小程序|微信小程序自定义标签组件component封装、组件生命周期,组件通信
- vue|vue3快速上手(尚硅谷视频笔记)
- VUE|基于vue2快速上手vue3
- react.js|React批处理原理及性能优化实践
- 学习|JSX基本使用
- react|封装一个处理 react 异常的最简 ErrorBoundary 组件
- React|React 错误边界之 react-error-boundary
- php|HTML及CSS学习笔记
- 前端|对请求,响应和前后端生命周期的理解。