DOMPointReadOnly: DOMPointReadOnly() Konstruktor

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.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Der DOMPointReadOnly() Konstruktor gibt ein neues DOMPointReadOnly Objekt zurück, das einen Punkt im 2D- oder 3D-Raum repräsentiert, optional mit Perspektive, dessen Werte durch Skriptcode nicht verändert werden können.

Syntax

js
new DOMPointReadOnly()
new DOMPointReadOnly(x)
new DOMPointReadOnly(x, y)
new DOMPointReadOnly(x, y, z)
new DOMPointReadOnly(x, y, z, w)

Parameter

x Optional

Der Wert der horizontalen Koordinate, x, als Gleitkommazahl. Der Standardwert ist 0.

y Optional

Der Wert der vertikalen Koordinate, y, als Gleitkommazahl. Der Standardwert ist 0.

z Optional

Der Wert der Tiefenkoordinate, z, als Gleitkommazahl. Der Standardwert ist 0.

w Optional

Der Wert der Perspektive, w, als Gleitkommazahl. Der Standardwert ist 1.

Hinweis: Jeder dieser Werte wird als unbeschränkt bezeichnet. Neben jedem endlichen Gleitkommawert können Sie spezielle Werte wie ±Infinity und NaN verwenden.

Rückgabewert

Ein neues DOMPointReadOnly Objekt, das die angegebene Position im Raum repräsentiert.

Beispiele

Der folgende Code zeigt die Erstellung von 2D- und 3D-Punkten.

js
const point2D = new DOMPointReadOnly(50, 25);
const point3D = new DOMPointReadOnly(50, 0, 10);
const perspectivePoint3D = new DOMPointReadOnly(50, 50, 25, 0.5);

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser