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)

规范

此特性似乎未在任何规范中定义。

浏览器兼容性

另见