DOMPointReadOnly:fromPoint() 静态方法

Baseline 已广泛支持

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

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

静态 DOMPointReadOnly 方法 fromPoint() 在给定一个源点时,会创建一个新的 DOMPointReadOnly 对象并返回它。

您也可以使用 DOMPointReadOnly() 构造函数来创建一个新的 DOMPointReadOnly 对象。

语法

js
DOMPointReadOnly.fromPoint(sourcePoint)

参数

sourcePoint

一个 DOMPointDOMPointReadOnly 实例,或者一个包含以下属性的对象,用于获取新点的属性值。

x

一个不受限制的浮点值,表示空间中点的 x 坐标。这通常是水平坐标,正值表示向右,负值表示向左。默认值为 0

y

一个不受限制的浮点数,提供点的 y 坐标。这是垂直坐标,并且在不应用任何变换到坐标系统的情况下,正值表示向下,负值表示向上(屏幕顶部)。默认值为 0

z

一个不受限制的浮点值,表示点的 z 坐标,这是(假定没有改变情况的变换)深度坐标;正值表示更靠近用户,负值表示远离屏幕。默认值为 0

w

点的 w 透视值,作为一个不受限制的浮点数给出。默认值为 1

返回值

一个新的 DOMPointReadOnly 对象(与源点相同)。

示例

创建一个二维点

此示例通过指定一个包含 xy 值的内联对象来创建一个二维点。zw 属性允许保留其默认值(分别为 01)。

js
const point2D = DOMPointReadOnly.fromPoint({ x: 25, y: 25 });

使用现有点创建三维点

此示例通过 DOMPoint() 创建一个类型为 DOMPoint 的点 origPoint。然后将该点作为 fromPoint() 的输入来创建一个新点 newPoint

js
const origPoint = new DOMPoint(25, 25, 100, 0.5);

const newPoint = DOMPointReadOnly.fromPoint(origPoint);

规范

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

浏览器兼容性