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 インターフェイスは、 DOMPoint が座標系で 2D または 3D の点を定義するために使用する座標フィールドと透視図フィールドを指定するものです。

メモ: この機能はウェブワーカー内で利用可能です。

新しい DOMPointReadOnly インスタンスを作成するには、 2 つの方法があります。まず、コンストラクターを使用し、各次元の引数の値、そしてオプションで視点位置を渡すことができます。

js
/* 2D */
const point2D = new DOMPointReadOnly(50, 50);

/* 3D */
const point3D = new DOMPointReadOnly(50, 50, 25);

/* 3D で視点位置付き */
const point3DPerspective = new DOMPointReadOnly(100, 100, 100, 1.0);

もう一つの選択肢は、静的な DOMPointReadOnly.fromPoint() メソッドを使用する方法です。

js
const point = DOMPointReadOnly.fromPoint({ x: 100, y: 100, z: 50, w: 1.0 });

コンストラクター

DOMPointReadOnly()

座標と視点位置を指定して、新しい DOMPointReadOnly オブジェクトを作成します。オブジェクトを使用して点を作成する場合は、代わりに DOMPointReadOnly.fromPoint() を使用することができます。

インスタンスプロパティ

DOMPointReadOnly.x 読取専用

この点の水平座標である x です。

DOMPointReadOnly.y 読取専用

この点の垂直座標である y です。

DOMPointReadOnly.z 読取専用

この点の奥行座標である z です。

DOMPointReadOnly.w 読取専用

この点の視点位置である w です。

静的メソッド

DOMPointReadOnly.fromPoint()

指定されたオブジェクトの座標を指定して、新しい DOMPointReadOnly オブジェクトを作成する静的メソッドです。

インスタンスメソッド

matrixTransform()

オブジェクトとして指定された行列変換を DOMPointReadOnly オブジェクトに適用します。

toJSON()

DOMPointReadOnly オブジェクトの JSON 表現を返します。

仕様書

Specification
Geometry Interfaces Module Level 1
# DOMPoint

ブラウザーの互換性

BCD tables only load in the browser

関連情報