DOMMatrix：translateSelf() 方法

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起，所有主流浏览器均已支持。

注意：此功能在 Web Workers 中可用。

DOMMatrix 接口的 translateSelf() 方法是一个可变转换方法，用于修改矩阵。它应用指定的向量并返回更新后的矩阵。默认向量为 [0, 0, 0]。

要翻译矩阵而不对其进行修改，请参阅 DOMMatrixReadOnly.translate()。

语法

translateSelf(translateX, translateY)
translateSelf(translateX, translateY, translateZ)

参数

translateX: 一个数字，表示平移向量的横坐标（x 坐标）。
translateY: 一个数字，表示平移向量的纵坐标（y 坐标）。
translateZ 可选: 一个数字，表示平移向量的 z 分量。如果未提供，则默认为 0。如果其值不为 0，则生成的矩阵将是 3D 的。

返回值

返回自身；即由给定向量平移后的 DOMMatrix。

示例

const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.toString()); // output: "matrix(1, 0, 0, 1, 0, 0)"
matrix.translateSelf(25, 25); // mutate it
console.log(matrix); // output: "matrix(1, 0, 0, 1, 25, 25)"

规范

规范
Geometry Interfaces Module Level 1 # dom-dommatrix-translateself

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025年3月18日，由 MDN 贡献者进行。

在 GitHub 上查看此页面 • 报告此内容的问题