小程序开放平台

文档中心
小组件配置
框架接口
小组件App
页面
自定义组件
Component
Behavior
模块化
基础功能
XHSML 语法参考

Behavior

开发
>
框架
>
框架接口
>
自定义组件
>
Behavior
>
更新时间:2025-08-04 16:00:12

Behavior

注册一个 behavior,接受一个 Object 类型的参数

属性
类型
默认值
必填
说明
dataobject组件的内部数据,和 properties 一同用于组件的模板渲染
methodsobject组件的方法,包括事件响应函数和任意的自定义方法
behaviorsarray引入其它的 behavior
createdobject组件生命周期函数-在组件实例刚刚被创建时执行,注意此时不能调用 setData
attachedobject组件生命周期函数-在组件实例进入页面节点树时执行
readyobject组件生命周期函数-在组件布局完成后执行
detachedobject组件生命周期函数-在组件实例被从页面节点树移除时执行

示例代码

// your-behavior.js

module.exports = Behavior({
  name: 'behavior1',
  behaviors: [],
  properties: {},
  data: {
    from: 'name',
  },
  methods: {
    handleClick() {
      console.log('hello');
    }
  }
})

properties 定义

定义段
类型
是否必填
描述
type-属性的类型
value-Object
observerFunction属性值变化时的回调函数

示例代码:

module.exports = Behavior({
  properties: {
    min: {
      type: Number,
      value: 0
    }
  }
})

data

behavior 中的

data
properties
会合并到组件的
data
properties
当中 可通过
this.data
进行访问,调用
this.setData
方法进行更改,并触发组件的重新渲染。

与组件相同, 无法调用

this.setData
方法修改
properties
, 修改 props 属性会抛出错误

示例代码:

<view>{{name}}</view>
<view>{{parentName}}</view>
const behavior = require('./your-behavior');

Component({
  behaviors: [behavior],
  properties: {
    parentName: {
      type: String,
      value: 0
    }
  },
  lifetimes: {
    ready() {
      this.handleClick(); // console.log('hello')
    }
  },
  data: {
    name: 'hello',
  },
  methods: {
    changeName() {
      this.setData({
        name: "world"
      })
    }
  }
})


behavior 的行为

同自定义组件, 但遵循以下覆盖规则:

组件和它引用的

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

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