DOMPointReadOnly: DOMPointReadOnly() コンストラクター

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

DOMPointReadOnly() コンストラクターは、スクリプトコードによってその値を変更できない、 2D または 3D の点を表す新しい DOMPointReadOnly オブジェクト(オプションで遠近法を使用可能)を返します。

構文

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 です。

メモ: これらの値はそれぞれ無制限の数と呼ばれるものです。有限の浮動小数点数に加えて、±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);

仕様書

Specification
Geometry Interfaces Module Level 1
# dom-dompointreadonly-dompointreadonly

ブラウザーの互換性

BCD tables only load in the browser