支付寶小程序框架 事件·對(duì)象

組件觸發(fā)事件時(shí)，邏輯層綁定該事件的處理函數(shù)會(huì)收到一個(gè)事件對(duì)象。

BaseEvent 基礎(chǔ)事件

BaseEvent 基礎(chǔ)事件對(duì)象屬性列表：

type

事件的類(lèi)型。

timeStamp

事件生成時(shí)的時(shí)間戳。

target

dataset 在組件中可以定義數(shù)據(jù)，這些數(shù)據(jù)將會(huì)通過(guò)事件傳遞給邏輯層。 以 data- 開(kāi)頭，由連字符 -連接多個(gè)單詞，所有字母必須小寫(xiě)，如 data-element-type，最終會(huì)在 event.target.dataset中會(huì)將連字符轉(zhuǎn)成駝峰 elementType。

示例代碼：

<view data-alpha-beta="1"  onTap="bindViewTap"> DataSet Test </view>
Page({
  bindViewTap:function(event) {
    event.target.dataset.alphaBeta === 1; // - 會(huì)轉(zhuǎn)為駝峰寫(xiě)法
  },
});

觸發(fā)事件的源組件對(duì)象，屬性列表如下：

CustomEvent 自定義事件對(duì)象

CustomEvent 自定義事件對(duì)象（繼承自 BaseEvent），屬性列表如下：

detail

自定義事件所攜帶的數(shù)據(jù)。表單組件事件會(huì)攜帶用戶(hù)的輸入信息，如 switch 組件 onChange 觸發(fā)時(shí)可通過(guò) event.detail.value 獲取用戶(hù)選擇的狀態(tài)值，媒體的錯(cuò)誤事件會(huì)攜帶錯(cuò)誤信息，更多信息請(qǐng)參見(jiàn)各組件文檔事件說(shuō)明。

TouchEvent 觸摸事件對(duì)象

TouchEvent 觸摸事件對(duì)象（繼承自 BaseEvent），屬性列表：

touches 是一個(gè)數(shù)組，每個(gè)元素為一個(gè) Touch 對(duì)象（ canvas 觸摸事件中攜帶的 touches 是 CanvasTouch 的數(shù)組），表示當(dāng)前停留在屏幕上的觸摸點(diǎn)。

changedTouches 數(shù)據(jù)格式同 touches。 表示有變化的觸摸點(diǎn)，如從無(wú)變有（touchstart），位置變化（touchmove），從有變無(wú)（touchend、touchcancel）。

Touch 對(duì)象

CanvasTouch 對(duì)象

示例

如 touchmove 事件，當(dāng)用戶(hù)觸摸下例的組件。

<view class="move-view" onTouchMove="touchMoveHandle">
</view>

頁(yè)面中響應(yīng)事件的處理函數(shù) touchMoveHandle 會(huì)被調(diào)用，TouchEvent 觸摸事件對(duì)象將作為參數(shù)傳入。

Page({
  touchMoveHandle(e){
    console.log(e)
  }
});

下面是打印的 TouchEvent 對(duì)象的信息：

{
  "type": "touchMove",
  "timeStamp": 1562241425847,
  "target": {
    "targetDataset": {},
    "tagName": "view",
    "dataset": {},
    "offsetLeft": 0,
    "offsetTop": 0
  },
  "currentTarget": {
    "tagName": "view",
    "dataset": {},
    "offsetLeft": 0,
    "offsetTop": 0
  },
  "touches": [
    {
      "clientX": 49.69140625,
      "clientY": 54.1640625,
      "identifier": 0,
      "pageX": 49.69140625,
      "pageY": 54.1640625
    }
  ],
  "changedTouches": [
    {
      "clientX": 49.69140625,
      "clientY": 54.1640625,
      "identifier": 0,
      "pageX": 49.69140625,
      "pageY": 54.1640625
    }
  ]
}