DOMPoint: fromPoint() statische Methode
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.
Die fromPoint()
statische Methode des DOMPoint
Interfaces erstellt und gibt ein neues veränderbares DOMPoint
-Objekt basierend auf einem Quellpunkt zurück.
Sie können auch ein neues DOMPoint
-Objekt mit dem
DOMPoint()
Konstruktor erstellen.
Obwohl dieses Interface auf DOMPointReadOnly
basiert, ist es nicht schreibgeschützt;
die Eigenschaften darin können nach Belieben geändert werden.
Syntax
DOMPoint.fromPoint(sourcePoint)
Parameter
sourcePoint
-
Eine Instanz von
DOMPoint
oderDOMPointReadOnly
, oder ein Objekt, das die folgenden Eigenschaften enthält, aus denen die Werte der neuen Punkt-Eigenschaften entnommen werden:x
-
Ein uneingeschränktes Fließkommawert, der die
x
-Koordinate des Punktes im Raum angibt. Dies ist generell die horizontale Koordinate, wobei positive Werte nach rechts und negative Werte nach links zeigen. Der Standardwert ist0
. y
-
Eine uneingeschränkte Fließkommazahl, die die
y
-Koordinate des Punktes angibt. Dies ist die vertikale Koordinate, und sofern keine Transformationen auf das Koordinatensystem angewendet werden, zeigen positive Werte nach unten und negative Werte nach oben zum oberen Rand des Bildschirms. Der Standard ist0
. z
-
Ein uneingeschränktes Fließkommawert, das die
z
-Koordinate des Punktes angibt, was (unter der Annahme, dass keine Transformationen die Situation ändern) die Tiefenkoordinate ist; positive Werte näher beim Benutzer und negative Werte entfernen sich vom Bildschirm. Der Standardwert ist0
. w
-
Der
w
Perspektivwert des Punktes, angegeben als ein uneingeschränktes Fließkommawert. Der Standard ist1
.
Rückgabewert
Ein neues DOMPoint
Objekt, dessen Koordinaten- und Perspektivwerte mit denen im Quellpunkt identisch sind. Die Eigenschaften des Punktes sind veränderbar und können jederzeit geändert werden.
Beispiele
Erstellen eines veränderbaren Punktes aus einem schreibgeschützten Punkt
Wenn Sie ein DOMPointReadOnly
Objekt haben, können Sie leicht eine veränderbare
Kopie dieses Punktes erstellen:
const mutablePoint = DOMPoint.fromPoint(readOnlyPoint);
Erstellen eines 2D-Punktes
Spezifikationen
Specification |
---|
Geometry Interfaces Module Level 1 # dom-dompoint-frompoint |