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

瀏覽器相容性