::details-contentでdetailsの開閉アニメーション
::details-contentは、details要素のsummary以外の中身を選ぶ擬似要素です。opacityのtransitionで開閉をアニメーションさせる書き方と、中身の枠や背景をCSSで装飾する方法を説明します。
- Chrome131
- Edge131
- Firefox143
- Safari18.4
はじめに
::details-contentは、details要素のうちsummary以外の中身、つまり開閉する部分を選ぶCSSの擬似要素です。中身全体に枠や背景を付けたり、開閉にアニメーションを付けたりできます。
中身の子要素を1つずつ装飾したり、開くときにアニメーションを付けたりするのは、details > :not(summary)のようなセレクターと@keyframesでできます。子要素に手を入れずに中身全体を1つの箱として装飾することはできず、閉じるときは中身がすぐに消えるのでアニメーションも付けられません。この2つは、::details-contentでしかできません。
中身全体を装飾する
details要素は、アコーディオンのように折りたたみ可能なコンテンツを作成するためのHTML要素です。
summary要素と組み合わせて使用され、ユーザーのアクションに合わせてコンテンツが開閉するUIを提供します。
<details>
<summary>詳細を見る</summary>
<p>ここに詳細が記述されます。</p>
</details>上記のhtmlは、結果の欄のように表示されます。
開発者ツールなどを確認すると、コンテンツ部分がslot要素として表示されていることがわかります。

::details-content擬似要素は、このslot要素に対してスタイルを付与できます。
<details class="children">
<summary>detailsの子要素全てにスタイルを割り当て</summary>
<p>p要素1</p>
<p>p要素2</p>
<p>p要素3</p>
</details>
<details class="content">
<summary>::details-contentを用いてslot要素に割り当て</summary>
<p>p要素1</p>
<p>p要素2</p>
<p>p要素3</p>
</details>.children > :not(summary) {
border: 2px solid steelblue;
}
.content::details-content {
border: 2px solid steelblue;
}
details {
padding: 1rem;
}上記の例はdetailsの子要素(summary要素を除いたもの)に対してスタイルを適用した場合(前者)と、::details-content擬似要素に対してスタイルを適用した場合(後者)の違いを示しています。
/* 前者 */
details > :not(summary) {
border: 2px solid var(--color-primary-border);
}
/* 後者 */
details::details-content {
border: 2px solid var(--color-primary-border);
}前者はdetailsのすべての子要素にスタイルを割り当ててしまうのに対して、後者は常にdetailsのコンテンツ部分にスタイルを適用できることがわかります。
ここから、detailsの子要素に依存せずに、detailsのコンテンツ部分にスタイルを付与できる::details-content擬似要素の強力さが読み取れます。
開いているときだけ装飾する
後者のケースはslot要素に対するスタイルなので、閉じている時にも装飾が行われます。上の2pxの枠を付けると、閉じたdetailsでもsummaryの下に枠の線が残りました。
展開中の時のみスタイルを付与したいときは[open]を利用して以下のように書きます。背景も同じように付けられます。
/* 後者 */
details[open]::details-content {
border: 2px solid var(--color-primary-border);
background-color: var(--color-primary-bg-mute);
}こう書くと、閉じたdetailsには枠の線が出なくなります。
開閉にアニメーションを付ける
::details-content擬似要素は、開閉時のアニメーションを定義する際にも便利です。
details要素が持つ[open]という状態は、即座に変化するため、アニメーションを適用するのは困難でした。
しかし、::details-content擬似要素はslot要素に対するスタイルなので、[open]の切り替えに合わせて、中身の見た目にトランジションを付けられます。
details::details-content {
opacity: 0;
transition: opacity 0.5s, content-visibility 0.5s allow-discrete;
}
details[open]::details-content {
opacity: 1;
}<details>
<summary>::details-contentによるアニメーション</summary>
<p>想定した通りにアニメーションが適用されます</p>
</details>どのブラウザでも、開くときは中身が少しずつ現れ、閉じるときは少しずつ消えていきました。なめらかに変わるのは中身のopacityだけで、detailsの高さは一度に切り替わります。
content-visibilityにもallow-discreteでトランジションを付けると、閉じるときに中身が消えるのをopacityが0になるまで待ちます。付けないと、閉じた直後に中身が消えます。
動きを減らす設定に合わせる
この例は動きを減らす設定(prefers-reduced-motion)に対応していません。対応するには、transitionだけをメディアクエリの中に移します。
details::details-content {
opacity: 0;
}
details[open]::details-content {
opacity: 1;
}
@media (prefers-reduced-motion: no-preference) {
details::details-content {
transition: opacity 0.5s, content-visibility 0.5s allow-discrete;
}
}動きを減らす設定にすると、開閉は一瞬で切り替わります。設定が無いときは、上と同じようにアニメーションします。
おわりに
::details-content擬似要素はBaseline 2025で導入され、主要なブラウザで利用できます。中身の装飾や開閉のアニメーションに使ってみてください。