QQ小程序 QML

2020-07-01 14:34 更新

QML(QQ Markup Language)

是框架設(shè)計的一套標(biāo)簽語言,結(jié)合基礎(chǔ)組件、事件系統(tǒng),可以構(gòu)建出頁面的結(jié)構(gòu)。

::: tip tips:

  • QQ小程序同時兼容WXML標(biāo)簽語言。
  • QML的數(shù)據(jù)綁定,不能使用ECMAScript規(guī)范已經(jīng)規(guī)定的關(guān)鍵字和保留字 ,使用了會提示Unexpected token或者Unexpected token: "tokenName", may be reserved words.的報錯 ::: 用以下一些簡單的例子來看看 QML 具有什么能力:

數(shù)據(jù)綁定

  1. <!--qml-->
  2. <view>{{message}}</view>

  1. // page.js
  2. Page({
  3. data: {
  4. message: 'Hello MINA!'
  5. }
  6. })

列表渲染

  1. <!--qml-->
  2. <view qq:for="{{array}}">{{item}}</view>
  3. // page.js
  4. Page({
  5. data: {
  6. array: [1, 2, 3, 4, 5]
  7. }
  8. })

條件渲染

  1. <!--qml-->
  2. <view qq:if="{{view == 'WEBVIEW'}}">WEBVIEW</view>
  3. <view qq:elif="{{view == 'APP'}}">APP</view>
  4. <view qq:else="{{view == 'MINA'}}">MINA</view>
  5. // page.js
  6. Page({
  7. data: {
  8. view: 'MINA'
  9. }
  10. })

模板

  1. <!--qml-->
  2. <template name="staffName">
  3. <view>
  4. FirstName: {{firstName}}, LastName: {{lastName}}
  5. </view>
  6. </template>
  7. <template is="staffName" data="{{...staffA}}"></template>
  8. <template is="staffName" data="{{...staffB}}"></template>
  9. <template is="staffName" data="{{...staffC}}"></template>
  1. // page.js
  2. Page({
  3. data: {
  4. staffA: {firstName: 'Hulk', lastName: 'Hu'},
  5. staffB: {firstName: 'Shang', lastName: 'You'},
  6. staffC: {firstName: 'Gideon', lastName: 'Lin'}
  7. }
  8. })

事件

  1. <view bindtap="add">{{count}}</view>

  1. Page({
  2. data: {
  3. count: 1
  4. },
  5. add(e) {
  6. this.setData({
  7. count: this.data.count + 1
  8. })
  9. }
  10. })

具體的能力以及使用方式在以下章節(jié)查看: 數(shù)據(jù)綁定、列表渲染、條件渲染、模板、事件、引用

數(shù)據(jù)綁定 QML 中的動態(tài)數(shù)據(jù)均來自對應(yīng) Page 的 data。

簡單綁定

數(shù)據(jù)綁定使用 Mustache 語法(雙大括號)將變量包起來,可以作用于:

內(nèi)容

  1. <view>{{ message }}</view>

  1. Page({
  2. data: {
  3. message: 'Hello MINA!'
  4. }
  5. })

組件屬性(需要在雙引號之內(nèi))

  1. <view id="item-{{id}}"></view>

  1. Page({
  2. data: {
  3. id: 0
  4. }
  5. })

控制屬性(需要在雙引號之內(nèi))

  1. <view qq:if="{{condition}}"></view>

  1. Page({
  2. data: {
  3. condition: true
  4. }
  5. })

關(guān)鍵字(需要在雙引號之內(nèi)) true:boolean 類型的 true,代表真值。 false: boolean 類型的 false,代表假值。

  1. <checkbox checked="{{false}}"></checkbox>

運算

可以在 {{}} 內(nèi)進(jìn)行簡單的運算,支持的有如下幾種方式:

三元運算

  1. <view hidden="{{flag ? true : false}}">Hidden</view>

算數(shù)運算

  1. <view>{{a + b}} + {{c}} + d</view>

  1. Page({
  2. data: {
  3. a: 1,
  4. b: 2,
  5. c: 3
  6. }
  7. })
  8. view中的內(nèi)容為 3 + 3 + d。

