DOMPoint:fromPoint() 静态方法

Baseline 已广泛支持

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

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

DOMPoint 接口的 **fromPoint()** 静态方法,可以根据源点创建一个新的可变 DOMPoint 对象并返回。

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

尽管此接口基于 DOMPointReadOnly,但它并非只读;内部属性可以随意更改。

语法

js
DOMPoint.fromPoint(sourcePoint)

参数

sourcePoint

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

x

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

y

一个无限制的浮点数,提供点的 y 坐标。这是垂直坐标,如果不应用任何变换,正值向下,负值向上(朝向屏幕顶部)。默认值为 0

z

一个无限制的浮点数值,给出点的 z 坐标,它(假设没有改变情况的变换)是深度坐标;正值更靠近用户,负值则退入屏幕深处。默认值为 0

w

点的 w 透视值,作为无限制的浮点数给出。默认值为 1

返回值

一个新 DOMPoint 对象,其坐标和透视值与源点中的值相同。该点的属性是可变的,可以随时更改。

示例

从只读点创建可变点

如果您有一个 DOMPointReadOnly 对象,您可以轻松地创建一个该点的可变副本。

js
const mutablePoint = DOMPoint.fromPoint(readOnlyPoint);

创建二维点

此示例创建一个二维点,指定一个包含要用于 xy 的值的内联对象。zw 属性允许保持其默认值(分别为 0 和 1)。

js
const center = DOMPoint.fromPoint({ x: 75, y: -50 });

规范

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

浏览器兼容性