The DOMPointInit
dictionary's y
property is used to specify the y-coordinate of a point in 2D or 3D space when either creating or serializing to JSON a DOMPoint
or DOMPointReadOnly
object.
In general, the value of y
increases to the right and decreases to the left, becoming negative to the left of the origin. This may change if transforms have been applied causing the axes' orientation to change.
Syntax
var DOMPointInit = { y: yPos }; DOMPointInit.y = yPos; var yPos = DOMPointInit.y;
Value
A double-precision floating-point value indicating the point's y-coordinate. This value is unrestricted, meaning that it is allowed to be infinite or invalid (that is, its value may be NaN
or Β±Infinity
).
If this property is missing when the DOMPointInit
object is passed into fromPoint()
, the value is assumed to be 0 by default.
There are two methods which use DOMPointInit
:
- The static function
DOMPointReadOnly.fromPoint()
takes an object that complies withDOMPointInit
as its sole input parameter, to specify the coordinates and perspective value of the new point to be created. This method is, by inheritance, also available asDOMPoint.fromPoint()
. - The
DOMPointReadOnly.toJSON()
method returns aDOMPointInit
object that describes the same point as the original point. By inheritance, this method is also available asDOMPoint.toJSON()
.
Specifications
Specification | Status | Comment |
---|---|---|
Geometry Interfaces Module Level 1 The definition of 'y' in that specification. |
Candidate Recommendation | Initial definition |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
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 ? |
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.