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

瀏覽器相容性