DOMMatrix: rotateSelf() 方法

Baseline 已廣泛支援

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

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

DOMMatrix 介面的 rotateSelf() 方法是一個可變轉換方法,用於修改矩陣。它圍繞其每個軸將源矩陣旋轉指定的度數,並返回旋轉後的矩陣。

要旋轉矩陣而不修改它,請參閱 DOMMatrixReadOnly.rotate()

語法

js
rotateSelf()
rotateSelf(rotX)
rotateSelf(rotX, rotY)
rotateSelf(rotX, rotY, rotZ)

引數

rotX

一個數字;表示旋轉軸的向量的 x 座標。

rotY 可選

一個數字;表示旋轉軸的向量的 y 座標。

rotZ 可選

一個數字;表示旋轉軸的向量的 z 座標。

如果只傳遞一個引數,rotZ 就是 rotX 的值,並且 rotXrotY 都是 0,則旋轉是 2D 旋轉。如果 rotXrotY 非零,則 is2Dfalse

返回值

返回自身;即由給定向量旋轉的 DOMMatrix

示例

js
const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.toString()); // output: "matrix(1, 0, 0, 1, 0, 0)"
matrix.rotateSelf(30); // mutate it
console.log(matrix); // output: "matrix(0.866, 0.5, -0.5, 0.866, 0, 0)"

規範

規範
Geometry Interfaces Module Level 1
# dom-dommatrix-rotateself

瀏覽器相容性

另見