CSSのanimation-fill-modeで前後の見た目を決める方法
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 は指定していません。
@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 の四角は終わると灰色になり、左端へ戻りました。

画像は、ボタンを押す動き(カーソルとボタンの表示)をスクリプトで再現して撮りました。アニメーションは止めておき、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 属性で同じプロパティを変えても、見た目が変わりません。
通知を薄くして消すアニメーションで試しました。
@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 クラスに移しています。
@keyframes fadeout {
from { opacity: 1; }
to { opacity: 0; }
}
.toast {
opacity: 1;
}
.toast.hiding {
animation: fadeout 0.2s linear forwards;
}
.toast.hidden {
opacity: 0;
}
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 から使えます。





