文档管理中心
ASCF框架API参考框架自定义组件介绍组件生命周期

组件生命周期

组件的生命周期,指的是组件自身的一些方法会在组件生命流程特定的阶段触发。目前支持的生命周期包括 created、attached、ready、detached,具体说明如下:

  • created:组件实例刚刚被创建好时, created 生命周期被触发。
  • attached:在组件完全初始化完毕、进入页面节点树后, attached 生命周期被触发。
  • ready:在 attached 被触发之后触发。
  • detached:在组件离开页面节点树后, detached 生命周期被触发。退出页面时,如果组件还在页面节点树中, detached 也会被触发。

定义生命周期方法

生命周期方法可以直接定义在 Component 构造器的顶层参数中,也可以在 lifetimes 字段内进行声明(推荐这种写法,lifetimes中优先级最高,会覆盖顶层参数中的同名方法)。

示例代码如下:

Component({
  lifetimes: {
    attached: function() {
      // 在组件实例进入页面节点树时执行
    },
    detached: function() {
      // 在组件实例被从页面节点树移除时执行
    },
  },
  // 以下是旧式的定义方式
  created: function() {
    // 在组件实例刚刚被创建时执行
  },
  detached: function() {
    // 在组件实例被从页面节点树移除时执行
  },
  // ...
});

在 behaviors 中也可以编写生命周期方法,同时不会与其他 behaviors 中的同名生命周期相互覆盖。但要注意,如果一个组件多次直接或间接引用同一个 behavior ,这个 behavior 中的生命周期函数在一个执行时机内只会执行一次。

可用的全部生命周期如下表所示。

展开
生命周期 参数 描述
created 在组件实例刚刚被创建时执行。
attached 在组件实例进入页面节点树时执行。
ready 在组件在渲染层布局完成后执行。
detached 在组件实例被从页面节点树移除时执行。

组件所在页面的生命周期

部分情况下组件需要获悉所在页面的状态变化,比如显示、隐藏切换变化等,这时可以使用 pageLifetimes 定义方法监听。这些方法也称为“组件所在页面的生命周期”。

示例代码如下:

Component({
  pageLifetimes: {
    show: function() {
      // 页面显示时触发
    },
    hide: function() {
      // 页面隐藏时触发
    }
  }
});

其中可用的生命周期包括:

展开
生命周期 参数 描述
show 组件所在的页面显示时执行。
hide 组件所在的页面隐藏时执行。
在 ASCF框架 中进行搜索
请输入您想要搜索的关键词