The DOMPointReadOnly
interface specifies the coordinate and perspective fields used by DOMPoint
to define a 2D or 3D point in a coordinate system.
There are two ways to create a new DOMPointReadOnly
instance. First, you can use its constructor, passing in the values of the parameters for each dimension and, optionally, the perspective:
const point2D = new DOMPointReadOnly(50, 50);
const point3D = new DOMPointReadOnly(50, 50, 25);
const point3DPerspective = new DOMPointReadOnly(100, 100, 100, 1.0);
The other option is to use the static DOMPointReadOnly.fromPoint()
method:
const point = DOMPointReadOnly.fromPoint({ x: 100, y: 100, z: 50, w: 1.0 });
Constructor
-
DOMPointReadOnly()
-
Creates a new DOMPointReadOnly
object given the values of its coordinates and perspective. To create a point using an object, you can instead use DOMPointReadOnly.fromPoint()
.
Instance properties
DOMPointReadOnly.x
Read only
-
The point's horizontal coordinate, x
.
DOMPointReadOnly.y
Read only
-
The point's vertical coordinate, y
.
DOMPointReadOnly.z
Read only
-
The point's depth coordinate, z
.
DOMPointReadOnly.w
Read only
-
The point's perspective value, w
.
Static methods
-
DOMPointReadOnly.fromPoint()
-
A static method that creates a new DOMPointReadOnly
object given the coordinates provided in the specified object.
Instance methods
-
matrixTransform()
-
Applies a matrix transform specified as an object to the DOMPointReadOnly
object.
-
toJSON()
-
Returns a JSON representation of the DOMPointReadOnly
object.
Specifications
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
DOMPointReadOnly |
61 |
79 |
62 |
No |
48 |
10.1 |
61 |
61 |
62 |
45 |
10.3 |
8.0 |
DOMPointReadOnly |
61 |
79 |
31 |
No |
48 |
10.1 |
61 |
61 |
31 |
45 |
10.3 |
8.0 |
fromPoint_static |
61 |
79 |
62 |
No |
48 |
10.1 |
61 |
61 |
62 |
45 |
10.3 |
8.0 |
matrixTransform |
61 |
79 |
69 |
No |
48 |
11 |
61 |
61 |
79 |
45 |
11 |
8.0 |
toJSON |
61 |
79 |
62 |
No |
48 |
10.1 |
61 |
61 |
62 |
45 |
10.3 |
8.0 |
w |
61 |
79 |
31 |
No |
48 |
10.1 |
61 |
61 |
31 |
45 |
10.3 |
8.0 |
worker_support |
61 |
79 |
69 |
No |
48 |
10.1 |
61 |
61 |
79 |
45 |
10.3 |
8.0 |
x |
61 |
79 |
31 |
No |
48 |
10.1 |
61 |
61 |
31 |
45 |
10.3 |
8.0 |
y |
61 |
79 |
31 |
No |
48 |
10.1 |
61 |
61 |
31 |
45 |
10.3 |
8.0 |
z |
61 |
79 |
31 |
No |
48 |
10.1 |
61 |
61 |
31 |
45 |
10.3 |
8.0 |
See also