Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The MSGestureEvent
is a proprietary interface specific to Internet Explorer and Microsoft Edge which represents events that occur due to touch gestures. Events using this interface include MSGestureStart
, MSGestureEnd
, MSGestureTap
, MSGestureHold
, MSGestureChange
, and MSInertiaStart
.
MSGestureEvent
derives from UIEvent
, which in turn derives from Event
. Though the MSGestureEvent.initGestureEvent()
method is kept for backward compatibility, the creation of an MSGestureEvent
object should be done using the MSGestureEvent()
constructor.
Constructor
MSGestureEvent()
- Creates an
MSGestureEvent
object.
Properties
This interface also inherits properties of its parents, UIEvent
and Event
.
MSGestureEvent.expansion
Read only- The diameter of the gesture area. For example, the distance between fingers.
MSGestureEvent.gestureObject
Read only- Returns the
MSGesture
object for this gesture event. MSGestureEvent.rotation
Read only- Amount of rotation (in radians) since the previous
MSGestureEvent
of the current gesture. Positive values indicate clockwise rotation; negative values indicate anticlockwise rotation. MSGestureEvent.scale
Read only- The difference in scale (for zoom gestures) from the previous
MSGestureEvent
of the current gesture. MSGestureEvent.translationX
Read only- Distance traversed along the X-axis since the previous
MSGestureEvent
of the current gesture MSGestureEvent.translationY
Read only- Distance traversed along the Y-axis since the previous
MSGestureEvent
of the current gesture MSGestureEvent.velocityAngular
Read only- Angular velocity. Expressed in radians.
MSGestureEvent.velocityExpansion
Read only- The velocity of the expansion of the gesture area.
MSGestureEvent.velocityX
Read only- Velocity along the direction of the X-axis.
MSGestureEvent.velocityY
Read only- Velocity along the direction of the Y-axis.
Methods
This interface also inherits methods of its parents, UIEvent
and Event
.
MSGestureEvent.initGestureEvent()
- Initializes the value of an
MSGestureEvent
. If the event has already being dispatched, this method does nothing. This method is deprecated as of Microsoft Edge.
Gesture event types
Specifications
Not part of any specification. Microsoft has a description on MSDN.
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
MSGestureEvent | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
MSGestureEvent() constructor | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
expansion | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
gestureObject | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
initGestureEvent | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
rotation | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
scale | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
translationX | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
translationY | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
velocityAngular | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
velocityExpansion | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
velocityX | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
velocityY | Chrome No support No | Edge No support 12 — 79 | Firefox No support No | IE Full support 10 | Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- Non-standard. Expect poor cross-browser support.
- Non-standard. Expect poor cross-browser support.
See also
- WebKit equivalents: