CSSのtransformで、関数の順番によって結果が変わる理由

​​CSS​JavaScript,Playwright,アニメーション

CSS の transform に並べた関数は、左から順に、要素の座標系(x 軸と y 軸の向きと目盛り)を動かしていきます。先に rotate() で回すと x 軸の向きが変わるので、その後の translateX() は回った向きに進みます。ホバーで動かすボタンや、アイコンを回しながら動かすアニメーションで、要素が思った方向に動かないときは、関数の順番が原因のことがあります。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、Chromium 153 です。左上を (200, 200) に置いた 100px 四方の箱に transform を付け、getBoundingClientRect() で箱の中心の位置を、getComputedStyle() で変形の行列を読みました。Firefox と Safari、3D の変形(rotateX() や perspective())は試していません。

translate と rotate を入れ替えると、行き先が変わる

translateX(100px) と rotate(90deg) を、順番だけ入れ替えて並べました。

css
.a {
  transform: translateX(100px) rotate(90deg);
}

.b {
  transform: rotate(90deg) translateX(100px);
}
上下2段の図。上の translateX(100px) rotate(90deg) では、水色の箱が灰色の点線で示した元の位置の右隣にあり、箱の中のピンクの「x 軸 →」の札は下を向いている。下の rotate(90deg) translateX(100px) では、箱が元の位置の真下にあり、札は同じく下を向いている
100px 四方の箱に、translateX(100px) と rotate(90deg) を順番を入れ替えて付けたところ。ピンクの札は、箱の x 軸の向き

translateX(100px) rotate(90deg) の箱は、中心が右へ 100px 動きました。rotate(90deg) translateX(100px) の箱は、右ではなく下へ 100px 動きました。どちらも 90 度回っているので、見た目の向きは同じです。

角度を 45 度にすると、違いがもっと分かりやすくなります。

transform 中心が動いた量(右, 下)
translateX(100px) rotate(45deg) (100, 0)
rotate(45deg) translateX(100px) (70.71, 70.71)

先に回したほうは、右下 45 度の向きに 100px 進みました。右にも下にも 100 × cos 45° ≒ 70.71px なので、右下の斜めに 100px 動いた位置です。

関数ごとに、要素の座標系が変わる

順番で結果が変わるのは、それぞれの関数が「次の関数のための座標系」を作るからです。MDN の transform の説明にも、座標変換関数は左から右へと組み合わされ、それぞれの関数が次の関数のための新しい座標系を作る、と書かれています。

rotate(90deg) translateX(100px) を、左から順に読むとこうなります。

  1. rotate(90deg) で、要素の座標系が時計回りに 90 度回る。x 軸は下を向く
  2. translateX(100px) は、回った座標系の x 軸の向き、つまり下へ 100px 動かす

上の図のピンクの札が、箱の x 軸の向きです。translateX(100px) rotate(90deg) では、動いた時点の x 軸はまだ右を向いているので、右へ 100px 動いてから、その場で回ります。

scale() でも同じことが起きます。scale(2) は座標系の目盛りを2倍にするので、その後の translateX(50px) は 100px 分動きます。

transform 中心が動いた量(右, 下) 見た目の大きさ
translateX(50px) scale(2) (50, 0) 200 × 200
scale(2) translateX(50px) (100, 0) 200 × 200

scale() を translate() より左に書くと、移動の量にも倍率が掛かります。拡大のアニメーションに移動を足したら思ったより遠くへ動いた、というときは、この順番を確かめます。

同じ変形は、逆の向きからも説明できます。MDN の説明にあるとおり、親の座標系を固定したまま、関数を右から左へ順に当てはめても、同じ結果になります。rotate(90deg) translateX(100px) なら、先に右へ 100px 動かし、その後で transform-origin(初期値は要素の中心)を中心に 90 度回すと考えます。右へ動いた箱が、元の中心のまわりを回って真下に来るので、結果は同じく下へ 100px です。左から読むか右から読むかは、考えやすいほうを選んでかまいません。

ブラウザーは、関数を左から順に行列として掛けている

CSS Transforms の仕様では、変形の行列を次の手順で求める、と決まっています。

  1. 単位行列から始める
  2. transform-origin の位置へ動かす
  3. transform の関数を、左から右へ順に掛ける
  4. transform-origin の位置から、元へ戻す

行列の掛け算は、順番を入れ替えると答えが変わることがあります。getComputedStyle() で transform の値を読むと、どちらも matrix() の形になり、最後の2つの数(移動の量)だけが違いました。

text
translateX(100px) rotate(90deg) → matrix(0, 1, -1, 0, 100, 0)
rotate(90deg) translateX(100px) → matrix(0, 1, -1, 0, 0, 100)

JavaScript の DOMMatrix で、translateX(100px) の行列(T)と rotate(90deg) の行列(R)を作り、multiply() で左から順に掛けた結果も、それぞれ同じ値になりました。

js
const t = new DOMMatrix('translateX(100px)');
const r = new DOMMatrix('rotate(90deg)');

t.multiply(r); // 値を丸めると matrix(0, 1, -1, 0, 100, 0)
r.multiply(t); // 値を丸めると matrix(0, 1, -1, 0, 0, 100)

入れ替えても同じになる組み合わせ

すべての組み合わせで結果が変わるわけではありません。2つの関数を入れ替えて、getComputedStyle() の行列を比べました。

組み合わせ 入れ替えたときの行列
translateX(100px) と translateY(50px) 同じ
rotate(30deg) と rotate(60deg) 同じ
scale(2) と rotate(30deg) 同じ
scale(2, 1) と rotate(30deg) 違う
skewX(20deg) と rotate(30deg) 違う

移動どうし、回転どうしは、足し算と同じで順番に関係なく同じ結果でした。縦横を同じ倍率にする scale(2) は、回してから広げても、広げてから回しても同じです。いっぽう、横だけ2倍にする scale(2, 1) は形が変わります。rotate(30deg) scale(2, 1) は、箱を自分の横方向に2倍に伸ばした長方形を傾けた形になります。scale(2, 1) rotate(30deg) は、傾けた箱を画面の横方向に引き伸ばすので、角が直角でない平行四辺形になります(行列の値から計算すると、隣り合う2辺のなす角は 123 度でした)。

translate() は、rotate() と組み合わせても scale() と組み合わせても、入れ替えると位置が変わります。迷ったときは、translate() を左端に書いておくと、指定した値のとおり、画面の横・縦の向きに動きます。

translate・rotate・scale プロパティは、書く順番に関係なく決まった順で効く

transform とは別に、translate、rotate、scale という個別のプロパティもあります。CSS Transforms Level 2 の仕様では、これらは translate、rotate、scale の順に当てはめ、その後で transform の関数を左から順に掛ける、と決まっています。

css
.c {
  rotate: 90deg;
  translate: 100px;
}

このように rotate を先に書いても、箱は右へ 100px 動いてから回りました。translate: 100px; rotate: 90deg; と書いた場合と同じ位置です。scale: 2; translate: 50px; も、動いた量は 50px で、translateX(50px) scale(2) と同じでした。

transform と個別のプロパティを一緒に使うと、transform の関数は個別のプロパティの後に効きます。rotate: 90deg と transform: translateX(100px) を一緒に付けると、書く順番によらず、箱は下へ 100px 動きました。rotate(90deg) translateX(100px) と同じ結果です。

css
.d {
  transform: translateX(100px);
  rotate: 90deg; /* translateX より先に効くので、箱は下へ動く */
}

なお、個別のプロパティだけを使った要素では、getComputedStyle() で読んだ transform の値は none のままでした。変形の量を JavaScript で読むときは、translate や rotate の値も見る必要があります。

アニメーションでは、始まりと終わりの関数の並びをそろえる

アニメーションやトランジションで transform を変化させるときも、関数の並びが結果に関わります。仕様の変形の補間の決まりでは、始まりと終わりの値を先頭から1つずつ比べ、同じ種類の関数どうしは数値のまま途中の値を作ります。種類が食い違ったところから後ろは、まとめて行列に直してから途中の値を作ります。

始まりを translateX(0) rotate(0deg) にして、終わりの並びだけを変えた2つのアニメーションで、途中の値を読みました。

終わりの値 25% 50% 75%
translateX(100px) rotate(360deg) 90 度、右へ 25px 180 度、右へ 50px 270 度、右へ 75px
rotate(360deg) translateX(100px) 0 度、右へ 25px 0 度、右へ 50px 0 度、右へ 75px

並びをそろえた1つ目は、右へ進みながら1回転しました。並びが逆の2つ目は、まったく回らずに右へ進むだけでした。360 度の回転は、行列にすると回していないのと同じになるため、回転の量が失われます。仕様にある行列での補間の説明にも、行列に直すと何回転したかという情報が失われる例が載っています。

始まりも rotate(0deg) translateX(0) にそろえて、rotate(360deg) translateX(100px) へ動かすと、今度は1回転しました。ただし、translateX() が回った後の x 軸の向きに進むので、25% で下へ 25px、50% で左へ 50px、75% で上へ 75px と、回りながら外へ広がる渦巻きのような動きになりました。

ポイント

アニメーションで「動きながら回る」を作るときは、始まりと終わりの両方を translate()、rotate() の順に、同じ並びで書きます。

​Posted by 86