DOMMatrix: translateSelf() 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 translateSelf()-Methode der DOMMatrix-Schnittstelle ist eine veränderliche Transformationsmethode, die eine Matrix modifiziert. Sie wendet die angegebenen Vektoren an und gibt die aktualisierte Matrix zurück. Der Standardvektor ist [0, 0, 0].

Um eine Matrix zu verschieben, ohne sie zu verändern, siehe DOMMatrixReadOnly.translate()

Syntax

js
DOMMatrix.translateSelf(translateX, translateY)
DOMMatrix.translateSelf(translateX, translateY, translateZ)

Parameter

translateX

Eine Zahl, die die Abszisse (x-Koordinate) des Verschiebungsvektors darstellt.

translateY

Eine Zahl, die die Ordinate (y-Koordinate) des Verschiebungsvektors darstellt.

translateZ Optional

Eine Zahl, die die z-Komponente des Verschiebungsvektors darstellt. Falls nicht angegeben, ist der Standardwert 0. Wenn dieser Wert ungleich 0 ist, wird die resultierende Matrix 3D sein.

Rückgabewert

Gibt sich selbst zurück; die von dem angegebenen Vektor verschobene DOMMatrix.

Beispiele

js
const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.toString()); // output: "matrix(1, 0, 0, 1, 0, 0)"
matrix.translateSelf(25, 25); // mutate it
console.log(matrix); // output: "matrix(1, 0, 0, 1, 25, 25)"

Spezifikationen

Specification
Geometry Interfaces Module Level 1
# dom-dommatrix-translateself

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch