DOMMatrixReadOnly: toString() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

DOMMatrixReadOnly 介面的 toString() 字串轉換器matrix()matrix3d() CSS 變換函式 的形式返回矩陣的值;這是一種逗號分隔的 6 個或 16 個座標值列表,分別以 "matrix("matrix3d( 開頭,以 )" 結尾。

對於 2D 矩陣,會列出 af 的元素,共六個值,形式為 matrix(a, b, c, d, e, f)。有關此語法的詳細資訊,請參閱 matrix() CSS 函式。

對於 3D 矩陣,返回的字串包含所有 16 個元素,形式為 matrix3d(m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44)。有關 3D 記法的語法詳細資訊,請參閱 CSS matrix3d() 函式。

語法

js
toString()

引數

無。

返回值

字串;列表中的值在 matrix()matrix3d() 函式語法中用逗號分隔。

示例

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)

規範

此特性似乎未在任何規範中定義。

瀏覽器相容性

另見