邏輯判斷

  1. <view qq:if="{{length > 5}}"></view>

字符串運算

  1. <view>{{"hello" + name}}</view>
  2. 1
  3. 2
  4. Page({
  5. data: {
  6. name: 'MINA'
  7. }
  8. })

  1. 數(shù)據(jù)路徑運算
  2. <view>{{object.key}} {{array[0]}}</view>
  3. Page({
  4. data: {
  5. object: {
  6. key: 'Hello '
  7. },
  8. array: ['MINA']
  9. }
  10. })

組合

也可以在 Mustache 內(nèi)直接進(jìn)行組合,構(gòu)成新的對象或者數(shù)組。

數(shù)組

  1. <view qq:for="{{[zero, 1, 2, 3, 4]}}">{{item}}</view>
  2. Page({
  3. data: {
  4. zero: 0
  5. }
  6. })

最終組合成數(shù)組[0, 1, 2, 3, 4]。

對象

  1. <template is="objectCombine" data="{{for: a, bar: b}}"></template>

  1. Page({
  2. data: {
  3. a: 1,
  4. b: 2
  5. }
  6. })

最終組合成的對象是 {for: 1, bar: 2} 也可以用擴展運算符 ... 來將一個對象展開

  1. <template is="objectCombine" data="{{...obj1, ...obj2, e: 5}}"></template>

  1. Page({
  2. data: {
  3. obj1: {
  4. a: 1,
  5. b: 2
  6. },
  7. obj2: {
  8. c: 3,
  9. d: 4
  10. }
  11. }
  12. })

最終組合成的對象是 {a: 1, b: 2, c: 3, d: 4, e: 5}。 如果對象的 key 和 value 相同,也可以間接地表達(dá)。

  1. <template is="objectCombine" data="{{foo, bar}}"></template>

  1. Page({
  2. data: {
  3. foo: 'my-foo',
  4. bar: 'my-bar'
  5. }
  6. })

最終組合成的對象是 {foo: 'my-foo', bar:'my-bar'}。 注意:上述方式可以隨意組合,但是如有存在變量名相同的情況,后邊的會覆蓋前面,如:

  1. <view qq:for="{{[1,2,3]}} ">
  2. {{item}}
  3. </view>

等同于

  1. <view qq:for="{{[1,2,3] + ' '}}">
  2. {{item}}
  3. </view>

列表渲染

qq:for

在組件上使用 qq:for 控制屬性綁定一個數(shù)組,即可使用數(shù)組中各項的數(shù)據(jù)重復(fù)渲染該組件。 默認(rèn)數(shù)組的當(dāng)前項的下標(biāo)變量名默認(rèn)為 index,數(shù)組當(dāng)前項的變量名默認(rèn)為 item

  1. <view qq:for="{{array}}">
  2. {{index}}: {{item.message}}
  3. </view>

  1. Page({
  2. data: {
  3. array: [{
  4. message: 'foo',
  5. }, {
  6. message: 'bar'
  7. }]
  8. }
  9. })

  1. 使用 qq:for-item 可以指定數(shù)組當(dāng)前元素的變量名,
  2. 使用 qq:for-index 可以指定數(shù)組當(dāng)前下標(biāo)的變量名:
  3. <view qq:for="{{array}}" qq:for-index="idx" qq:for-item="itemName">
  4. {{idx}}: {{itemName.message}}
  5. </view>

  1. qq:for 也可以嵌套,下邊是一個九九乘法表
  2. <view qq:for="{{[1, 2, 3, 4, 5, 6, 7, 8, 9]}}" qq:for-item="i">
  3. <view qq:for="{{[1, 2, 3, 4, 5, 6, 7, 8, 9]}}" qq:for-item="j">
  4. <view qq:if="{{i <= j}}">
  5. {{i}} * {{j}} = {{i * j}}
  6. </view>
  7. </view>
  8. </view>

