このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

DOMMatrix: rotateSelf() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年1月.

メモ: この機能はウェブワーカー内で利用可能です。

rotateSelf()DOMMatrix インターフェイスのメソッドで、行列に変更を行う座標変換メソッドです。ソース行列をそれぞれの軸を中心に指定された角度だけ回転させ、回転後の行列を返します。

変更せずに行列を回転させるには、DOMMatrixReadOnly.rotate() を参照してください。

構文

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

引数

rotX

数値です。回転軸を示すベクトルの X 座標です。

rotY 省略可

数値です。回転軸を示すベクトルの Y 座標です。

rotZ 省略可

数値です。回転軸を示すベクトルの Z 座標です。

引数が 1 つだけ渡された場合、rotZrotX の値となり、rotXrotY は両方とも 0 で、回転は二次元回転となります。rotXrotY が 0 以外の場合、is2Dfalse です。

返値

自分自身を返します。指定されたベクトルで回転された DOMMatrix です。

js
const matrix = new DOMMatrix(); // 行列を作成
console.log(matrix.toString()); // 出力: "matrix(1, 0, 0, 1, 0, 0)"
matrix.rotateSelf(30); // 変更する
console.log(matrix); // 出力: "matrix(0.866, 0.5, -0.5, 0.866, 0, 0)"

仕様書

Specification
Geometry Interfaces Module Level 1
# dom-dommatrix-rotateself

ブラウザーの互換性

関連情報