微信小程序 behaviors
一 、什么是 behaviors
behaviors 是用于组件间代码共享的特性,类似于一些编程语言中的 “mixins” 或 “traits”。
每个 behavior 可以包含一组属性、数据、生命周期函数和方法。组件引用它时,它的属性、数据和方法会被合并到组件中,生命周期函数也会在对应时机被调用。 每个组件可以引用多个 behavior ,behavior 也可以引用其它 behavior 。
二、 创建 behavior
// my-behavior.js
// 调用 Behavior(Object object) 方法即可创建一个共享的 behavior 实例对象,供所有的组件使用。
// 调用 Behavior() 方法,创建实例对象
// 并使用 module.exports 将 behavior 实例对象共享出去
module.exports = Behavior({
// behaviors 是用于组件间代码共享的特性,类似于一些编程语言中的 “mixins” 或 “traits”。
// 每个 behavior 可以包含一组属性、数据、生命周期函数和方法。
// 组件引用它时,它的属性、数据和方法会被合并到组件中,生命周期函数也会在对应时机被调用。
// 每个组件可以引用多个 behavior ,behavior 也可以引用其它 behavior
behaviors: [],
// 属性节点
properties: {
myBehaviorProperty: {
type: String
}
},
// 私有数据节点
// 组件的内部数据,和 properties 一同用于组件的模板渲染
data: {
myBehaviorData: 'my-behavior-data'
},
// 组件生命周期函数 - 在组件实例刚刚被创建时执行,注意此时不能调用 setData )
created: function () {
console.log('[my-behavior] created')
},
// 组件生命周期函数 - 在组件实例进入页面节点树时执行)
attached: function () {
console.log('[my-behavior] attached')
},
// 组件生命周期函数 - 在组件布局完成后执行)
ready: function () {
console.log('[my-behavior] ready')
},
// 事件处理函数和自定义方法节点
methods: {
myBehaviorMethod: function () {
console.log('[my-behavior] log by myBehaviorMehtod')
},
}
})
三、组件中导入并使用 behavior
// my-component.js
// 1、使用 require() 导入需要的自定义 behavior 模块
var myBehavior = require('my-behavior')
// 2 将导入的 behavior 实例对象,挂载到 behaviors 数组节点中,即可生效
Component({
behaviors: [myBehavior],
properties: {
myProperty: {
type: String
}
},
data: {
myData: 'my-component-data'
},
// 在组件实例刚刚被创建时执行
created: function () {
console.log('[my-component] created')
},
// 在组件实例进入页面节点树时执行
attached: function () {
console.log('[my-component] attached')
},
// 在组件在视图层布局完成后执行
ready: function () {
console.log('[my-component] ready')
},
methods: {
myMethod: function () {
console.log('[my-component] log by myMethod')
},
}
})
// 对于不同的生命周期函数之间,遵循组件生命周期函数的执行顺序;
// 对于同种生命周期函数和同字段 observers ,遵循如下规则:
// behavior 优先于组件执行;
// 被引用的 behavior 优先于 引用者 behavior 执行;
// 靠前的 behavior 优先于 靠后的 behavior 执行;
// 如果同一个 behavior 被一个组件多次引用,它定义的生命周期函数和 observers 不会重复执行。
在上例中, my-component 组件定义中加入了 my-behavior,
而 my-behavior 结构为:
- 属性:myBehaviorProperty
- 数据字段:myBehaviorData
- 方法:myBehaviorMethod
- 生命周期函数:attached、created、ready
这将使 my-component 最终结构为:
- 属性:myBehaviorProperty、myProperty
- 数据字段:myBehaviorData、myData
- 方法:myBehaviorMethod、myMethod
- 生命周期函数:attached、created、ready
当组件触发生命周期时,上例生命周期函数执行顺序为:
- [my-behavior] created
- [my-component] created
- [my-behavior] attached
- [my-component] attached
- [my-behavior] ready
- [my-component] ready
四、同名字段的覆盖和组合规则
组件和它引用的 behavior 中可以包含同名的字段,对这些字段的处理方法如下:
-
如果有同名的属性 (properties) 或方法 (methods):
1、 若组件本身有这个属性或方法,则组件的属性或方法会覆盖 behavior 中的同名属性或方法;
2、 若组件本身无这个属性或方法,则在组件的 behaviors 字段中定义靠后的 behavior 的属性或方法会覆盖靠前的同名属性或方法;
3、 在 2 的基础上,若存在嵌套引用 behavior 的情况,则规则为:引用者 behavior 覆盖 被引用的 behavior 中的同名属性或方法。 -
如果有同名的数据字段 (data):
- 若同名的数据字段都是对象类型,会进行对象合并;
- 其余情况会进行数据覆盖,覆盖规则为: 引用者 behavior > 被引用的 behavior 、 靠后的 behavior > 靠前的 behavior。(优先级高的覆盖优先级低的,最大的为优先级最高)
-
生命周期函数和 observers 不会相互覆盖,而是在对应触发时机被逐个调用:
- 对于不同的生命周期函数之间,遵循组件生命周期函数的执行顺序;
- 对于同种生命周期函数和同字段 observers ,遵循如下规则:
- behavior 优先于组件执行;
- 被引用的 behavior 优先于 引用者 behavior 执行;
- 靠前的 behavior 优先于 靠后的 behavior 执行;
-
如果同一个 behavior 被一个组件多次引用,它定义的生命周期函数和 observers 不会重复执行。