block qq:for 類似 block qq:if,也可以將 qq:for 用在<block/>標(biāo)簽上,以渲染一個包含多節(jié)點的結(jié)構(gòu)塊。例如:

  1. <block qq:for="{{[1, 2, 3]}}">
  2. <view>{{index}}:</view>
  3. <view>{{item}}</view>
  4. </block>

qq:key

如果列表中項目的位置會動態(tài)改變或者有新的項目添加到列表中,并且希望列表中的項目保持自己的特征和狀態(tài)(如 <input> 中的輸入內(nèi)容,<switch> 的選中狀態(tài)),需要使用 qq:key 來指定列表中項目的唯一的標(biāo)識符。

qq:key 的值以兩種形式提供

  • 字符串,代表在 for 循環(huán)的 array 中 item 的某個 property,該 property 的值需要是列表中唯一的字符串或數(shù)字,且不能動態(tài)改變。
  • 保留關(guān)鍵字 *this 代表在 for 循環(huán)中的 item 本身,這種表示需要 item 本身是一個唯一的字符串或者數(shù)字,如: 當(dāng)數(shù)據(jù)改變觸發(fā)渲染層重新渲染的時候,會校正帶有 key 的組件,框架會確保他們被重新排序,而不是重新創(chuàng)建,以確保使組件保持自身的狀態(tài),并且提高列表渲染時的效率。 如不提供 qq:key,會報一個 warning, 如果明確知道該列表是靜態(tài),或者不必關(guān)注其順序,可以選擇忽略。

示例代碼:

  1. <switch qq:for="{{objectArray}}" qq:key="unique" style="display: block;">
  2. {{item.id}}
  3. </switch>
  4. <button bindtap="switch">Switch</button>
  5. <button bindtap="addToFront">Add to the front</button>
  6. <switch qq:for="{{numberArray}}" qq:key="*this" style="display: block;">
  7. {{item}}
  8. </switch>
  9. <button bindtap="addNumberToFront">Add to the front</button>

  1. Page({
  2. data: {
  3. objectArray: [
  4. {id: 5, unique: 'unique_5'},
  5. {id: 4, unique: 'unique_4'},
  6. {id: 3, unique: 'unique_3'},
  7. {id: 2, unique: 'unique_2'},
  8. {id: 1, unique: 'unique_1'},
  9. {id: 0, unique: 'unique_0'},
  10. ],
  11. numberArray: [1, 2, 3, 4]
  12. },
  13. switch(e) {
  14. const length = this.data.objectArray.length
  15. for (let i = 0; i < length; ++i) {
  16. const x = Math.floor(Math.random() * length)
  17. const y = Math.floor(Math.random() * length)
  18. const temp = this.data.objectArray[x]
  19. this.data.objectArray[x] = this.data.objectArray[y]
  20. this.data.objectArray[y] = temp
  21. }
  22. this.setData({
  23. objectArray: this.data.objectArray
  24. })
  25. },
  26. addToFront(e) {
  27. const length = this.data.objectArray.length
  28. this.data.objectArray = [{id: length, unique: 'unique_' + length}].concat(this.data.objectArray)
  29. this.setData({
  30. objectArray: this.data.objectArray
  31. })
  32. },
  33. addNumberToFront(e) {
  34. this.data.numberArray = [this.data.numberArray.length + 1].concat(this.data.numberArray)
  35. this.setData({
  36. numberArray: this.data.numberArray
  37. })
  38. }
  39. })

注意: 當(dāng) qq:for 的值為字符串時,會將字符串解析成字符串?dāng)?shù)組

  1. <view qq:for="array">
  2. {{item}}
  3. </view>

等同于

  1. <view qq:for="{{['a','r','r','a','y']}}">
  2. {{item}}
  3. </view>

注意: 花括號和引號之間如果有空格,將最終被解析成為字符串

  1. <view qq:for="{{[1,2,3]}} ">
  2. {{item}}
  3. </view>

等同于

  1. <view qq:for="{{[1,2,3] + ' '}}">
  2. {{item}}
  3. </view>

條件渲染

qq:if

在框架中,使用 qq:if="" 來判斷是否需要渲染該代碼塊:

  1. <view qq:if="{{condition}}">True</view>

