Reactのアニメーション — 動きを付けたらカクついた

動きを付けたらカクつきます。原因を押さえて、CSSで足りる場面とライブラリを使う場面を分けます。

前回: SSRとSSGのフレームワーク — SNSに貼るとタイトルが出ない

これは【深掘り】の記事です。本線の順路ではありません。 本線のCSSの基本の回で見た目を作り、React深掘りのCSSの回で「CSSの当て方を1つに決める」をやったあと、「そろそろ動きを付けたい」と思った人が読む記事です。飛ばしても本線は進みます。

この記事のコマンドは、VMの中(Ubuntu Server)で打ちます。 Windows の PowerShell ではありません。 画面の確認と計測は、ホストの Windows のブラウザ(Chrome か Edge)で行います。 本線で作った ~/react-demo/ には触りません。 この記事では、まっさらな ~/anilab/ を新しく作って、最後に丸ごと消します。


自分が実際にぶつかったところから書きます。

作っていたのは、カードが並ぶだけの画面でした。それに「読み込んだらふわっと出てくる」動きを足したくなりました。

書いたのは、これだけです。

.card {
  transition: left 0.4s, width 0.4s;
}

動きました。 動きましたが、明らかにカクついていました。

  • 1枚だけなら、まあ滑らか
  • 20枚並べると、ぬるっとしない
  • 50枚にしたら、動いている途中で1回止まる

このとき自分が考えたことは、完全に間違っていました。

「CSSだと限界があるんだな。ライブラリを入れれば滑らかになるはずだ」

そう思って Framer Motion を入れました。結果は、ほとんど変わりませんでした。 むしろ、送るJSが増えた分だけ初回表示が遅くなりました。

原因が分かったのは、F12 を開いて Performance タブで録画してからです。開発者ツールの回でやった、あの画面です。

そこには、1フレームごとに「レイアウト」という紫の帯がびっしり並んでいました。

ブラウザは、left を1px動かすたびに「この要素はどこに置かれるか」を全部計算し直していた。 カクついていたのは、CSSだからでもReactだからでもなく、left を動かしたからだった。

left と width をやめて、transform: translateX() と opacity に書き換えただけで、50枚でも滑らかになりました。ライブラリは要りませんでした。

この記事では、その順番でやります。

まず「なぜカクつくのか」を実測してから、ライブラリを入れます。 逆順にすると、何が効いたのか一生分からないままになります。速くする前に測る、というのはパフォーマンス改善の回と同じ話です。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • アニメーションの滑らかさを決めるのは、道具ではなく「どのプロパティを動かすか」であること。left を動かすか transform を動かすかで、ブラウザの仕事量が桁で変わる
  • ブラウザの描画は レイアウト → ペイント → 合成 の3段階であること。transform と opacity は、最後の1段だけで済む。だから速い
  • ホバー・押した感じ・出てくる動きの9割は、CSSの transition と @keyframes で足りること。ライブラリは要らない
  • CSSにはっきり足りないものが1つあること。要素が消えるときにアニメーションできない(Reactが先にDOMから外してしまう)。これがライブラリを入れる最初の、そして最大の理由
  • Framer Motion(motion)・react-spring・GSAP は、同じ「アニメーション」でも考え方が違うこと。時間で指定するものと、物理(バネの硬さと摩擦)で指定するものがある
  • GSAP を React で使うときは後片づけ(クリーンアップ)が必須であること。書かないと、再描画のたびに二重に動く
  • 動きが苦手な人がいること。prefers-reduced-motion を尊重するのは、好みではなくアクセシビリティの話
  • 迷ったらCSS。ライブラリは「CSSでは書けない」と分かってから入れる

この記事でやること

  1. ~/anilab を新しく作る(本線の ~/react-demo は残したまま)。ポートは 5186
  2. left・width を動かす版と、transform・opacity を動かす版を同じ画面に並べ、DevTools の Performance タブでフレームレートとレイアウト再計算の回数を実測する
  3. CSSの transition と @keyframes だけで、ホバー・押した感じ・出てくる動きを作る
  4. 「消えるときだけアニメーションが効かない」を、わざと再現する
  5. Framer Motion・react-spring・GSAP を1つずつ入れて、同じ動きを3回書く
  6. npm run build して、3つのバンドルサイズを自分の目で比べる
  7. prefers-reduced-motion を実装し、動きをオフにした状態で全部を見直す
  8. ~/anilab を消す

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
レイアウト(リフロー)どの要素が画面のどこに、どんな大きさで置かれるかを計算する処理。1つ動かすと、その周りも巻き込んで計算し直しになることがある
ペイント計算し終わった箱に、色・文字・影を実際に塗る処理。塗る面積が広いほど重い
合成(コンポジット)塗り終わった絵をレイヤーとして重ねて、最終的な1枚にする処理。位置をずらす・薄くする程度なら、ここだけで済む
transform要素を移動・拡大・回転させるCSSプロパティ。周りの要素の位置には影響しない(そこが left との決定的な違い)
opacity要素の不透明度。0 で透明、1 で不透明。display: none と違い、場所は取ったまま
フレームレート(fps)1秒間に何枚の絵を描けたか。多くの画面は60fps、つまり1枚あたり約16.7ミリ秒しか猶予がない
transitionプロパティの値が変わったとき、間を自動で補間するCSSの指定。A → B の2点間だけ
@keyframes途中の通過点を自分で決めるCSSのアニメーション定義。「0%はここ、50%はここ、100%はここ」
イージング動きの速度変化のしかた。等速(linear)、だんだん遅く(ease-out)など
バネ(spring)時間ではなく物理で動きを決める考え方。「何秒で」ではなく「バネの硬さと摩擦」を指定し、止まる時刻は結果として決まる
クリーンアップ後片づけの処理。useEffect の戻り値に書く関数のこと。詳しくはuseEffectの回にあります
prefers-reduced-motionOSの「視差効果を減らす」設定を、Webページ側から読み取るためのCSSメディアクエリ

① どのプロパティを動かすかで速さが決まる

この記事でいちばん大事なのは、ここです。

ライブラリの話は全部あとです。 まず、同じ「300個の箱を横に動かす」を2通りで書いて、実際に測ります。

準備 — anilab を作る

本線で作った ~/react-demo/ は、そのまま残します。 この記事はわざと重い画面を作る手順を含むので、新しいプロジェクトでやります。

VMの中で打ちます。

bash
$ cd ~
$ npm create vite@latest anilab -- --template react

質問が出たら、そのまま Enter で構いません。 版によっては「このまま npm install して起動しますか?」と聞かれます。そこは No(n)を選んでください。 ポートを自分で決めたいからです。

bash
$ cd ~/anilab
$ npm install
$ ls
eslint.config.js  index.html  package.json  public  README.md  src  vite.config.js

この一覧が出れば成功です。 npm install は初回だけ数分かかります。

ポートを開ける

本線で 5173番を使っています。 ぶつからないように、この記事は 5186番でやります。

bash
$ sudo ufw allow 5186/tcp
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
5173/tcp                   ALLOW       Anywhere
5186/tcp                   ALLOW       Anywhere

5186/tcp の行が出れば準備完了です。開けずに起動すると、ターミナルには「起動しました」と出るのに、ブラウザは読み込み中のままになります。

起動する

bash
$ npm run dev -- --host 0.0.0.0 --port 5186

ホストの Windows のブラウザで http://192.168.226.50:5186/ を開いてください(IPは自分の値に。分からなければ VM の中で ip a)。Vite のロゴとカウンターが出れば成功です。

止め方: ターミナルで Ctrl+C。この記事の間は起動したままで構いません。 保存するたびにブラウザが自動で更新されます。

比べるものを作る

src/App.jsx(まるごと入れ替え)

import { useState } from "react";

const COUNT = 300;
const rows = Array.from({ length: COUNT }, (_, i) => i);

function Stage({ mode, on }) {
  return (
    <div className={`stage ${mode} ${on ? "on" : ""}`}>
      {rows.map((i) => (
        <div key={i} className="box" style={{ top: `${i * 2}px` }} />
      ))}
    </div>
  );
}

export default function App() {
  const [onA, setOnA] = useState(false);
  const [onB, setOnB] = useState(false);

  return (
    <div>
      <h1>どのプロパティを動かすか</h1>

      <section>
        <h2>A: left と width を動かす</h2>
        <button onClick={() => setOnA((v) => !v)}>Aを動かす</button>
        <Stage mode="a" on={onA} />
      </section>

      <section>
        <h2>B: transform と opacity を動かす</h2>
        <button onClick={() => setOnB((v) => !v)}>Bを動かす</button>
        <Stage mode="b" on={onB} />
      </section>
    </div>
  );
}

key={i} にしているのは、並び順が絶対に変わらない固定の配列だからです。理由はkeyの回にあります。

src/index.css を、まるごとこの内容にしてください。

body {
  font-family: sans-serif;
  margin: 0;
  padding: 24px;
  background: #fff;
  color: #222;
}

button {
  font-size: 16px;
  padding: 6px 14px;
  margin-bottom: 8px;
}

.stage {
  position: relative;
  height: 620px;
  border: 1px solid #ccc;
  overflow: hidden;
}

.box {
  position: absolute;
  left: 0;
  width: 40px;
  height: 6px;
  background: #3a7;
}

/* A: レイアウトを動かす版 */
.stage.a .box {
  transition: left 1s ease-out, width 1s ease-out;
}
.stage.a.on .box {
  left: 600px;
  width: 120px;
}

/* B: 合成だけで済む版 */
.stage.b .box {
  transition: transform 1s ease-out, opacity 1s ease-out;
}
.stage.b.on .box {
  transform: translateX(600px) scaleX(3);
  opacity: 0.3;
}

この2つは、見た目としてはほぼ同じ動きです。 300本の線が右へ600px動いて、横に伸びる。それだけです。

測る — Performance タブ

ホストのブラウザで F12 を押し、Performance タブを開きます。

まず、fpsを常時表示させます。

  1. F12 を開いた状態で、右上の「⋮」→ More tools → Rendering
  2. 「Frame Rendering Stats」(版によっては「FPS meter」)にチェック

画面の右上に、fpsの数字と小さなグラフが出ます。

そのうえで、次の順番でやってください。

  1. Performance タブの丸い録画ボタンを押す
  2. 「Aを動かす」を1回押す
  3. 動きが終わったら録画を止める

同じことを B でもやります。 必ず別々に録画してください。並行して動かすと、どちらの負荷か分からなくなります。

何を見るか

見るところは3つだけです。

見る場所Aで起きることBで起きること
右上のfps表示数字が落ちる。環境によっては20〜40fps台まで下がる60fps付近を保つ(画面のリフレッシュレートが上限)
Summary の円グラフRendering(紫)が大きく膨らむ紫がほとんど無い。Painting も小さい
Main の帯の中身Recalculate Style と Layout が、フレームの数だけ並ぶ同じ帯がほぼ空。動いている1秒間、Main がひまをしている

[スクリーンショット: 01_A版のレイアウト帯.png] A を録画したあとの Performance タブを撮ってください。Main の行に紫の Layout が等間隔でびっしり並んでいるところが写る形で。Summary の円グラフで Rendering の割合が大きいのも一緒に入れてください。

[スクリーンショット: 02_B版の同じ場所.png] 同じ倍率・同じ位置で、B を録画したあとの Performance タブを撮ってください。同じ1秒間なのに Main がほとんど空であることが、01と並べて分かる形で。

なぜこうなるのか — 3段階の話

ブラウザが画面を1枚描くまでには、大きく3つの段階があります。

段階やることいつ走るか
① レイアウトどの要素がどこに、どの大きさで置かれるかを計算するleft top width height margin padding などを変えたとき
② ペイント決まった箱に色・文字・影・枠を塗るbackground color box-shadow などを変えたとき(①のあとにも走る)
③ 合成塗り終わった絵をレイヤーとして重ねる常に最後に走る

ここが山場です。

left や width を変えると、①レイアウトからやり直しになります。 transform と opacity を変えると、③合成だけで済みます。

そして①は「その要素だけ」では済みません。 1本の線が右へずれたことで、その周りの要素の位置が変わるかもしれないからです。ブラウザはそれを確かめないといけません。300本あれば、300本ぶん確かめます。それを1秒間に60回やります。

transform は違います。 これは「すでに置き終わった絵を、あとから何ミリかずらして表示する」という指示です。周りの要素にとって、その要素は元の場所にいるままです。 だから確かめ直す必要がありません。

width を動かしたくなったときも同じです。 scaleX() で代用できないか、先に考えてください。

合言葉: 動かしていいのは transform と opacity の2つだけ。 それ以外を動かしたくなったら、まず「本当にそれでないと駄目か」を疑う。

数で確かめる

印象ではなく数字で残しておきます。 Performance タブの録画を選んだ状態で、下の Bottom-Up タブを開くと、A では Layout と Recalculate Style が上位に並び、B ではそもそも上位に来るほどの処理がありません。

ここで大事なのは、絶対値ではありません。 見るのは「同じ環境で、AとBがどれだけ違うか」です。


② まず CSS だけでやる

プロパティの話が済んだので、次は道具です。

結論から言います。

ホバー・押した感じ・出てくる動き。この9割は、CSSだけで足ります。ライブラリは要りません。

transition — 2点間をつなぐ

transition は「値が変わったとき、間を勝手に補間してくれ」という指示です。

src/index.css の末尾に追記してください。

.card {
  width: 200px;
  padding: 16px;
  margin: 16px 0;
  border: 1px solid #ccc;
  border-radius: 8px;
  background: #fff;
  /* 動かすプロパティを、明示的に列挙する */
  transition: transform 0.2s ease-out, opacity 0.2s ease-out,
    box-shadow 0.2s ease-out;
}

.card:hover {
  transform: translateY(-4px);
  box-shadow: 0 6px 16px rgba(0, 0, 0, 0.15);
}

.card:active {
  transform: scale(0.97);
  transition-duration: 0.06s;
}

src/App.jsx の <h1> の下に、これを足して確認してください。

<div className="card">ホバーしてください。押しても反応します。</div>

マウスを乗せると少し浮き、押すと少し縮みます。 これが「押した感じ」の正体です。JSは1行も書いていません。

ここで1つ、罠があります。

/* やってはいけない */
transition: all 0.2s;

all は「変わったもの全部」を補間します。 便利に見えますが、自分が意図していないプロパティまで動くようになります。 クラスを1つ足しただけで height が補間されて、カクつきの原因が探せなくなります。

transition は、動かすプロパティを必ず名指しする。

:active の transition-duration を短くしているのも意図があります。押した瞬間の反応が0.2秒遅れると、人は「反応していない」と感じます。 戻りはゆっくりでよく、行きは速い。これが「押した感じ」のコツです。

@keyframes — 途中の通過点を決める

transition は A から B へ一直線です。 「一度大きくなってから戻る」のような途中の通過点は表現できません。そこで @keyframes です。

src/index.css の末尾に追記します。

@keyframes fade-up {
  from {
    opacity: 0;
    transform: translateY(12px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

@keyframes pop {
  0% {
    transform: scale(1);
  }
  40% {
    transform: scale(1.15);
  }
  100% {
    transform: scale(1);
  }
}

.fade-up {
  animation: fade-up 0.3s ease-out both;
}

.pop {
  animation: pop 0.35s ease-out;
}

both は「開始前は from の見た目、終了後は to の見た目を保つ」という指定です。これを書かないと、アニメーションが始まる前の一瞬だけ、要素が完成形で表示されてからガクッと戻るという、いちばん格好悪い現象が起きます。

src/App.jsx に足して確認します。

<div className="card fade-up">読み込んだときに、ふわっと出てきます</div>

リロードすると、下からふわっと出てきます。

順番にずらす

「カードが1枚ずつ、順番に出てくる」も CSS だけでできます。 animation-delay を要素ごとにずらすだけです。

{[0, 1, 2, 3].map((i) => (
  <div
    key={i}
    className="card fade-up"
    style={{ animationDelay: `${i * 60}ms` }}
  >
    カード {i + 1}
  </div>
))}

60ミリ秒ずつずらすと、はっきり「順番に出てきた」と分かります。 ここまで、ライブラリは0個です。

CSSで足りる範囲を、はっきり書いておく

やりたいことCSSだけでできるか
ホバーで浮く・色が変わるできる(transition)
押したときに縮むできる(:active)
読み込み時にふわっと出すできる(@keyframes + both)
順番にずらして出すできる(animation-delay)
ぐるぐる回る読み込み表示できる(@keyframes + infinite)
アコーディオンの開閉だいたいできる(grid-template-rows の 0fr → 1fr)
要素が消えるときの動きできない
ドラッグして動かすできない(JSが要る)
複数の動きを厳密に順番に並べるつらい(delay の手計算になる)

下の3つに行き当たって、初めてライブラリを考えます。


③ CSSの限界 — 消えるときだけ効かない

これが、ライブラリを入れる最初の理由です。 実際に再現します。

再現する

src/App.jsx に、開閉するパネルを足します。

const [open, setOpen] = useState(false);

// return の中
<section>
  <h2>消えるときの動き</h2>
  <button onClick={() => setOpen((v) => !v)}>
    {open ? "閉じる" : "開く"}
  </button>
  {open && <div className="card fade-up">出たり、消えたりします</div>}
</section>

「開く」を押してください。ふわっと出ます。ここまでは思ったとおりです。

「閉じる」を押してください。

一瞬で消えます。 フェードアウトも、縮みもしません。パチンと消えます。

なぜか

CSSのせいではありません。Reactの動きが正しすぎるせいです。

{open && <div className="card fade-up">…</div>}

open が false になった瞬間、React はこの <div> をDOMから外します。

アニメーションは、DOMに存在する要素にしか当たりません。 つまり:

「消えるアニメーション」を書きたいのに、Reactは先に消してしまっている。 CSSの限界ではなく、「消える前に少し待つ」という仕組みが無いのが問題。

自力でやろうとすると、どうなるか

やってみると分かります。 必要なのは「閉じるボタンを押しても、すぐには消さず、アニメーションが終わってから消す」という段取りです。

const [open, setOpen] = useState(false);
const [rendered, setRendered] = useState(false);

useEffect(() => {
  if (open) {
    setRendered(true);
  } else {
    const t = setTimeout(() => setRendered(false), 300); // CSSの0.3sと手で合わせる
    return () => clearTimeout(t);
  }
}, [open]);

{rendered && (
  <div className={open ? "card fade-in" : "card fade-out"}>…</div>
)}

動きます。動きますが、こうなります。

  • 状態が2つになった(「開いているか」と「DOMにあるか」)
  • 300 という数字を、CSSとJSの2箇所に書いた。 片方だけ直すと壊れる
  • アニメーション中にもう一度ボタンを押されると、タイマーが噛み合わない
  • これを、消える要素の種類だけ書くことになる

リストの項目が1つずつ消える画面でやると、さらに増えます。「消えた項目のぶん、下の項目が上に詰める動き」も自分で書くことになるからです。

ここが分岐点です。 ここまでは CSS で足りていた。ここから先は、道具を入れたほうが確実に短い。


④ Framer Motion(motion)を入れる

まず、名前の話をしておきます。 かつて framer-motion という名前だったライブラリは、現在 motion という名前で公開されています。 記事や本によってどちらの名前も出てきますが、同じ系列のものです。

入れる

VMの中で打ちます。開発サーバーを止めなくても入りますが、入れたあと Vite が自動で再起動することがあります。

bash
$ cd ~/anilab
$ npm install motion
added 3 packages, and audited 220 packages in 3s

initial / animate / exit

src/FadePanel.jsx(新規)

import { useState } from "react";
import { AnimatePresence, motion } from "motion/react";

export default function FadePanel() {
  const [open, setOpen] = useState(false);

  return (
    <section>
      <h2>Framer Motion 版</h2>
      <button onClick={() => setOpen((v) => !v)}>
        {open ? "閉じる" : "開く"}
      </button>

      <AnimatePresence>
        {open && (
          <motion.div
            className="card"
            initial={{ opacity: 0, y: 12 }}
            animate={{ opacity: 1, y: 0 }}
            exit={{ opacity: 0, y: 12 }}
            transition={{ duration: 0.25, ease: "easeOut" }}
          >
            出るときも、消えるときも動きます
          </motion.div>
        )}
      </AnimatePresence>
    </section>
  );
}

src/App.jsx で読み込んで表示してください。

import FadePanel from "./FadePanel";
// return の中に <FadePanel />

「閉じる」を押してください。今度は、ふわっと消えます。

何が起きたのか

3つの部品が働いています。

部品役割
motion.divただの <div> に、アニメーションの指示を受け取る口を足したもの。中身も className も普通の div と同じに書ける
initial / animate現れる前の状態と、現れたあとの状態
exit消えるときの状態
AnimatePresenceこれが本体。中の要素がReactから消されそうになったとき、exit が終わるまでDOMに留め置く

exit だけ書いても効きません。AnimatePresence で囲んでいないと、Reactは今までどおり即座に消します。

③で自分が手で書こうとした「消す前に待つ」を、AnimatePresence が全部やっています。 状態も、タイマーも、途中で押し直された場合の処理も、こちら側には出てきません。

y: 12 と書いていますが、実際に当たるのは transform: translateY(12px) です。 ①でやったとおり、合成だけで済むプロパティが選ばれています。ここは意識しなくても、そうなるように作られています。

[スクリーンショット: 03_exitが効いている.png] 「閉じる」を押した途中の瞬間を撮ってください。カードが半分透けて、少し下にずれているところが写る形で。CSS版ではこの瞬間が存在しないことと対比させたいので、③のパネルと同じ画面に並べて撮れるとより良いです。

layout を1つだけ触る

Framer Motion で「これは他では書けない」と感じるのが layout です。

要素の位置や大きさが変わったとき、その差を自動でアニメーションにします。

src/LayoutDemo.jsx(新規)

import { useState } from "react";
import { motion } from "motion/react";

export default function LayoutDemo() {
  const [items, setItems] = useState(["りんご", "みかん", "ぶどう", "もも"]);

  const remove = (name) => setItems((list) => list.filter((x) => x !== name));

  return (
    <section>
      <h2>layout(詰める動き)</h2>
      <ul style={{ listStyle: "none", padding: 0, width: 240 }}>
        {items.map((name) => (
          <motion.li
            key={name}
            layout
            className="card"
            onClick={() => remove(name)}
            style={{ cursor: "pointer" }}
          >
            {name}(クリックで消す)
          </motion.li>
        ))}
      </ul>
      <button onClick={() => setItems(["りんご", "みかん", "ぶどう", "もも"])}>
        戻す
      </button>
    </section>
  );
}

真ん中の項目をクリックしてください。

消えた項目のぶん、下の項目が「すーっ」と上に詰めます。 パチンと詰めるのではなく、移動として見えます。

書いたのは layout の5文字だけです。 これを CSS で書くには、消える前の全項目の座標を測り、消したあとの座標を測り、その差を transform で当てて0に戻す、という手順が要ります。

layout は「CSSでは書けない」の代表例です。 ただし、これはレイアウトを測る処理なので、ただではありません。 何十個にも付けると重くなります。必要な場所にだけ付けてください。

key={name} にしていることに注目してください。添字だと、消したときにReactが「別の項目に変わった」と誤解します。 keyの回でやった話が、ここで効いてきます。


⑤ react-spring を入れる — 時間ではなく物理

次は、考え方が違う道具です。

入れる

bash
$ cd ~/anilab
$ npm install @react-spring/web

書く

src/SpringDemo.jsx(新規)

import { useState } from "react";
import { animated, useSpring } from "@react-spring/web";

export default function SpringDemo() {
  const [right, setRight] = useState(false);

  const style = useSpring({
    transform: right ? "translateX(300px)" : "translateX(0px)",
    config: { tension: 170, friction: 12 },
  });

  return (
    <section>
      <h2>react-spring 版</h2>
      <button onClick={() => setRight((v) => !v)}>動かす</button>
      <animated.div className="card" style={style}>
        バネで動きます
      </animated.div>
    </section>
  );
}

ボタンを押してください。 右へ動いて、行き過ぎて、少し戻って、止まります。

ここが違う

duration(何秒で)を、1つも書いていません。

書き方指定するもの止まる時刻
時間ベース(CSS / Framer Motion の duration)何秒かけて、どんな速度変化でこちらが決める
物理ベース(react-spring)バネの硬さ(tension)と摩擦(friction)結果として決まる。指定できない

config の数字を変えて、実際に確かめてください。

設定見え方
{ tension: 170, friction: 12 }勢いよく行き過ぎて、1回戻って止まる
{ tension: 170, friction: 26 }行き過ぎずに、すっと止まる
{ tension: 300, friction: 10 }速くて、何度も揺れる
{ tension: 60, friction: 20 }ゆっくり、じわっと

保存するたびにブラウザが更新されるので、数字を変えては押す、を何度かやってみてください。 表を読むより、手で1回動かしたほうが早い部分です。

同じ動きを、両方で書いて比べる

Framer Motion にもバネはあります。 transition に type: "spring" を渡すだけです。

<motion.div
  className="card"
  animate={{ x: right ? 300 : 0 }}
  transition={{ type: "spring", stiffness: 170, damping: 12 }}
>
  こちらもバネ
</motion.div>

この2つを同じ画面に並べて、同時に押してください。 ほとんど同じに見えます。違うのは、どちらを「標準の考え方」に置いているかです。

Framer Motionreact-spring
標準時間(duration)。バネは選ぶものバネ。時間指定は例外扱い
止まり方の記述ease の名前で選ぶtension と friction の数字で作る
書き味JSXの属性として宣言的(initial / animate)フックが style を返す(useSpring)

なぜ「止まる時刻を指定できない」のが良いことになるのか

最初は、これが欠点に見えました。 「0.3秒で止めたいのに、なぜ指定できないのか」と。

分かったのは、途中で行き先が変わったときです。

時間ベースは、動いている途中でもう一度ボタンを押されると困ります。 「0.3秒かけて右へ」の途中で「左へ」と言われると、現在位置から新しい0.3秒が始まって、速度が不連続に切り替わります。 カクッと見えます。

バネは、いまの速度を持ったまま行き先だけ差し替えられます。 物理なので、連続します。 ドラッグ中に指を離す、のような人の操作に追従する動きで差が出ます。


⑥ GSAP に触れる — Reactの外側でDOMを動かす

3つ目は、性格がかなり違います。

GSAP は React 専用の道具ではありません。 React が無かった時代からある、DOMを直接動かすためのライブラリです。だから、React と組み合わせるときに気をつけることがあります。

入れる

bash
$ cd ~/anilab
$ npm install gsap

タイムライン — 複数の動きを順番に組む

GSAP がいちばん強いのはここです。

src/GsapDemo.jsx(新規)

import { useEffect, useRef } from "react";
import gsap from "gsap";

export default function GsapDemo() {
  const rootRef = useRef(null);

  useEffect(() => {
    const ctx = gsap.context(() => {
      const tl = gsap.timeline();
      tl.from(".g-title", { y: -20, opacity: 0, duration: 0.3 })
        .from(".g-line", { x: -30, opacity: 0, duration: 0.3, stagger: 0.08 })
        .from(".g-btn", { scale: 0.8, opacity: 0, duration: 0.25 }, "-=0.1");
    }, rootRef);

    return () => ctx.revert(); // ⚠️ ここが本題
  }, []);

  return (
    <section ref={rootRef}>
      <h2 className="g-title">GSAP 版</h2>
      <p className="g-line">1行目</p>
      <p className="g-line">2行目</p>
      <p className="g-line">3行目</p>
      <button className="g-btn">最後に出るボタン</button>
    </section>
  );
}

リロードすると、見出し → 3行が順番に → ボタン、の順で出てきます。

読みどころは、この形です。

tl.from(A).from(B).from(C, "-=0.1");
  • .from() をつなげるだけで、順番に実行される
  • stagger: 0.08 で、同じクラスの要素が80ミリ秒ずつずれて動く
  • "-=0.1" は「前の動きの終わり0.1秒前から始めろ」という指定。少し重ねると自然に見える

これを CSS の animation-delay でやると、全部の秒数を手で足し算することになります。 1つ足したら、後ろ全部を書き直しです。 タイムラインなら、行を1つ挿すだけで後ろが自動でずれます。

後片づけを書かないと二重に動く

useEffect の戻り値に ctx.revert() を書いています。ここが本題です。

わざと外して、何が起きるか見てください。

// 一時的に、この行をコメントアウトする
// return () => ctx.revert();

保存してリロードしてください。

開発モードでは、Reactはコンポーネントを意図的に2回マウントします(StrictMode が入っているためです)。その結果:

  • アニメーションが2重に走る
  • from の指定が2回積み重なって、要素が変な位置で止まる
  • 場合によっては、要素が消えたまま戻ってこない

もっと分かりやすく見るには、相対値で試してください。

useEffect(() => {
  gsap.to(".g-btn", { x: "+=200", duration: 0.5 });
  // 後片づけ無し
}, []);

+=200 は「いまの位置から200px右へ」です。 1回なら200px。2回走れば400pxです。

画面を見ると、ボタンは400px動いています。 「なぜか指定の2倍動く」という、原因が非常に分かりにくいバグの正体がこれです。

[スクリーンショット: 04_後片づけ無しで2倍動く.png] +=200 の版で、ボタンが想定の倍の位置に来ているところを撮ってください。F12 の要素タブで、その要素の style に translate(400px, 0px) が入っているのが一緒に写ると、何が起きたか一目で分かります。

確認できたら、return () => ctx.revert(); を必ず戻してください。

なぜ React だけこうなるのか

GSAP は「DOMを直接、命令的に書き換える」道具です。React は「状態から画面を組み立てる」仕組みです。この2つは、同じ要素の見た目について別々の意見を持ちます。

誰が要素の style を決めるか
React状態から毎回組み立て直す
GSAPいま画面にある要素を、直接書き換える

だから、次の2つがセットで必要になります。

  1. useRef で対象を掴む(クラス名でページ全体を検索させない。詳しくはuseRefの回)
  2. useEffect の戻り値で後片づけする(ctx.revert() が、GSAPが当てた style を全部剥がして元に戻す)

gsap.context(fn, rootRef) の第2引数が効いているのもここです。これを渡すと、中の .g-line などの検索が rootRef の中だけに限定されます。 渡さないと、ページ内の同名クラスを全部拾います。 同じコンポーネントを2つ置いた瞬間に壊れます。

なお、GSAP には React 用の useGSAP フックが公式に用意されています。 これを使うと、上の2つを自動でやってくれます。やっていることは同じなので、まず手で書いてから使うほうが、何が起きているか分かります。


⑦ 4つを並べる

バンドルサイズを、自分で測る

表を読む前に、実際の数字を出します。 本線のビルドの回でやった npm run build です。

VMの中で打ちます。

bash
$ cd ~/anilab
$ npm run build
$ ls -lh dist/assets/
-rw-rw-r-- 1 ubuntu ubuntu 1.4K Sep 29 11:20 index-9a3f1c2b.css
-rw-rw-r-- 1 ubuntu ubuntu 380K Sep 29 11:20 index-4d7e88a1.js

いま3つ全部入っているので、大きいです。 使っていないものを import から外して、もう一度 npm run build してください。外すたびに減ります。

ビルドの最後に出る表も見てください。

dist/assets/index-4d7e88a1.js   380.12 kB │ gzip: 121.44 kB

見るのは右の gzip: のほうです。 実際に回線を流れるのは圧縮後だからです。

自分の環境で出た数字を、必ず1回は見てください。 記事に書いてある数字は、版によって変わります。

対比表

CSSFramer Motionreact-springGSAP
向いている用途ホバー・押した感じ・出てくる動き・くるくる回る読み込みReactの中の状態と連動する動き。消えるとき・並び替え・ページ切り替え人の操作に追従する動き。ドラッグ・引っ張って離す順番に組む演出。読み込み時のイントロ・スクロール連動
バンドルサイズ0(CSSに書くだけ)中〜大(3つの中では大きめ。必要な機能だけ読む書き方はある)中中(コアだけなら比較的小さい。プラグインを足すと増える)
学習コスト低。ただし①の知識が要る低〜中。initial / animate / exit の3つで大半が書ける中。バネの数字の感覚を掴むまでが山中〜高。React 側の作法(ref・後片づけ)を別途覚える
Reactとの相性問題なし(クラスを付け外しするだけ)いちばん良い。React前提で作られている良い。フックとして自然に収まる注意が要る。ref と後片づけを自分で管理する
消えるときの動きできないAnimatePresence で解決useTransition で可能自分で組む
止まり方の指定時間とイージング時間 or バネ(選べる)バネのみ時間とイージング(豊富)

選び方を1行で

CSSで書けるなら CSS。 消えるときや並び替えが要るなら Framer Motion。 人の指に追従させたいなら react-spring。 演出を順番に組みたいなら GSAP。

そして、ほとんどの個人開発は1行目で終わります。

3つ全部入れることは、まずありません。 同じ目的の道具を複数入れると、バンドルサイズが増えるだけでなく、同じ要素を2つのライブラリが取り合って、原因不明の動きになります。


⑧ 忘れられがちな2つ

ここまでは「どうやって動かすか」でした。最後は「動かしていいのか」です。

1. 動きが苦手な人がいる

画面の動きで、気分が悪くなる人がいます。 前庭障害や片頭痛のある人にとって、大きくスライドする動き・視差効果・回転は、実際に体調に影響します。

OSには、そのための設定があります。

OS場所
Windows 11設定 → アクセシビリティ → 視覚効果 → 「アニメーション効果」をオフ
macOSシステム設定 → アクセシビリティ → ディスプレイ → 「視差効果を減らす」
iOS / Androidアクセシビリティの中に同様の項目

ブラウザは、この設定を CSS から読めるようにしてくれています。

src/index.css の末尾に追記してください。

@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}

「動きを消す」のではなく「限りなく短くする」のがコツです。完全に none にすると、アニメーションの終了イベントを待っているJSが、永遠に待つことがあります。

実際に切り替えて確かめる

OSの設定を変えなくても、DevTools から試せます。

  1. F12 → 「⋮」→ More tools → Rendering
  2. Emulate CSS media feature prefers-reduced-motion を reduce にする

この状態で、②③④で作った全部を触ってください。

[スクリーンショット: 05_動きを減らした状態.png] DevTools の Rendering パネルで prefers-reduced-motion: reduce を選んでいるところと、その状態で開閉パネルを押しても瞬時に切り替わるところを撮ってください。設定項目と画面が同時に写る形で。

ライブラリ側でも尊重する

上のCSSは、JSでインラインstyleを書き換えるライブラリには効きません。 transition-duration を見ていないからです。それぞれの方法で尊重します。

Framer Motion には専用のフックがあります。

import { useReducedMotion, motion } from "motion/react";

function Panel() {
  const reduce = useReducedMotion();

  return (
    <motion.div
      initial={{ opacity: 0, y: reduce ? 0 : 12 }}
      animate={{ opacity: 1, y: 0 }}
      exit={{ opacity: 0, y: reduce ? 0 : 12 }}
      transition={{ duration: reduce ? 0 : 0.25 }}
    />
  );
}

注目してほしいのは、opacity は残していることです。

「動きを減らす」は「変化を全部消す」ではありません。 位置が大きく動くのをやめて、透明度の変化だけ残す。 これが正しい減らし方です。何が起きたかは伝わり、体には来ません。

react-spring と GSAP は、標準のAPIで判定します。

const reduce = window.matchMedia("(prefers-reduced-motion: reduce)").matches;

これを duration: reduce ? 0 : 0.5 のように使います。

この話はアクセシビリティの回の続きです。 キーボードで操作できることと同じで、好みの問題ではありません。

2. 動きには意味を持たせる

もう1つは、技術ではなく設計の話です。

動きを付けられるようになると、全部に付けたくなります。自分がそうでした。 ホバーで浮き、押すと縮み、出てくるときに回り、スクロールで横から入ってくる。

1週間後に自分のサイトを見て、こう思いました。

「読みにくい」

動きは、注意を引きます。それが仕事です。 だから、注意を引く必要がないところに付けると、注意を奪うだけになります。

判断表にします。

その動きは何を伝えているか付けてよいか
状態が変わった(開いた・閉じた・削除された)付ける。何が起きたか分かる
どこから来て、どこへ行ったか(一覧 → 詳細)付ける。位置関係が伝わる
押されたことが伝わっていない付ける。反応が無いと人はもう一度押す
待っていることを伝える(読み込み中)付ける。止まっているのか動いているのかが分かる
視線をそこへ誘導したい(エラーが出た場所)付ける(ただし1回だけ)
格好いいから付けない
ページを開くたびに全要素が動く付けない。2回目以降は邪魔でしかない
無限に動き続ける装飾付けない。読んでいる横で常に動くものは、読書を妨げる

もう1つ、時間の目安です。

用途長さの目安
ホバー・押した感じ0.1〜0.15秒
小さい要素の出入り0.2〜0.3秒
画面全体の切り替え0.3〜0.4秒
0.5秒を超えるもの待たされていると感じる。理由が無いなら短くする

迷ったら CSS。ライブラリは、CSS で書けないと分かってから。 そして、その動きが何を伝えているか言えないなら、付けない。


つまずいたところ

transition: all にして、原因が探せなくなった

最初は全部 all で書いていました。 クラスを1つ足した瞬間に画面がカクつくようになり、どのプロパティが補間されているのか分からなくなりました。

all は、自分が知らないプロパティまで拾います。 名指しに直したら、カクつきの原因が height だと3分で分かりました。

left を transform に直したら、レイアウトが崩れた

「置き換えればいい」と思って機械的に直したら、要素が重なりました。

当然でした。 transform は周りに影響しないのが利点です。つまり、「動かした結果、周りが避けてくれる」ことを期待していた場所では、代わりになりません。

動かした要素のぶんだけ他が動いてほしいなら、それはレイアウトの変更です。 ①の意味では「重い側」ですが、それが仕様なら仕方ありません。 そのときは、動かす要素の数を減らすか、Framer Motion の layout に任せます。

exit を書いたのに効かず、30分探した

AnimatePresence で囲むのを忘れていました。

{/* これでは効かない */}
{open && <motion.div exit={{ opacity: 0 }} />}

エラーも警告も出ません。 ただ静かに、今までどおりパチンと消えます。

さらにもう1つ罠があって、AnimatePresence の直下の子要素には key が要ります。 中身を入れ替える使い方(タブの切り替えなど)で key を付け忘れると、Reactが「同じ要素の中身が変わっただけ」と判断して、exit が走りません。

AnimatePresence の中で条件を外側に書いてしまった

これも効きませんでした。

{/* 効かない: AnimatePresence 自体が消える */}
{open && (
  <AnimatePresence>
    <motion.div exit={{ opacity: 0 }} />
  </AnimatePresence>
)}

AnimatePresence が「子が消えるのを見届ける」役です。 その AnimatePresence 自体が一緒に消えたら、見届ける人がいません。 条件は必ず AnimatePresence の内側に置きます。

react-spring の数字を「秒」だと思って読んでいた

tension: 170 を見て「170ミリ秒くらいか」と思っていました。全く違いました。

tension はバネの硬さ、friction は摩擦です。 秒ではありません。単位のない、感覚の数字です。 表で覚えるより、実際に4つくらい試して「硬い・柔らかい」を体で覚えるほうが早いと分かりました。

GSAP を入れた画面が、開発中だけ2倍動いた

⑥で書いたとおりです。 後片づけを書いていませんでした。

厄介だったのは、npm run build して本番モードで動かすと再現しないことです。StrictMode は開発時だけの機能だからです。

「開発中だけおかしい。ビルドすれば直る」で済ませたくなりました。 それは間違いです。StrictMode は、後片づけを書き忘れているコードをわざと炙り出すための仕組みです。炙り出された側を直すのが正解です。同じ話がuseEffectの回にも出てきます。

アニメーションを付けたら、再描画のたびに最初から動き直した

リストの1行にフェードインを付けたら、親が再描画されるたびに全行がもう一度フェードインしました。

原因は key でした。 添字を key にしていたため、要素が入れ替わったと判断されて、作り直されていました。 作り直された要素は、当然また initial から始まります。

アニメーションのバグに見えて、実体は key の話でした。 keyの回の内容が、ここで効いてきます。

VMの中のブラウザで測って、数字を信用しかけた

最初、VM側で計測しようとしました。 VMのブラウザはGPUの支援が弱く、BのほうもfpsがAと大差ないように見えました。

ホストのブラウザで測り直したら、はっきり差が出ました。

性能の計測は、測る環境がそのまま結果に出ます。 どちらが正しいというより、「AとBを同じ環境で比べる」ことだけが意味を持ちます。 環境をまたいで数字を比べてはいけません。


後片づけ

開発サーバーを止める

VMのターミナルで Ctrl+C。

^C

ポートを閉じる

開けっぱなしにしません。

bash
$ sudo ufw delete allow 5186/tcp
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
5173/tcp                   ALLOW       Anywhere

5186/tcp の行が消えていれば成功です。

プロジェクトを消す

この記事で作ったものは、全部 ~/anilab の中にあります。

bash
$ cd ~
$ ls
anilab  react-demo

消す前に、必ず ls で確認してください。 ~/react-demo は本線で使っているものです。残します。

bash
$ rm -rf ~/anilab
$ ls
react-demo

react-demo だけが残っていれば完了です。rm -rf は戻せません。打つ前に、パスをもう一度読んでください。

DevTools の設定を戻す

⑧で prefers-reduced-motion を reduce にしたままだと、他のサイトも動かなくなって混乱します。

F12 → Rendering パネル → prefers-reduced-motion を No emulation に戻してください。Frame Rendering Stats のチェックも外しておくと、次に開いたときに驚きません。


まとめ — 理解できたこと

  • カクつきの原因はライブラリではなく、「どのプロパティを動かしたか」だった。 left を transform に直すだけで、300個でも滑らかになった
  • ブラウザの描画は レイアウト → ペイント → 合成 の3段階。 transform と opacity は最後の1段だけで済むから速い
  • left を動かすと、その要素だけでなく周りの位置まで計算し直しになる。 transform は周りに影響しないから、計算し直す必要がない
  • 測ってから直す。 Performance タブの Layout の帯が並んでいるかどうかで、推測せずに判断できる
  • ホバー・押した感じ・出てくる動き・順番にずらす。ここまでは全部 CSS で足りた。 ライブラリは1つも要らなかった
  • transition: all は書かない。 動かすプロパティは必ず名指しする。書かないと、原因が探せなくなる
  • CSSにはっきり足りないものは「消えるときの動き」1つだった。 Reactが先にDOMから外すため、CSSの問題ですらなかった
  • それを自力で書くと、状態が2つ・秒数が2箇所・タイマーの噛み合わせ、と一気に増える。 ここがライブラリを入れる分岐点
  • Framer Motion の AnimatePresence は「消える前に待たせる」係。 exit だけ書いても効かない
  • layout の5文字で「詰める動き」が出る。 これは CSS では現実的に書けない。ただし、レイアウトを測る処理なので、ただではない
  • react-spring は考え方が違う。時間ではなく、バネの硬さと摩擦で指定し、止まる時刻は結果として決まる。 途中で行き先が変わる動きに強い
  • GSAP は React の外側の道具。 useRef で範囲を絞り、useEffect の戻り値で revert() する。書かないと、開発中だけ二重に動く
  • 「開発中だけおかしい、ビルドすれば直る」で済ませない。 StrictMode は、後片づけ忘れをわざと炙り出す仕組み
  • prefers-reduced-motion は好みではなくアクセシビリティ。 ただし「全部消す」ではなく、大きな移動をやめて透明度だけ残すのが正しい減らし方
  • 動きには意味を持たせる。 何を伝えているか言えない動きは、注意を奪うだけになる
  • 迷ったら CSS。ライブラリは、CSS で書けないと分かってから

参考リンク


次に読む

この記事は 【深掘り】React の 22 / 24 本目です。

記事
← 前の記事SSRとSSGのフレームワーク — SNSに貼るとタイトルが出ない
→ 次の記事GraphQLクライアント — 一覧を出すのにAPIを4回叩く

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

›React — Animation
  • transform と opacity だけが安い
  • 消えるときのアニメーションが CSS の限界

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次