DOMMatrix: translateSelf() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。

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

translateSelf() は DOMMatrix インターフェイスのメソッドで、行列を変更する座標変換メソッドです。指定されたベクトルを適用し、更新された行列を返します。デフォルトのベクトルは [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(); // 行列を作成
console.log(matrix.toString()); // 出力: "matrix(1, 0, 0, 1, 0, 0)"
matrix.translateSelf(25, 25); // 変更する
console.log(matrix); // 出力: "matrix(1, 0, 0, 1, 25, 25)"