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 January 2020.

Der toString() Stringifier des DOMMatrixReadOnly-Interfaces gibt den Wert der Matrix als Zeichenkette in der Form einer matrix()- oder matrix3d()-CSS-Transform-Funktion zurück; durch Kommas getrennte Listen von 6 oder 16 Koordinatenwerten, vorangestellt mit "matrix( oder "matrix3d( und abgeschlossen mit )".

Für eine 2D-Matrix werden die Elemente a bis f aufgelistet, insgesamt sechs Werte und die Form matrix(a, b, c, d, e, f). Siehe die matrix() CSS-Funktion für Details zur 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

js
DOMMatrixReadOnly.toString()

Parameter

Keine.

Rückgabewert

Ein String; die Werte der Liste, durch Kommas getrennt, innerhalb der matrix()- oder matrix3d()-Funktionssyntax.

Beispiele

js
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)

Spezifikationen

No specification found

No specification data found for api.DOMMatrixReadOnly.toString.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch