DOMPointReadOnly:DOMPointReadOnly() 构造函数

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流浏览器均已支持。

注意:此功能在 Web Workers 中可用。

DOMPointReadOnly() 构造函数返回一个新的 DOMPointReadOnly 对象,该对象表示 2D 或 3D 空间中的一个点,可以选择性地包含透视,其值不能被脚本代码更改。

语法

js
new DOMPointReadOnly()
new DOMPointReadOnly(x)
new DOMPointReadOnly(x, y)
new DOMPointReadOnly(x, y, z)
new DOMPointReadOnly(x, y, z, w)

参数

x 可选

水平坐标 x 的值,为浮点数。默认值为 0。

y 可选

垂直坐标 y 的值,为浮点数。默认值为 0。

z 可选

深度坐标 z 的值,为浮点数。默认值为 0。

w 可选

透视 w 的值,为浮点数。默认值为 1。

注意:这些值中的每一个都称为无限制数字(unrestricted number)。除了任何有限的浮点值外,你还可以使用特殊值,例如 ±InfinityNaN

返回值

表示空间中指定位置的新 DOMPointReadOnly 对象。

示例

以下代码演示了如何创建 2D 和 3D 点。

js
const point2D = new DOMPointReadOnly(50, 25);
const point3D = new DOMPointReadOnly(50, 0, 10);
const perspectivePoint3D = new DOMPointReadOnly(50, 50, 25, 0.5);

规范

规范
Geometry Interfaces Module Level 1
# dom-dompointreadonly-dompointreadonly

浏览器兼容性