The DOMPointInit
dictionary is used to provide the values of the coordinates and perspective when creating and JSONifying a DOMPoint
or DOMPointReadOnly
object.
It's used as an input parameter to the DOMPoint
/DOMPointReadOnly
method fromPoint()
. It's used as the return value when calling toJSON()
.
Properties
DOMPointInit.x
- An unrestricted floating-point value indicating the
x
-coordinate of the point in space. This is generally the horizontal coordinate, with positive values being to the right and negative values to the left. The default value is0
. DOMPointInit.y
- An unrestricted floating-point number providing the point's
y
-coordinate. This is the vertical coordinate, and barring any transforms applied to the coordinate system, positive values are downward and negative values upward toward the top of the screen. The default is0
. DOMPointInit.z
- An unrestricted floating-point value which gives the point's
z
-coordinate, which is (assuming no transformations that alter the situation) the depth coordinate; positive values are closer to the user and negative values retreat back into the screen. The default value is0
. DOMPointInit.w
- The point's
w
perspective value, given as an unrestricted floating-point number. The default is1
.
Example
This example creates a new DOMPoint
representing the top-left corner of the current window, with a z
component added to move the point closer to the user. This same code will work to create a DOMPointReadOnly
object; just change the interface name in the code.
const pointDesc = { x: window.screenX, y: window.screenY, z: 5.0 }; const windTopLeft = DOMPoint.fromPoint(pointDesc)
Specifications
Specification | Status | Comment |
---|---|---|
Geometry Interfaces Module Level 1 The definition of 'DOMPointReadOnly.fromPoint()' in that specification. |
Candidate Recommendation | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
DOMPointInit | Chrome ? | Edge ? | Firefox Full support 62 | IE No support No | Opera ? | Safari No support No | WebView Android ? | Chrome Android ? | Firefox Android Full support 62 | Opera Android ? | Safari iOS No support No | Samsung Internet Android ? |
w | Chrome ? | Edge ? | Firefox Full support 62 | IE No support No | Opera ? | Safari No support No | WebView Android ? | Chrome Android ? | Firefox Android Full support 62 | Opera Android ? | Safari iOS No support No | Samsung Internet Android ? |
x | Chrome ? | Edge ? | Firefox Full support 62 | IE No support No | Opera ? | Safari No support No | WebView Android ? | Chrome Android ? | Firefox Android Full support 62 | Opera Android ? | Safari iOS No support No | Samsung Internet Android ? |
y | Chrome ? | Edge ? | Firefox Full support 62 | IE No support No | Opera ? | Safari No support No | WebView Android ? | Chrome Android ? | Firefox Android Full support 62 | Opera Android ? | Safari iOS No support No | Samsung Internet Android ? |
z | Chrome ? | Edge ? | Firefox Full support 62 | IE No support No | Opera ? | Safari No support No | WebView Android ? | Chrome Android ? | Firefox Android Full support 62 | Opera Android ? | Safari iOS No support No | Samsung Internet Android ? |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.