也可以用 qq:elif 和 qq:else 來添加一個 else 塊:

  1. <view qq:if="{{length > 5}}">1</view>
  2. <view qq:elif="{{length > 2}}">2</view>
  3. <view qq:else>3</view>

block qq:if

因為 qq:if 是一個控制屬性,需要將它添加到一個標(biāo)簽上。如果要一次性判斷多個組件標(biāo)簽,可以使用一個 <block/> 標(biāo)簽將多個組件包裝起來,并在上邊使用 qq:if 控制屬性。

  1. <block qq:if="{{true}}">
  2. <view>view1</view>
  3. <view>view2</view>
  4. </block>

注意: <block/> 并不是一個組件,它僅僅是一個包裝元素,不會在頁面中做任何渲染,只接受控制屬性。

qq:if vs hidden 因為 qq:if 之中的模板也可能包含數(shù)據(jù)綁定,所以當(dāng) qq:if 的條件值切換時,框架有一個局部渲染的過程,因為它會確保條件塊在切換時銷毀或重新渲染。 同時 qq:if 也是惰性的,如果在初始渲染條件為 false,框架什么也不做,在條件第一次變成真的時候才開始局部渲染。 相比之下,hidden 就簡單的多,組件始終會被渲染,只是簡單的控制顯示與隱藏。 一般來說,qq:if 有更高的切換消耗而 hidden 有更高的初始渲染消耗。因此,如果需要頻繁切換的情景下,用 hidden 更好,如果在運行時條件不大可能改變則 qq:if 較好。

模板

QML提供模板(template),可以在模板中定義代碼片段,然后在不同的地方調(diào)用。

定義模板

使用 name 屬性,作為模板的名字。然后在<template/>內(nèi)定義代碼片段,如:

  1. <!--
  2. index: int
  3. msg: string
  4. time: string
  5. -->
  6. <template name="msgItem">
  7. <view>
  8. <text>{{index}}: {{msg}}</text>
  9. <text>Time: {{time}}</text>
  10. </view>
  11. </template>

使用模板 使用 is 屬性,聲明需要的使用的模板,然后將模板所需要的 data 傳入,如:

  1. <template is="msgItem" data="{{...item}}" />

  1. Page({
  2. data: {
  3. item: {
  4. index: 0,
  5. msg: 'this is a template',
  6. time: '2016-09-15'
  7. }
  8. }
  9. })

  1. is 屬性可以使用 Mustache 語法,來動態(tài)決定具體需要渲染哪個模板:
  2. <template name="odd">
  3. <view>odd</view>
  4. </template>
  5. <template name="even">
  6. <view>even</view>
  7. </template>
  8. <block qq:for="{{[1, 2, 3, 4, 5]}}">
  9. <template is="{{item % 2 == 0 ? 'even' : 'odd'}}" />
  10. </block>

模板的作用域

模板擁有自己的作用域,只能使用 data 傳入的數(shù)據(jù)以及模板定義文件中定義的 <qs /> 模塊。

事件

什么是事件

事件是視圖層到邏輯層的通訊方式。 事件可以將用戶的行為反饋到邏輯層進(jìn)行處理。 事件可以綁定在組件上,當(dāng)達(dá)到觸發(fā)事件,就會執(zhí)行邏輯層中對應(yīng)的事件處理函數(shù)。 事件對象可以攜帶額外信息,如 id, dataset, touches。

事件使用的方式

事件的使用方式 在組件中綁定一個事件處理函數(shù)。 如bindtap,當(dāng)用戶點擊該組件的時候會在該頁面對應(yīng)的Page中找到相應(yīng)的事件處理函數(shù)。

  1. <view id="tapTest" data-hi="WeChat" bindtap="tapName">Click me!</view>

在相應(yīng)的Page定義中寫上相應(yīng)的事件處理函數(shù),參數(shù)是

  1. event。
  2. Page({
  3. tapName(event) {
  4. console.log(event)
  5. }
  6. })

  1. 可以看到log出來的信息大致如下:
  2. {
  3. "type": "tap",
  4. "timeStamp": 895,
  5. "target": {
  6. "id": "tapTest",
  7. "dataset": {
  8. "hi": "WeChat"
  9. }
  10. },
  11. "currentTarget": {
  12. "id": "tapTest",
  13. "dataset": {
  14. "hi": "WeChat"
  15. }
  16. },
  17. "detail": {
  18. "x": 53,
  19. "y": 14
  20. },
  21. "touches": [
  22. {
  23. "identifier": 0,
  24. "pageX": 53,
  25. "pageY": 14,
  26. "clientX": 53,
  27. "clientY": 14
  28. }
  29. ],
  30. "changedTouches": [
  31. {
  32. "identifier": 0,
  33. "pageX": 53,
  34. "pageY": 14,
  35. "clientX": 53,
  36. "clientY": 14
  37. }
  38. ]
  39. }

使用QS函數(shù)響應(yīng)事件 QS函數(shù)接受2個參數(shù),第一個是event,在原有的event的基礎(chǔ)上加了event.instance對象,第二個參數(shù)是ownerInstance,和event.instance一樣是一個ComponentDescriptor對象。具體使用如下:

  • 在組件中綁定和注冊事件處理的QS函數(shù)。

  1. <qs module="qs" src="./test.qs"></qs>
  2. <view id="tapTest" data-hi="QQ" bindtap="{{qs.tapName}}">Click me!</view>
  3. **注:綁定的QS函數(shù)必須用{{}}括起來**

test.qs文件實現(xiàn)tapName函數(shù)

  1. function tapName(event, ownerInstance) {
  2. console.log('tap wechat', JSON.stringify(event))
  3. }
  4. module.exports = {
  5. tapName
  6. }

  1. ownerInstance包含了一些方法,可以設(shè)置組件的樣式和class,具體包含的方法以及為什么要用QS函數(shù)響應(yīng)事件,請點擊查看詳情。

事件詳解

事件分類

事件分為冒泡事件和非冒泡事件:

  • 冒泡事件:當(dāng)一個組件上的事件被觸發(fā)后,該事件會向父節(jié)點傳遞。

  • 非冒泡事件:當(dāng)一個組件上的事件被觸發(fā)后,該事件不會向父節(jié)點傳遞。

QML的冒泡事件列表:

類型 觸發(fā)條件
touchstart 手指觸摸動作開始
touchmove 手指觸摸后移動
touchcancel 手指觸摸動作被打斷,如來電提醒,彈窗
touchend 手指觸摸動作結(jié)束
tap 手指觸摸后馬上離開
longpress 手指觸摸后,超過350ms再離開,如果指定了事件回調(diào)函數(shù)并觸發(fā)了這個事件,tap事件將不被觸發(fā)
longtap 手指觸摸后,超過350ms再離開(推薦使用longpress事件代替)
transitionend 會在 QSS transition 或 qq.createAnimation 動畫結(jié)束后觸發(fā)
animationstart 會在一個 QSS animation 動畫開始時觸發(fā)
animationiteration 會在一個 QSS animation 一次迭代結(jié)束時觸發(fā)
animationend 會在一個 QSS animation 動畫完成時觸發(fā)
touchforcechange 在支持 3D Touch 的 iPhone 設(shè)備,重按時會觸發(fā)

注:除上表之外的其他組件自定義事件如無特殊聲明都是非冒泡事件,如<form/>的submit事件,<input/>的input事件,<scroll-view/>的scroll事件,(詳見各個組件)

事件綁定和冒泡

事件綁定的寫法同組件的屬性,以 key、value 的形式。

  • key 以bind或catch開頭,然后跟上事件的類型,如bindtap、catchtouchstart。在非原生組件中,bind和catch后可以緊跟一個冒號,其含義不變,如bind:tap、catch:touchstart。
  • value 是一個字符串,需要在對應(yīng)的 Page 中定義同名的函數(shù)。不然當(dāng)觸發(fā)事件的時候會報錯。 bind事件綁定不會阻止冒泡事件向上冒泡,catch事件綁定可以阻止冒泡事件向上冒泡。 如在下邊這個例子中,點擊 inner view 會先后調(diào)用handleTap3和handleTap2(因為tap事件會冒泡到 middle view,而 middle view 阻止了 tap 事件冒泡,不再向父節(jié)點傳遞),點擊 middle view 會觸發(fā)handleTap2,點擊 outer view 會觸發(fā)handleTap1。

  1. <view id="outer" bindtap="handleTap1">
  2. outer view
  3. <view id="middle" catchtap="handleTap2">
  4. middle view
  5. <view id="inner" bindtap="handleTap3">
  6. inner view
  7. </view>
  8. </view>
  9. </view>

