ジェスチャイベントとしてあたらしく追加されたイベントは次の4種類(Cross-Device Gesture Supportより)。
- flick … フリック
- gesturemovestart … ドラッグ/タッチ開始
- gesturemove … ドラッグ/タッチ中
- gesturemoveend … ドラッグ/タッチ終了
ジェスチャイベント - flick
flick
flickイベントを設定する。イベント実行にあたり、最小の距離/速度を指定できる。
flick ( type , fn , cfg )
- type <string> : "flick"固定
- fn <function> : イベント発生時に実行する関数を指定
- cfg <Object> : 動作オプション
プロパティ | 説明 |
---|---|
minDistance | フリックとみなす最小距離をピクセルで指定。デフォルト値は10 |
minVelocity | フリックとみなす最小速度をピクセル/msで指定。デフォルト値は0 |
preventDefault | フリック時にデフォルトの動作であるテキスト選択を無効にするか否かをboolで指定。デフォルト値はfalse |
axis | フリック入力をX/Y方向どちらかに限定したい場合に指定。デフォルト値はなし |
flickイベントを使用する場合は、事前にevent-flickモジュールをインクルードする必要がある。
ジェスチャイベント - move
gesturemovestart
gesturemovestartイベントを設定する。タッチデバイスではtouchstartイベントを、マウスベースのデバイスではmousedownイベントを呼び出す。イベント実行にあたり、最小の距離/時間を指定できる。
gesturemovestart ( type , fn , cfg )
- type <string> … "gesturemovestart"固定
- fn <function> … イベント発生時に実行する関数を指定
- cfg <Object> … 動作オプション
プロパティ | 説明 |
---|---|
minDistance | ジェスチャ開始とみなす最小距離を指定。デフォルト値は0 |
minTime | ジェスチャ開始とみなす最小時間を指定。デフォルト値は0 |
button | マウスベースのデバイスにおいて、特定のボタンに対してだけジェスチャとみなしたい場合に使用。デフォルト値はなし |
preventDefault | ジェスチャ時にデフォルトの動作であるテキスト選択やコンテキストのポップアップを無効にするか否かをboolで指定。デフォルト値はfalse |
gesturemove
gesturemoveイベントを設定する。タッチデバイスではtouchmoveイベントを、マウスベースのデバイスではmousemoveイベントを呼び出す。このイベントはおなじノードがgesturemovestartイベントを受け取ったときにだけ呼び出される。standAloneプロパティがtrueの場合、gesturemovestartイベントなしでも発行できるようになる。
gesturemove ( type , fn , cfg )
- type <string> … "gesturemove"固定
- fn <function> … イベント発生時に実行する関数を指定
- cfg <Object> … 動作オプション
プロパティ | 説明 |
---|---|
standAlone | trueの場合、gesturemovestartイベントの実行に関係なく発行できるようになる。デフォルト値はfalse |
root | アタッチするノードを指定。デフォルト値はdocument |
preventDefault | ジェスチャ時にデフォルトの動作を無効にするか否かをboolで指定。デフォルト値はfalse |
gesturemoveend
gesturemoveendイベントを設定する。タッチデバイスではtouchendイベントを、マウスベースのデバイスではmouseupイベントを呼び出す。このイベントはおなじノードがgesturemoveまたはgesturemovestartイベントを受け取ったときにだけ呼び出される。standAloneプロパティがtrueの場合、これらのイベントなしでも発行できるようになる。
gesturemoveend ( type , fn , cfg )
- type <string> … "gesturemoveend"固定
- fn <function> … イベント発生時に実行する関数を指定
- cfg <Object> … 動作オプション
プロパティ | 説明 |
---|---|
standAlone | trueの場合、gesturemovestart/gesturemoveイベントの実行に関係なく発行できるようになる。デフォルト値はfalse |
root | アタッチするノードを指定。デフォルト値はdocument |
preventDefault | ジェスチャ時にデフォルトの動作を無効にするか否かをboolで指定。デフォルト値はfalse |
gesturemovestart、gesturemove、gesturemoveendイベントを使用する場合は、事前にevent-moveをインクルードする必要がある。