CSSのanimation-fill-modeで前後の見た目を決める方法

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

CSS アニメーションは、ふつうは動いている間だけ効きます。動き出す前の待ち時間と、動き終わった後は、要素のふだんのスタイルで表示されます。animation-fill-mode を指定すると、その前と後にも、キーフレームの値を当てられます。フェードアウトが終わった瞬間に要素が元の濃さに戻ってしまう、フェードインの待ち時間のあいだに要素が見えてしまう、といったときに使うプロパティです。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。4つの値や、向き・回数による違いは、アニメーションを止めて再生位置(currentTime)を決めた時点に動かし、getComputedStyle() の値を読んで調べました。あとから当てたスタイルの効き方は、実際に再生して調べました。Firefox と Safari、スマートフォンの実機、JavaScript の Web Animations API の fill オプションは試していません。

4つの値で、前と後の見た目がどう変わるか

animation-fill-mode の値は none(初期値)、forwards、backwards、both の4つです。CSS Animations の仕様では、forwards が終わった後、backwards が animation-delay の待ち時間のあいだに、キーフレームの値を当てると決めています。both は両方です。

違いを見るために、右へ 200px 動きながら濃い水色から明るい水色に変わるアニメーションを作り、待ち時間 1 秒、動く時間 1 秒で付けました。要素のふだんの背景色は灰色で、transform は指定していません。

