DOMMatrixReadOnly: toString() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Der toString() Stringifier der Schnittstelle DOMMatrixReadOnly gibt den Wert der Matrix als Zeichenkette in Form einer matrix() oder matrix3d() CSS-Transformationsfunktion zurück; kommagetrennte Listen von 6 oder 16 Koordinatenwerten, die jeweils mit "matrix( oder "matrix3d( beginnen und mit )" enden.
Für eine 2D-Matrix werden die Elemente a bis f aufgelistet, insgesamt sechs Werte in der Form matrix(a, b, c, d, e, f). Siehe die matrix() CSS-Funktion für Details zu dieser Syntax.
Für eine 3D-Matrix enthält die zurückgegebene Zeichenkette alle 16 Elemente und nimmt die Form matrix3d(m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44) an. Siehe die CSS-matrix3d()-Funktion für Details zur Syntax der 3D-Notation.
Syntax
toString()
Parameter
Keine.
Rückgabewert
Ein String; die Werte der Liste, durch Kommas getrennt, innerhalb der Funktionensyntax von matrix() oder matrix3d().
Beispiele
const matrix = new DOMMatrixReadOnly();
console.log(matrix.translate(20, 30).toString()); // matrix(1, 0, 0, 1, 20, 30)
console.log(matrix.translate(30, 40, 50).toString()); // matrix3d(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 30, 40, 50, 1)
console.log(matrix.skewY(15).skewX(5).rotate(3).translate(20, 50).toString());
// matrix(1.003, 0.321, 0.035, 1.01, 21.816, 56.824)
console.log(
matrix.skewY(15).skewX(5).rotate(3).translate(20, 50, 60).toString(),
);
// matrix3d(1.003, 0.321, 0, 0, 0.0350, 1.008, 0, 0, 0, 0, 1, 0, 21.816, 56.824, 60, 1)