The Touch interface represents a single contact point on a touch-sensitive device. The contact point is commonly a finger or stylus and the device may be a touchscreen or trackpad.

Documentation Touch by Mozilla Contributors, licensed under CC-BY-SA 2.5.

See also:

Constructor

new(touchInitDict:TouchInit)

Throws:

null

DOMError

Variables

read onlyclientX:Int

Returns the X coordinate of the touch point relative to the left edge of the browser viewport, not including any scroll offset.

read onlyclientY:Int

Returns the Y coordinate of the touch point relative to the top edge of the browser viewport, not including any scroll offset.

read onlyforce:Float

Returns the amount of pressure being applied to the surface by the user, as a float between 0.0 (no pressure) and 1.0 (maximum pressure).

read onlyidentifier:Int

Returns a unique identifier for this Touch object. A given touch point (say, by a finger) will have the same identifier for the duration of its movement around the surface. This lets you ensure that you're tracking the same touch all the time.

read onlypageX:Int

Returns the X coordinate of the touch point relative to the left edge of the document. Unlike clientX, this value includes the horizontal scroll offset, if any.

read onlypageY:Int

Returns the Y coordinate of the touch point relative to the top of the document. Unlike clientY, this value includes the vertical scroll offset, if any.

read onlyradiusX:Int

Returns the X radius of the ellipse that most closely circumscribes the area of contact with the screen. The value is in pixels of the same scale as screenX.

read onlyradiusY:Int

Returns the Y radius of the ellipse that most closely circumscribes the area of contact with the screen. The value is in pixels of the same scale as screenY.

read onlyrotationAngle:Float

Returns the angle (in degrees) that the ellipse described by radiusX and radiusY must be rotated, clockwise, to most accurately cover the area of contact between the user and the surface.

read onlyscreenX:Int

Returns the X coordinate of the touch point relative to the left edge of the screen.

read onlyscreenY:Int

Returns the Y coordinate of the touch point relative to the top edge of the screen.

read onlytarget:EventTarget

Returns the Element on which the touch point started when it was first placed on the surface, even if the touch point has since moved outside the interactive area of that element or even been removed from the document.