TouchEvent: TouchEvent() constructor
Touch Events
Touch Events
The TouchEvent() constructor creates a new TouchEvent object.
[!NOTE] If you construct a synthetic event using this constructor, that event will not be trusted, for security reasons. Only browser-generated
TouchEventobjects are trusted and only trusted events trigger default actions.
Syntax
new TouchEvent(type)
new TouchEvent(type, options)
Parameters
type- : A string with the name of the event.
It is case-sensitive and browsers set it to
touchstart,touchend,touchmove,touchcancel options- : An object that, in addition of the properties defined in UIEvent(), can have the following properties:
touches- : A TouchList, defaulting to an empty one, that is a list of objects for every point of contact currently touching the surface.
targetTouches- : A TouchList, defaulting to an empty one, that is a list of objects for every point of contact that is touching the surface and started on the element that is the target of the current event.
changedTouches- : and defaulting to
[], of typeTouch[], that is a list of objects for every point of contact which contributed to the event. ctrlKey- : A boolean value, defaulting to
false, indicating if the ctrl key was simultaneously pressed. shiftKey- : A boolean value, defaulting to
false, indicating if the shift key was simultaneously pressed. altKey- : A boolean value, defaulting to
false, indicating if the alt key was simultaneously pressed. metaKey- : A boolean value, defaulting to
false, indicating if the meta key was simultaneously pressed.
Return value
A new TouchEvent object.
Specifications
Browser compatibility
See also
- TouchEvent, the interface of the objects it constructs.