本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2025年10月26日(日)更新: 2026年11月9日(月)約7分で読めます

::details-contentでdetailsの開閉アニメーション

::details-contentは、details要素のsummary以外の中身を選ぶ擬似要素です。opacityのtransitionで開閉をアニメーションさせる書き方と、中身の枠や背景をCSSで装飾する方法を説明します。

Newly available::details-content2025年〜
  • Chrome131
  • Edge131
  • Firefox143
  • Safari18.4

はじめに

::details-contentは、details要素のうちsummary以外の中身、つまり開閉する部分を選ぶCSSの擬似要素です。中身全体に枠や背景を付けたり、開閉にアニメーションを付けたりできます。

中身の子要素を1つずつ装飾したり、開くときにアニメーションを付けたりするのは、details > :not(summary)のようなセレクターと@keyframesでできます。子要素に手を入れずに中身全体を1つの箱として装飾することはできず、閉じるときは中身がすぐに消えるのでアニメーションも付けられません。この2つは、::details-contentでしかできません。

中身全体を装飾する

details要素は、アコーディオンのように折りたたみ可能なコンテンツを作成するためのHTML要素です。 summary要素と組み合わせて使用され、ユーザーのアクションに合わせてコンテンツが開閉するUIを提供します。

html
<details>
  <summary>詳細を見る</summary>
  <p>ここに詳細が記述されます。</p>
</details>
結果

上記のhtmlは、結果の欄のように表示されます。

開発者ツールなどを確認すると、コンテンツ部分がslot要素として表示されていることがわかります。

details要素の展開部分がslot要素として表示されている

::details-content擬似要素は、このslot要素に対してスタイルを付与できます。

html
<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>
結果

上記の例はdetailsの子要素(summary要素を除いたもの)に対してスタイルを適用した場合(前者)と、::details-content擬似要素に対してスタイルを適用した場合(後者)の違いを示しています。

css
/* 前者 */
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]を利用して以下のように書きます。背景も同じように付けられます。

css
/* 後者 */
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]の切り替えに合わせて、中身の見た目にトランジションを付けられます。

css
details::details-content {
  opacity: 0;
  transition: opacity 0.5s, content-visibility 0.5s allow-discrete;
}

details[open]::details-content {
  opacity: 1;
}
結果

どのブラウザでも、開くときは中身が少しずつ現れ、閉じるときは少しずつ消えていきました。なめらかに変わるのは中身のopacityだけで、detailsの高さは一度に切り替わります。

content-visibilityにもallow-discreteでトランジションを付けると、閉じるときに中身が消えるのをopacityが0になるまで待ちます。付けないと、閉じた直後に中身が消えます。

動きを減らす設定に合わせる

この例は動きを減らす設定(prefers-reduced-motion)に対応していません。対応するには、transitionだけをメディアクエリの中に移します。

css
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で導入され、主要なブラウザで利用できます。中身の装飾や開閉のアニメーションに使ってみてください。