組件事件

事件系統是組件間交互的主要形式。自定義組件可以觸發任意的事件，引用組件的頁面可以監聽這些事件。關于事件的基本概念和用法。

監聽自定義組件事件的方法與監聽基礎組件事件的方法完全一致：

代碼示例：

<!-- 當自定義組件觸發“myevent”事件時，調用“onMyEvent”方法 -->
<component-tag-name bindmyevent="onMyEvent" />
<!-- 或者可以寫成 -->
<component-tag-name bind:myevent="onMyEvent" />

Page({
  onMyEvent: function(e){
    e.detail // 自定義組件觸發事件時提供的detail對象
  }
})

自定義組件觸發事件時，需要使用 triggerEvent 方法，指定事件名、detail對象和事件選項：

代碼示例：

<!-- 在自定義組件中 -->
<button bindtap="onTap">點擊這個按鈕將觸發“myevent”事件</button>

Component({
  properties: {}
  methods: {
    onTap: function(){
      var myEventDetail = {} // detail對象，提供給事件監聽函數
      var myEventOption = {} // 觸發事件的選項
      this.triggerEvent('myevent', myEventDetail, myEventOption)
    }
  }
})

觸發事件的選項包括：

關于冒泡和捕獲階段的概念，請閱讀 事件 章節中的相關說明。

代碼示例：

// 頁面 page.wxml
<another-component bindcustomevent="pageEventListener1">
  <my-component bindcustomevent="pageEventListener2"></my-component>
</another-component>

// 組件 another-component.wxml
<view bindcustomevent="anotherEventListener">
  <slot />
</view>

// 組件 my-component.wxml
<view bindcustomevent="myEventListener">
  <slot />
</view>

// 組件 my-component.js
Component({
  methods: {
    onTap: function(){
      this.triggerEvent('customevent', {}) // 只會觸發 pageEventListener2
      this.triggerEvent('customevent', {}, { bubbles: true }) // 會依次觸發 pageEventListener2 、 pageEventListener1
      this.triggerEvent('customevent', {}, { bubbles: true, composed: true }) // 會依次觸發 pageEventListener2 、 anotherEventListener 、 pageEventListener1
    }
  }
})