事件的捕獲階段

觸摸類事件支持捕獲階段。捕獲階段位于冒泡階段之前,且在捕獲階段中,事件到達(dá)節(jié)點的順序與冒泡階段恰好相反。需要在捕獲階段監(jiān)聽事件時,可以采用capture-bind、capture-catch關(guān)鍵字,后者將中斷捕獲階段和取消冒泡階段。 在下面的代碼中,點擊 inner view 會先后調(diào)用handleTap2、handleTap4、handleTap3、handleTap1。

  1. <view
  2. id="outer"
  3. bind:touchstart="handleTap1"
  4. capture-bind:touchstart="handleTap2"
  5. >
  6. outer view
  7. <view
  8. id="inner"
  9. bind:touchstart="handleTap3"
  10. capture-bind:touchstart="handleTap4"
  11. >
  12. inner view
  13. </view>
  14. </view>

如果將上面代碼中的第一個capture-bind改為capture-catch,將只觸發(fā)handleTap2。

  1. <view
  2. id="outer"
  3. bind:touchstart="handleTap1"
  4. capture-catch:touchstart="handleTap2"
  5. >
  6. outer view
  7. <view
  8. id="inner"
  9. bind:touchstart="handleTap3"
  10. capture-bind:touchstart="handleTap4"
  11. >
  12. inner view
  13. </view>
  14. </view>

事件對象

如無特殊說明,當(dāng)組件觸發(fā)事件時,邏輯層綁定該事件的處理函數(shù)會收到一個事件對象。 BaseEvent 基礎(chǔ)事件對象屬性列表:

屬性 類型 說明
type String 事件類型
timeStamp Integer 事件生成時的時間戳
target Object 觸發(fā)事件的組件的一些屬性值集合
currentTarget Object 當(dāng)前組件的一些屬性值集合

CustomEvent 自定義事件對象屬性列表(繼承 BaseEvent):

屬性 類型 說明
detail Object 額外的信息

TouchEvent 觸摸事件對象屬性列表(繼承 BaseEvent):

屬性 類型 說明
touches Array 觸摸事件,當(dāng)前停留在屏幕中的觸摸點信息的數(shù)組
changedTouches Array 觸摸事件,當(dāng)前變化的觸摸點信息的數(shù)組

特殊事件: <canvas> 中的觸摸事件不可冒泡,所以沒有 currentTarget。

type

代表事件的類型。

timeStamp

頁面打開到觸發(fā)事件所經(jīng)過的毫秒數(shù)。

target

target 觸發(fā)事件的源組件。

屬性 類型 說明
id String 事件源組件的id
tagName String 當(dāng)前組件的類型
dataset Object 事件源組件上由data-開頭的自定義屬性組成的集合

currentTarget事件綁定的當(dāng)前組件。

屬性 類型 說明
id String 當(dāng)前組件的id
tagName String 當(dāng)前組件的類型
dataset Object 當(dāng)前組件上由data-開頭的自定義屬性組成的集合

說明: target 和 currentTarget 可以參考上例中,點擊 inner view 時,handleTap3 收到的事件對象 target 和 currentTarget 都是 inner,而 handleTap2 收到的事件對象 target 就是 inner,currentTarget 就是 middle。

dataset

