Experiment Feature
Weex encapsulates native touch events to provide a gesture system. Using gesture is similar to use event in Weex. Just set on
attributes on a node to listen to gesture.
For now, there are four types of gestures:
touchstart
will be fired when a touch point is placed on the touch surface.touchmove
will be fired when a touch point is moved along the touch surface.touchend
will be fired when a touch point is removed from the touch surface.panstart
panmove
panend
The Touch gesture and Pan is very close to each other, with following features hold:
Users may choose their gesture according to their situation.
The following properties can be used in gesture callback:
direction
. Only exists for Swipe gesture. Indicate the direcion of the swipe, choose from up
, left
, bottom
, right
.changedTouches
. An array of motion for every touch pointer that has contribute to the current gesture.changedTouches
is an array, with the following properties in its children:
identifier
. A unique identifier for a touch pointer.pageX
. The X coordinate of the touch pointer relative to the left edge of the document.pageY
. The Y coordinate of the touch pointer relative to the top of the document.screenX
. The X coordinate of the touch point relative to the left edge of the screen.screenY
. The Y coordinate of the touch point relative to the top edge of the screen.Currently, Weex Android do not support listening to gesture on scroller
, list
and webview
, as it would lead a large amount of event conflicting.
Example:
<template> <div ontouchstart="handleTouchstart"></div> </template> <script> module.exports = { methods: { handleTouchstart: function(eventProperties) { // handling with the Event Properties } } } </script>
With the code above, a touchstart
event will be fired when a touch point is placed on the touch surface.