css
@keyframes slide {
  from { transform: translateX(0px); background-color: #067a98; }
  to   { transform: translateX(200px); background-color: #00c8e8; }
}

.box {
  background-color: #9aa5ab;
  animation: slide 1s linear 1s forwards; /* 最後の値を4つの値で入れ替える */
}

アニメーションを付けてから 0.5 秒(待ち時間の途中)、1.5 秒(動いている途中)、2.5 秒(終わった後)の値は次のとおりです。

値 待ち時間の途中 動いている途中 終わった後
none 灰色・移動なし 100px・中間の色 灰色・移動なし
forwards 灰色・移動なし 100px・中間の色 200px・明るい水色
backwards 0px・濃い水色 100px・中間の色 灰色・移動なし
both 0px・濃い水色 100px・中間の色 200px・明るい水色

動いている途中は4つとも同じです。違うのは前と後だけで、none と forwards の四角は待ち時間のあいだ灰色のままで、none と backwards の四角は終わると灰色になり、左端へ戻りました。

アニメーション。上から none、forwards、backwards、both の4本のレーンに灰色の四角がある。カーソルが「再生」ボタンを押すと、待ち時間の1秒のあいだ、backwards と both の四角だけが濃い水色に変わる。次の1秒で4つとも右へ動きながら明るい水色に変わる。終わった後は、forwards と both の四角が右端で明るい水色のまま残り、none と backwards の四角は左端の灰色に戻る。クリックの回数と、「待ち時間」「再生中」「終了後」の表示が、切り替わった瞬間だけピンクになる
再生ボタンを押してからの4つの値の動き(待ち時間1秒、動く時間1秒)

画像は、ボタンを押す動き(カーソルとボタンの表示)をスクリプトで再現して撮りました。アニメーションは止めておき、50 ミリ秒ずつ再生位置を進めて1コマずつ撮っています。

フェードインに待ち時間を付けるときは、backwards か both にしないと、待っているあいだは from の透明な状態にならず、ふだんのスタイルのまま見えてしまいます。このあとは、終わった後に残る値を中心に見ていきます。

forwards で残るのは、最後に通ったキーフレーム

forwards が残すのは、いつも to の値とは限りません。MDN の animation-fill-mode のページにあるとおり、animation-direction と animation-iteration-count で、最後に通るキーフレームが変わります。検証環境で、終わった後に残った値は次のとおりでした。

方向と回数 終わった後の位置
normal で 1 回、2 回 200px(to)
reverse で 1 回 0px(from)
alternate で 2 回 0px(from)
alternate で 3 回 200px(to)
normal で 1.5 回 100px(途中の値)
normal で 0 回 0px(from)

alternate で往復させると、偶数回のときは行って戻ってくるので from の値で止まります。回数に 1.5 のような小数を書くと、2 回目の半分で終わり、その途中の値が残りました。回数が 0 のときに from の値が残るのは、仕様で、backwards と同じく 1 回目の始まりの値を当てると決められているためです。

backwards で待ち時間に当たる値も、向きで変わります。reverse と alternate-reverse では to の値(200px・明るい水色)、normal と alternate では from の値でした。

forwards で残った値は、あとから当てたスタイルより強い

forwards で止めた値は、終わった後もアニメーションの値として残り続けます。そのため、あとからクラスや style 属性で同じプロパティを変えても、見た目が変わりません。

通知を薄くして消すアニメーションで試しました。

css
@keyframes fadeout {
  to { opacity: 0; }
}

.toast {
  opacity: 1;
  animation: fadeout 0.2s linear forwards;
}

.toast.show {
  opacity: 1;
}

終わった後の opacity は 0 で、el.getAnimations() には playState が finished のアニメーションが1つ残っていました。ここで style.opacity = '1' を設定しても、show クラスを付けても、opacity は 0 のままでした。opacity: 1 !important を当てたときだけ 1 になりました。

これは、CSS Cascade の仕様で、アニメーションの値がふだんの宣言より優先され、!important の宣言より弱いと決められているためです。animation-fill-mode を指定しない版では、終わった後にアニメーションは要素から外れ(getAnimations() が 0 件)、opacity は 1 に戻りました。

注意

あとでクラスやホバーで同じプロパティを変える予定があるなら、forwards や both のアニメーションは、終わった後に外します。外し方は次の節で説明します。

終わったら、最後の値をふだんのスタイルに移す

残ったアニメーションを外すには、animation を none にするか、アニメーションを付けたクラスを外します。検証環境では、style.animation = 'none' にすると getAnimations() が 0 件になり、opacity は 1 に戻りました。

最後の見た目を残したまま外したいときは、animationend イベントでアニメーションのクラスを外し、代わりに最後の値(opacity: 0)を書いたクラスを付けます。ここでは、アニメーションを .toast から .hiding クラスに移しています。

css
@keyframes fadeout {
  from { opacity: 1; }
  to   { opacity: 0; }
}

.toast {
  opacity: 1;
}

.toast.hiding {
  animation: fadeout 0.2s linear forwards;
}

.toast.hidden {
  opacity: 0;
}
ts
const toast = document.querySelector<HTMLElement>('.toast')!;

toast.addEventListener('animationend', () => {
  toast.classList.add('hidden');
  toast.classList.remove('hiding');
});

toast.classList.add('hiding');

検証環境では、animationend の時点で opacity は 0、getAnimations() は 0 件になりました。クラスを付けてから 0.5 秒のあいだ、requestAnimationFrame ごとに記録した opacity は、途中で 1 に戻ることなく 0 で止まりました。このあと hidden を外すと、opacity は 1 に戻ります。.hiding のアニメーションに forwards を付けない版でも、同じ手順で記録したところ、opacity が途中で 1 に戻ったフレームはありませんでした。

一括指定の animation に書くときの注意

animation: slide 1s forwards のように、一括指定の中にも書けます。検証環境では、forwards 1s slide と順番を変えても、名前は slide、animation-fill-mode は forwards と読まれました。

気をつけたいのは、@keyframes の名前に forwards や both のような言葉を使ったときです。animation: 1s both forwards は、animation-fill-mode が both、アニメーションの名前が forwards と読まれました。仕様の一括指定の節でも、ほかのプロパティの値として読める言葉は、そのプロパティの値がまだ出てきていなければ、そちらに割り当てると決めています。@keyframes には、プロパティの値と重ならない名前を付けておくと迷いません。

アニメーションを複数付けたときは、MDN の animation-fill-mode のページにあるとおり、animation-fill-mode: both, forwards のように、animation-name と同じ順に値を並べます。

MDN の互換性データ(@mdn/browser-compat-data 8.1.8)では、接頭辞なしの animation-fill-mode は Chrome 43、Edge 12、Firefox 16、Safari 9、iOS の Safari 9 から使えます。

​Posted by 86