DOMMatrixReadOnly: toString() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Januar 2020.
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)