要素をページへ追加した直後や、非表示状態から表示した直後にフェードインさせたいとき、CSSの@starting-styleを使うと「表示される前の開始スタイル」を定義できます。JavaScriptで初期クラスを付け替えなくても、opacityやtransformの開始値をCSSだけで用意できます。まずは表示開始時のトランジションに絞って仕組みを理解しましょう。
@starting-styleとは?
@starting-styleは、要素が前回のスタイル計算では表示されていなかった場合などに、トランジションの開始値として使うスタイルを定義するCSS at-ruleです。通常のtransitionは「変更前のスタイル」が必要ですが、初めて表示される要素にはその値がないため、開始スタイルを別途与えます。
用語解説:starting style
要素が初めて表示されるときに、トランジションの開始地点として一時的に使われるスタイルです。
最小例:表示直後にフェードインする
<div class="notice">保存しました</div>
.notice {
opacity: 1;
transform: translateY(0);
transition: opacity 0.25s, transform 0.25s;
}
@starting-style {
.notice {
opacity: 0;
transform: translateY(8px);
}
}
通常状態はopacity: 1、@starting-styleではopacity: 0にしています。要素が初めて描画されると、開始値から通常値へtransitionできます。
通常のtransitionだけでは足りない理由
transitionは基本的に、前のスタイルと新しいスタイルの差を使って途中の値を補間します。新しくDOMへ追加された要素や、以前は描画されていなかった要素には、比較できる「前のスタイル」がないことがあります。@starting-styleは、その開始地点を明示するための仕組みです。
| 場面 | 通常のtransition | @starting-style |
|---|---|---|
| すでに表示中の色変更 | 使いやすい | 通常は不要 |
| 新しく追加された要素 | 開始値がなく動かない場合がある | 開始値を用意できる |
| 非表示から表示 | 条件によって開始値が不足 | 表示開始側のスタイルを定義できる |
ネストして書く方法
対応するCSS Nesting環境では、対象ルールの中へ@starting-styleをネストして書くこともできます。
.card {
opacity: 1;
transition: opacity 0.25s;
@starting-style {
opacity: 0;
}
}
対象要素と開始スタイルを近くへまとめられるため、コンポーネント単位で管理しやすくなります。
display:noneとの組み合わせは少し別問題
@starting-styleは表示開始時の値を定義できますが、displayそのものを滑らかに切り替える場合は、離散的なプロパティをtransition対象にするための追加設定が必要になることがあります。CSS Transitions Level 2ではtransition-behavior: allow-discreteなども関連します。
.panel {
opacity: 1;
transition: opacity 0.25s;
}
@starting-style {
.panel {
opacity: 0;
}
}
最初は「要素が表示された直後のopacityやtransformを動かす」用途から始め、displayの出入りを両方向で滑らかにする設計は次の段階として分けて学ぶと理解しやすいです。
古いブラウザー向けの考え方
MDNでは@starting-styleをBaseline 2024として案内していますが、古いブラウザーでは利用できない場合があります。未対応でも要素自体は通常状態で表示されるようにし、アニメーションは追加効果として扱う設計が安全です。
.notice {
opacity: 1;
transform: none;
}
@supports (transition-behavior: allow-discrete) {
.notice {
transition: opacity 0.25s, transform 0.25s;
}
}
@supportsで直接@starting-style自体を判定する形ではなく、関連機能や対象ブラウザー方針に合わせて段階的に強化するのが実務的です。
うまく動かないときの確認ポイント
- 通常状態にtransitionが指定されているか。
- @starting-style側と通常側で、opacityやtransformなど補間できるプロパティが変化しているか。
- 対象要素が本当に初回表示や非描画状態からの表示になっているか。
- JavaScriptや別CSSが直後に値を上書きしていないか。
- 利用ブラウザーの@starting-style対応状況を確認したか。
まずopacityだけの最小例で確認し、動いた後にtransformや複数プロパティへ広げると切り分けやすくなります。
よくある質問とまとめ
@starting-styleだけでアニメーションしますか?
いいえ。通常状態側にtransitionなどの遷移設定が必要です。@starting-styleは開始値を定義します。
@keyframesとの違いは何ですか?
@keyframesは明示的なアニメーション手順を定義します。@starting-styleは、通常のCSS transitionが初回表示時にも開始できるように開始スタイルを補います。
未対応ブラウザーでは要素が消えますか?
通常状態を正しく定義していれば、アニメーションせず通常表示される設計にできます。
最初はopacity 0→1だけの小さな通知要素で試し、transitionと@starting-styleの役割を分けて確認してみてください。