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

瀏覽器相容性