小程序开放平台

文档中心
起步
目录
配置小程序
小程序框架
小程序运行时
自定义组件
自定义组件
组件模板和样式
组件构造器
组件间通信与事件
组件生命周期
组件行为
数据监听器
自定义组件扩展
开发第三方自定义组件
基础能力
开放能力
性能优化
转发
事件回调
基础库
调试
数据分析
服务端调试

组件行为

开发
>
指南
>
自定义组件
>
组件行为
>
更新时间:2024-11-13 19:05:23

behaviors
是用于组件间代码共享的特性,类似于一些编程语言中的 “mixins” 或 “traits”。

每个

behavior
可以包含一组属性、数据、生命周期函数和方法。组件引用它时,它的属性、数据和方法会被合并到组件中,生命周期函数也会在对应时机被调用。 每个组件可以引用多个
behavior
,behavior
也可以引用其它
behavior

组件中使用

组件引用时,在 behaviors 定义段中将它们逐个列出即可。

// my-component.js
var myBehavior = require('my-behavior')
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')
    },
  }
})

在上例中,

my-component
组件定义中加入了
my-behavior

my-behavior
结构为:

  • 属性:myBehaviorProperty
  • 数据字段:myBehaviorData
  • 方法:myBehaviorMethod
  • 生命周期函数:attached、created、ready

这将使

my-component
最终结构为:

  • 属性:myBehaviorProperty、myProperty
  • 数据字段:myBehaviorData、myData
  • 方法:myBehaviorMethod、myMethod
  • 生命周期函数:attached、created、ready

当组件触发生命周期时,上例生命周期函数执行顺序为:

  1. my-behavior created
  2. my-component created
  3. my-behavior attached
  4. my-component attached
  5. my-behavior ready
  6. my-component ready

详细规则参考 同名字段的覆盖和组合规则

同名字段的覆盖和组合规则

组件和它引用的

behavior
中可以包含同名的字段,对这些字段的处理方法如下:

  • 如果有同名的属性 (properties) 或方法 (methods):
    1. 若组件本身有这个属性或方法,则组件的属性或方法会覆盖
      behavior
      中的同名属性或方法;
    2. 若组件本身无这个属性或方法,则在组件的
      behaviors
      字段中定义靠后的
      behavior
      的属性或方法会覆盖靠前的同名属性或方法;
    3. 在 2 的基础上,若存在嵌套引用
      behavior
      的情况,则规则为:父
      behavior
      覆盖 子
      behavior
      中的同名属性或方法。
  • 如果有同名的数据字段 (data):
    • 若同名的数据字段都是对象类型,会进行对象合并;
    • 其余情况会进行数据覆盖,覆盖规则为:组件 > 父
      behavior
      > 子
      behavior
      、 靠后的
      behavior
      > 靠前的
      behavior
      。(优先级高的覆盖优先级低的,最大的为优先级最高)
  • 生命周期函数不会相互覆盖,而是在对应触发时机被逐个调用:
    • 对于不同的生命周期函数之间,遵循组件生命周期函数的执行顺序;
    • 对于同种生命周期函数,遵循如下规则:
      • behavior
        优先于组件执行;
      • behavior
        优先于 父
        behavior
        执行;
      • 靠前的
        behavior
        优先于 靠后的
        behavior
        执行;
    • 如果同一个
      behavior
      被一个组件多次引用,它定义的生命周期函数只会被执行一次。