Warning: Removed in Firefox 65.
The sendTouchEvent()
method of the HTMLIFrameElement
allows you to fake a touch event and send it to the browser <iframe>
's content.
Note: This method is available for touch-enabled devices only.
Syntax
instanceOfHTMLIframeElement.sendTouchEvent(type, x, y, rx, ry, rotationAngles, forces, count, modifiers);
Returns
Void.
Parameters
type
- A string representing the event type. Possible values are
touchstart
,touchend
,touchmove
, ortouchcancel
. x
- An array of numbers representing the x position of each touch point relative to the browser
<iframe>
's visible area in CSS pixels. y
- An array of numbers representing the y position of each touch point relative to the browser
<iframe>
's visible area in CSS pixels. rx
- An array of numbers representing the x radius of each touch point in CSS pixels.
ry
- An array of numbers representing the y radius of each touch point in CSS pixels.
rotationAngles
- An array of numbers representing the angle of each touch point in degrees.
forces
- An array of numbers representing the intensity of each touch in the range 0–1.
count
- The number of touches that should be performed.
modifiers
- A number representing a key pressed at the same time the mouse button was clicked:
1
: Alt2
: Ctrl4
: Shift8
: Meta16
: Alt Gr32
: Caps Lock64
: Fn128
: Num Lock256
: Scroll512
: Symbol Lock1024
: Win
Note: You can specify multiple key modifiers separated by a pipe symbol, for example
1 | 1014
.
Examples
var browser = document.querySelector('iframe'); browser.sendTouchEvent("touchstart", [1], [x], [y], [2], [2], [20], [0.5], 1, 0);
Specification
Not part of any specification.
Browser compatibility
Supported since Firefox 47, in chrome code only. Removed completely in Firefox 65.
Unlikely ever to be supported in other browsers.