在組件中可以定義數(shù)據(jù),這些數(shù)據(jù)將會通過事件傳遞給 SERVICE。 書寫方式: 以data-開頭,多個單詞由連字符-鏈接,不能有大寫(大寫會自動轉(zhuǎn)成小寫)如data-element-type,最終在 event.currentTarget.dataset 中會將連字符轉(zhuǎn)成駝峰elementType。 示例:

  1. <view data-alpha-beta="1" data-alphaBeta="2" bindtap="bindViewTap">
  2. DataSet Test
  3. </view>

  1. Page({
  2. bindViewTap(event) {
  3. event.currentTarget.dataset.alphaBeta === 1 // - 會轉(zhuǎn)為駝峰寫法
  4. event.currentTarget.dataset.alphabeta === 2 // 大寫會轉(zhuǎn)為小寫
  5. }
  6. })

touches

touches 是一個數(shù)組,每個元素為一個 Touch 對象(canvas 觸摸事件中攜帶的 touches 是 CanvasTouch 數(shù)組)。 表示當(dāng)前停留在屏幕上的觸摸點。

Touch 對象

屬性 類型 說明
identifier Number 觸摸點的標(biāo)識符
pageX, pageY Number 距離文檔左上角的距離,文檔的左上角為原點 ,橫向為X軸,縱向為Y軸
clientX, clientY Number 距離頁面可顯示區(qū)域(屏幕除去導(dǎo)航條)左上角距離,橫向為X軸,縱向為Y軸

CanvasTouch 對象

屬性 類型 說明
identifier Number 觸摸點的標(biāo)識符
x, y Number 距離 Canvas 左上角的距離,Canvas 的左上角為原點 ,橫向為X軸,縱向為Y軸

changedTouches

changedTouches 數(shù)據(jù)格式同 touches。 表示有變化的觸摸點,如從無變有(touchstart),位置變化(touchmove),從有變無(touchend、touchcancel)。

detail

自定義事件所攜帶的數(shù)據(jù),如表單組件的提交事件會攜帶用戶的輸入,媒體的錯誤事件會攜帶錯誤信息。 點擊事件的detail 帶有的 x, y 同 pageX, pageY 代表距離文檔左上角的距離。

QS響應(yīng)事件

背景 有頻繁用戶交互的效果在小程序上表現(xiàn)是比較卡頓的,例如頁面有 2 個元素 A 和 B,用戶在 A 上做 touchmove 手勢,要求 B 也跟隨移動,<movable-view> 就是一個典型的例子。一次 touchmove 事件的響應(yīng)過程為: a、touchmove 事件從視圖層(Webview)拋到邏輯層(App Service) b、邏輯層(App Service)處理 touchmove 事件,再通過 setData 來改變 B 的位置 一次 touchmove 的響應(yīng)需要經(jīng)過 2 次的邏輯層和渲染層的通信以及一次渲染,通信的耗時比較大。此外 setData 渲染也會阻塞其它腳本執(zhí)行,導(dǎo)致了整個用戶交互的動畫過程會有延遲。

實現(xiàn)方案

本方案基本的思路是減少通信的次數(shù),讓事件在視圖層(Webview)響應(yīng)。小程序的框架分為視圖層(Webview)和邏輯層(App Service),這樣分層的目的是管控,開發(fā)者的代碼只能運行在邏輯層(App Service),而這個思路就必須要讓開發(fā)者的代碼運行在視圖層(Webview)。

使用 QS 函數(shù)用來響應(yīng)小程序事件,目前只能響應(yīng)內(nèi)置組件的事件,不支持自定義組件事件。

QS 函數(shù)的除了純邏輯的運算,還可以通過封裝好的ComponentDescriptor 實例來訪問以及設(shè)置組件的 class 和樣式,對于交互動畫,設(shè)置 style 和 class 足夠了。QS 函數(shù)的例子如下:

  1. const qsFunction = function (event, ownerInstance) {
  2. const instance = ownerInstance.selectComponent('.classSelector') // 返回組件的實例
  3. instance.setStyle({
  4. 'font-size': '14px' // 支持rpx
  5. })
  6. instance.getDataset()
  7. instance.setClass(className)
  8. // ...
  9. return false // 不往上冒泡,相當(dāng)于調(diào)用了同時調(diào)用了stopPropagation和preventDefault
  10. }
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號