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 上檢視此頁面 • 報告此內容的問題