---
title: "details要素のname属性を使用した排他的なアコーディオンの実装例"
description: "details要素のname属性を使用した排他的なアコーディオンの実装メモです。details要素で新たに追加されたname属性を使用すればJavaScriptを使用せずともWeb標準で排他的なアコーディオンを実現できます。"
canonical: https://www.tak-dcxi.com/article/accordion-implementation-example-using-the-name-attribute-of-details/
published: 2024-04-30
last-updated: 2026-11-08
category: "Patterns"
tags: ["details", "details[name]", "Web Animations API"]
---

# details要素のname属性を使用した排他的なアコーディオンの実装例

`details`要素の`name`属性を使用した排他的なアコーディオンの実装メモです。

`details`要素で新たに追加された`name`属性を使用すればJavaScriptを使用せずともWeb標準で排他的なアコーディオンを実現できます。

Note

2026年11月に、ブラウザの対応状況と、`::details-content`疑似要素で開閉のアニメーションをCSSだけで実装できるようになったことに合わせて本文を書き直しました。公開時（2024年4月）は「`name`属性を使ったアコーディオンで開閉のアニメーションを同時に行うことは仕様上不可能」と紹介していました。

## details要素のname属性とは

[Open UIでの議論](https://open-ui.org/components/accordion.explainer/)を発端として追加された、オープンされている`details`要素をひとつに限定する（どれかの`details`要素が開かれたら開いている他の`details`要素は閉じる）排他的なアコーディオンを実現できる属性です。

[HTML Standard](https://html.spec.whatwg.org/multipage/interactive-elements.html)

使用方法はフォームパーツの`name`属性同様に、排他的なアコーディオンを実装したい`details`要素を`name`属性でグループ化するだけです。`name`属性にはユニークな値を指定できますが、空の文字列を使用するのは禁じられています。

マークアップの例

```html
<section aria-labelledby="title">
	<h1 id="title">アコーディオンの実装例</h1>
	<details name="sample" open>
		<summary>Details 1</summary>
		<div>...</div>
	</details>
	<details name="sample">
		<summary>Details 2</summary>
		<div>...</div>
	</details>
	<details name="sample">
		<summary>Details 3</summary>
		<div>...</div>
	</details>
</section>
```

上記のマークアップだけで次のような排他的なアコーディオンの実装を行うことができます。なお、次の実装例の開閉のアニメーションは、後述する`::details-content`疑似要素を使ってCSSで付けています。

[実装例「アコーディオンの実装例」は、記事のページで見られます](https://www.tak-dcxi.com/article/accordion-implementation-example-using-the-name-attribute-of-details/#playground-1jaizbw)

[現在のHTMLの仕様](https://html.spec.whatwg.org/multipage/interactive-elements.html#the-details-element)では`name`属性を使用して複数の`details`要素をグループ化する場合には、`details`要素とそれらの関連要素を包含要素 (`section`要素や`article`要素など) にまとめて保持することが推奨されています。

また、グループを見出しで紹介することが合理的である場合は、包含要素に見出し要素を配置するようにします。

よくある質問のマークアップの例

```html
<section aria-labelledby="title">
	<h2 id="title">よくある質問</h2>
	<details name="faq" open>
		<summary>入会の方法について</summary>
		<div>...</div>
	</details>
	<details name="faq">
		<summary>入会金の支払い方法について</summary>
		<div>...</div>
	</details>
	<details name="faq">
		<summary>再入会について</summary>
		<div>...</div>
	</details>
</section>
```

## 実装時の注意点

`details`要素の`name`属性は低コストで排他的なアコーディオンを実装できるため非常に便利ですが、以下のような注意点があるため留意してください。

### 古いブラウザではサポートされていない

`details`要素の`name`属性は、Chrome と Edge は 120、Safari（iOS を含む）は 17.2、Firefox は 130 からサポートされており、2024年9月に Baseline Newly available（新しく利用可能）になりました。記事を公開した2024年4月時点では Firefox が未サポートでした。

Baseline：details 要素の name 属性は「新しく利用可能」です（2024年9月から）。執筆時点（2026年11月）から変わっていません。ブラウザーごとの対応は、Chrome 120、Edge 120、Firefox 130、Safari 17.2、iOS Safari 17.2です（web-features 3.45.0 のデータ。[webstatus.dev で見る](https://webstatus.dev/features/details-name)）。

`name`属性がサポートされていない古いブラウザでも排他的なアコーディオンを実現したい場合は、JSを使用して`details`要素の`open`属性を切り替える必要があります。例えば[Chrome for Developers](https://developer.chrome.com/docs/css-ui/exclusive-accordion?hl=ja)の文献では次のようなポリフィルが紹介されています。

ポリフィルの例

```js
document.querySelectorAll('details[name]').forEach(($details) => {
	$details.addEventListener('toggle', (e) => {
		const name = $details.getAttribute('name')

		if (e.newState == 'open') {
			document.querySelectorAll(`details[name=${name}][open]`).forEach(($openDetails) => {
				if (!($openDetails === $details)) {
					$openDetails.removeAttribute('open')
				}
			})
		}
	})
})
```

もしくは`name`属性がサポートされていなくても`details`要素の基本的な機能は失われないため、プログレッシブエンハンスメントの考え方に基づいて`name`属性をそのまま導入することも選択肢の一つだと思います。

### open属性はグループにひとつしか存在してはいけない

「排他的」なので当たり前の話ではありますが、同じ`name`属性値を指定した`details`要素のグループに複数の`open`属性を指定することはNGです。

❗NG

```html
<section aria-labelledby="title">
	<h1 id="title">アコーディオンの実装例</h1>
	<details name="sample" open>
		<summary>Details 1</summary>
		<div>...</div>
	</details>
	<details name="sample" open>
		<summary>Details 2</summary>
		<div>...</div>
	</details>
	<details name="sample">
		<summary>Details 3</summary>
		<div>...</div>
	</details>
</section>
```

同じ`name`属性値を指定した`details`要素のグループに複数の`open`属性を指定した場合、グループの最初の`details`要素のみが開かれ、他の`open`属性が指定された`details`要素は閉じたままになります。また、JSで操作する場合も最後に操作された`details`要素の`open`属性のみが開いた状態になり、その他は問答無用で閉じられます。

このことは[現在のHTMLの仕様](https://html.spec.whatwg.org/multipage/interactive-elements.html#the-details-element)にて以下のように記述されています。

> The group of elements that is created by a common name attribute is exclusive, meaning that at most one of the details elements can be open at once. While this exclusivity is enforced by user agents, the resulting enforcement immediately changes the open attributes in the markup. This requirement on authors forbids such misleading markup.

[HTML Standard](https://html.spec.whatwg.org/multipage/interactive-elements.html#the-details-element) より引用

つまり、同じ`name`属性値を持つ`details`要素のグループ内で`open`属性を複数指定することは仕様に反する誤解を招くマークアップであるとみなされます。また、この排他性はユーザーエージェントによって強制され、強制が適応される場合はマークアップ内の`open`属性が即座に変更されます。

### 同じname属性を内包してはいけない

次のマークアップのように同じ`name`属性を内包するのは仕様で禁止されています。

❗NG

```html
<section aria-labelledby="title">
	<h1 id="title">アコーディオンの実装例</h1>
	<details name="sample" open>
		<summary>Details 1</summary>
		<div>
			<details name="sample">
				<summary>Details 2</summary>
				<div>...</div>
			</details>
		</div>
	</details>
</section>
```

[Forbid documents from nesting <details> in the same exclusive accordion. by dbaron · Pull Request #10004 · whatwg/html](https://github.com/whatwg/html/pull/10004)

実際に上記のようなマークアップをした場合、子要素の`details`要素を開くと親要素が閉じてしまうため、結果として子要素の中身を表示することができなくなります。

### JavaScriptで開閉のアニメーションを同時に行うには工夫が必要

前提として、JavaScriptで`details`要素に閉じる時のアニメーションを加える場合は、アニメーションの終了を待ってから`open`属性を外すという処理が必要になります。

そのため、排他的なアコーディオンにおいて`details`要素が開かれる時のアニメーションと他の`details`要素が閉じる時のアニメーションを両立する場合、それぞれに`open`属性を持たせる必要があります。しかし、`name`属性を用いる場合は先述した「_`open`属性はグループにひとつしか存在してはいけない_」制約により、そのままでは実現できません。

ただし、ある工夫をすれば開閉のアニメーションを両立することは可能です。JavaScriptで`name`属性を使用しつつ開閉のアニメーションを両立したい場合は次の実装例を参考にしてください。

なお、現在は`details`要素の中身を選択する`::details-content`疑似要素を使えば、`open`属性が即座に外れても閉じる際のアニメーションをCSSだけで実現できます。そのため、`name`属性を使ったアコーディオンでもJavaScriptを書かずに開閉のアニメーションを両立できます。冒頭の実装例はこの方法ですが、高さのアニメーションに使っている`interpolate-size`プロパティは2026年11月時点でChromeとEdgeのみのサポートです。Safari や Firefox でも高さをアニメーションさせる方法を含めて、「[::details-contentを使ってCSSのみでdetails要素のアニメーションを実装する方法](https://www.tak-dcxi.com/article/css-only-details-animation-2025/)」で紹介しています。

## 開閉のアニメーションを両立した排他的なdetails要素の実装例

`details`要素の`name`属性を使用しつつ開閉のアニメーションを両立させる実装例です。公開時（2024年4月）の当ブログで使用していたアコーディオンの実装を流用したものとなります。

[実装例「開閉のアニメーションを両立したアコーディオンの実装例」は、記事のページで見られます](https://www.tak-dcxi.com/article/accordion-implementation-example-using-the-name-attribute-of-details/#playground-sz7wz2)

排他的な機能が必要な場合は`name`属性を持たせ、排他的な機能が不要であれば`name`属性を指定せずにそのままJSを適用してください。

任意の`details`要素を開いて表示しておきたい場合はマークアップで`open`属性を指定してください。

マークアップ側の制約は`details`要素の子要素は`summary`要素と`margin` `padding` `border`などのスタイルが当たっていない`div`要素1つのみです。

マークアップ例

```html
<section aria-labelledby="titleA">
	<h2 id="titleA">グループA</h2>
	<details name="groupA">
		<summary>タイトル</summary>
		<div>...</div>
	</details>
	<details name="groupA">
		<summary>タイトル</summary>
		<div>...</div>
	</details>
	<details name="groupA">
		<summary>タイトル</summary>
		<div>...</div>
	</details>
</section>
<section aria-labelledby="titleB">
	<h2 id="titleB">グループB</h2>
	<!-- 最初に開いておきたい要素にはopen属性をつけておく -->
	<details name="groupB" open>
		<summary>タイトル</summary>
		<div>...</div>
	</details>
	<details name="groupB">
		<summary>タイトル</summary>
		<div>...</div>
	</details>
	<details name="groupB">
		<summary>タイトル</summary>
		<div>...</div>
	</details>
</section>
<section aria-labelledby="titleC">
	<h2 id="titleC">排他的機能が不要な場合</h2>
	<details>
		<summary>タイトル</summary>
		<div>...</div>
	</details>
	<details>
		<summary>タイトル</summary>
		<div>...</div>
	</details>
	<details>
		<summary>タイトル</summary>
		<div>...</div>
	</details>
</section>
```

いつもの通りJSの実装はGitHub Gistに纏めています。コードにはTypeScriptを使用していますので、TypeScriptを利用していないWeb制作現場で使用する場合はChatGPTなどに依頼してJSファイルに変換してください。

[initializeDetailsAccordion](https://gist.github.com/tak-dcxi/f29dd50916b820581bac0946b2742a87)

また、このJSを導入すれば`details`要素の`name`属性がサポートされていない古いブラウザ（Firefox 130未満や、iOSを含むSafari 17.2未満）でも排他的アコーディオンを実現できますので、先述したポリフィルの導入は不要になります。

スタイリングに関しては`summary`要素のデフォルトの三角形のアイコンはデザイン反映においては不要になるため非表示にしておくと良いでしょう。Safari以外はUAスタイルシートで指定されている`display:list-item`を上書きすることで非表示にできますが、Safariは`::-webkit-details-marker`疑似要素を`display:none`する必要があります。

デフォルトの三角形アイコンを非表示にする

```css
.summary {
	display: block flow; /* flexやgridでも可 */

	&::-webkit-details-marker {
		display: none; /* Safari用 */
	}
}
```

他のスタイルは要件に依るため特筆することはありません。

## アニメーションのポイント

### Web Animations APIを使用する

今回の実装では[Web Animations API](https://developer.mozilla.org/ja/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API)を使用してjQueryの`slideToggle()`的なアニメーションを実現しています。

アニメーションを実行する部分

```ts
const toggleAccordion = (
  details: HTMLDetailsElement,
  panel: HTMLElement,
  options: AccordionOptions,
  detailsName: string | null,
  show: boolean,
): void => {
  if (details.open === show) return

  if (show) details.open = true

  const { blockSize } = window.getComputedStyle(panel)
  const keyframes = show
    ? [{ maxBlockSize: '0' }, { maxBlockSize: blockSize }]
    : [{ maxBlockSize: blockSize }, { maxBlockSize: '0' }]

  const animationOptions = {
    duration: Math.max(0, options.duration || 0),
    easing: options.easing,
  }

  const onAnimationEnd = () => {
    requestAnimationFrame(() => {
      if (!show) details.open = false
    })
  }

  requestAnimationFrame(() => {
    const animation = panel.animate(keyframes, animationOptions)

    animation.addEventListener('finish', onAnimationEnd)
  })
}
```

`slideToggle()`的なアニメーションを行う際は予めパネル要素の高さの実寸値を取得しておく必要があります。

高さの取得には`scrollHeight`などを用いるのが主流だと思いますが、現在のCSSは原則的に論理プロパティで指定するのが定石であること、加えて当ブログのように縦書き対応も行っておきたいという理由から`window.getComputedStyle()`でアニメーション適用前のパネル要素の`block-size`を取得するようにします。

```js
const { blockSize } = window.getComputedStyle(panel)
const keyframes = show
	? [{ maxBlockSize: '0' }, { maxBlockSize: blockSize }]
	: [{ maxBlockSize: blockSize }, { maxBlockSize: '0' }]
```

アニメーションは`block-size`ではなく可変的でありつつも一定の制約を設けられる`max-block-size`をアニメーションさせるのがベターでしょう。

次に、アニメーションのオプションは`initializeDetailsAccordion()`の第二引数で受け取れるようにします。

```ts
export type AccordionOptions = {
  duration?: number
  easing?: string
}

const defaultOptions: AccordionOptions = {
  duration: 300,
  easing: 'ease-in-out',
}

const toggleAccordion = (
  details: HTMLDetailsElement,
  panel: HTMLElement,
  options: AccordionOptions,
  detailsName: string | null,
  show: boolean,
): void => {
  //...

  const animationOptions: AccordionOptions = {
    duration: Math.max(0, options.duration || 0),
    easing: options.easing,
  }

  // ...
}
```

🤞Use

```ts
  import initializeDetailsAccordion, { type AccordionOptions } from '@/scripts/initializeDetailsAccordion.ts'

  document.addEventListener('DOMContentLoaded', () => {
    const detailsElements = document.querySelectorAll('details') as NodeListOf<HTMLDetailsElement>

    if (detailsElements.length === 0) return

    const options: AccordionOptions = {
      duration: 500,
      easing: 'linear'
    }

    detailsElements.forEach((details) => {
      initializeDetailsAccordion(details, options)
    })
  })
```

`duration`に負の値が差し込まれるとエラーになるので`Math.max()`関数で最小値を0としておきます。

そして`requestAnimationFrame`を使用して、次の描画フレームでアニメーションを開始します。`panel.animate(keyframes, animationOptions)`でキーフレームとオプションに基づいてアニメーションを作成し、`animation.addEventListener('finish', onAnimationEnd)`を使用してアニメーションが終了したときに`onAnimationEnd()`関数が呼び出されるようにします。

```js
const onAnimationEnd = () => {
	requestAnimationFrame(() => {
		if (!show) details.open = false
	})
}

requestAnimationFrame(() => {
	const animation = panel.animate(keyframes, animationOptions)

	animation.addEventListener('finish', onAnimationEnd)
})
```

先述したように閉じる際はアニメーションの終了を待ってから`open`属性を取り外すようにします。

注意点として、いつもの`animation`の指定の癖で`fill`に`forwards`とか`both`は指定しないようにしてください。アニメーション後も`max-block-size`の値が固定値のままだとレスポンシブ時の改行の有無などで表示に不具合が出ますし、閉じた後に高さが`0`に固定されているとページ内検索時に中身がヒットした際に自動で開くという`details`要素のメリットを殺すことになります。

### 開閉のアニメーションを両立させる

先述したように、JavaScriptでアニメーションさせる場合は、`name`属性を持たせたまま開閉のアニメーションを両立させることはできません。

そのため、_アニメーション開始時に`name`属性を取り除き、アニメーション終了時に`name`属性を復元する_ことでやや強引に開閉のアニメーションを両立するようにします。

name属性をアニメーション中はremoveする

```ts
const toggleAccordion = (
  details: HTMLDetailsElement,
  panel: HTMLElement,
  options: AccordionOptions,
  detailsName: string | null,
  show: boolean,
): void => {
  // ...

  if (detailsName) details.removeAttribute('name')
  if (show) details.open = true

  // ...

  const onAnimationEnd = () => {
    requestAnimationFrame(() => {
      if (!show) details.open = false
      if (detailsName) details.setAttribute('name', detailsName)
      // ...
    })
  }

  requestAnimationFrame(() => {
    const animation = panel.animate(keyframes, animationOptions)

    animation.addEventListener('finish', onAnimationEnd)
  })
}
```

最初は初期化時に`name`属性を`data-name`属性に置き換えることも検討しましたが、ページ内検索時に排他的で無くなるためアニメーション中だけ取り外すほうがいいという判断をしました。`details`要素の`name`属性がサポートされていない環境では検索時の排他性は失われますが、該当するのはChrome 97〜119のような古いブラウザに限られるので考えないこととします（SafariとFirefoxは、`name`属性より後にページ内検索での`details`要素の展開をサポートしました）。

### アニメーション中だけoverflow:clipを適用する

`slideToggle()`的なアニメーションを実装する際は`overflow`プロパティを使用してコンテンツのはみ出しを防ぐ必要がありますが、今回の実装ではアニメーション中のみに`overflow:clip`を適用しています。

アニメーション開始時に適用し、終了したら取り除く

```ts
const toggleAccordion = (
  details: HTMLDetailsElement,
  panel: HTMLElement,
  options: AccordionOptions,
  detailsName: string | null,
  show: boolean,
): void => {
  // ...

  panel.style.overflow = 'clip'

  const onAnimationEnd = () => {
    requestAnimationFrame(() => {
      panel.style.overflow = ''
      // ...
    })
  }

  requestAnimationFrame(() => {
    const animation = panel.animate(keyframes, animationOptions)

    animation.addEventListener('finish', onAnimationEnd)
  })
}
```

実装例ではパネル要素に十分な`padding`が設けられているため問題ありませんが、`padding`が無いor小さい場合に`overflow:clip`が有効なままだと子要素のフォーカスリングが意図せずに切り取られてしまう可能性があります。

なるべくであればfocusableな要素を含む親要素に不必要な`overflow`プロパティの指定は避けたほうが良いため、万が一のリスクを避けるためにもアニメーション終了時には`overflow`プロパティをリセットするようにしています。

また、あくまで要素のはみ出しを防ぐ目的のみであれば`overflow:hidden`よりも`overflow:clip`を優先したほうが良いでしょう。`overflow:clip`はプログラム的なスクロールを含むすべてのスクロールを禁止できるのに加えて、`overflow:hidden`はスクロールコンテナを生成し、新しい整形コンテキストも作成する仕様が災いして予期せぬ不具合を引き起こす可能性があります。

Note

マークアップ側の条件が増えてしまうため今回は使用しておりませんが、`grid-template-rows`をアニメーションして`slideToggle()`的なアニメーションを行う場合は`overflow:hidden`でなければいけないなど、場合によっては`overflow:clip`ではなく`overflow:hidden`を選択するケースも存在します。

また、動的なコンテンツが差し込まれる場合は`contain:content`を指定するほうがパフォーマンス面で有利になるメリットがありますが、アニメーション中のみに適用するとガタツキが生じる場合があるのでフォーカスリングの問題は意識しつつ恒久的に指定しておいたほうがいいでしょう。

なお、`grid-template-rows`のアニメーションについては過去に投稿した記事「[アコーディオンのスライドアニメーションはCSS2行で実装できる](https://www.tak-dcxi.com/article/accordion-slide-animation-can-be-implemented-in-two-line-of-css)」にて解説しています。

### 視差効果（アニメーション）を減らす設定がされている場合にはdurationを0にする

過去記事で何度か説明しているため詳細は省きますが、視差効果（アニメーション）を減らす設定がされている場合にはアニメーションを行わないようにします。

`window.matchMedia('(prefers-reduced-motion: reduce)').matches`で設定がされているかを確認し、設定がされている場合はアニメーションの間隔を`0`にします。

```ts
const isPrefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches
const animationOptions: AccordionOptions = {
  duration: isPrefersReduced ? 0 : Math.max(0, options.duration || 0),
  easing: options.easing,
}
```

### アニメーション中は連打を防止する

アニメーションの連打防止策としてグローバル変数`isAnimating`を使用します。アニメーションが開始すると`isAnimating`は`true`に設定され、アニメーションが終了すると`false`に戻ります。

isAnimatingフラグで連打防止を行う

```ts
let isAnimating: boolean = false

const toggleAccordion = (
  details: HTMLDetailsElement,
  panel: HTMLElement,
  options: AccordionOptions,
  detailsName: string | null,
  show: boolean,
): void => {
  if (details.open === show) return

  isAnimating = true

  // ...

  const onAnimationEnd = () => {
    requestAnimationFrame(() => {
      panel.style.overflow = ''
      // ...

      isAnimating = false
    })
  }

  requestAnimationFrame(() => {
    const animation = panel.animate(keyframes, animationOptions)

    animation.addEventListener('finish', onAnimationEnd)
  })
}
```

`summary`要素に登録した`handleClick`イベント内で`isAnimating`が`true`の時は早期リターンするようにします。

handleClick関数

```ts
const handleClick = (
  event: MouseEvent,
  details: HTMLDetailsElement,
  panel: HTMLElement,
  options: AccordionOptions,
  detailsName: string | null,
): void => {
  event.preventDefault()

  if (isAnimating) return

  toggleAccordion(details, panel, options, detailsName, !details.open)

  if (details.open) hideOtherAccordions(details, options, detailsName)
}
```

`details`要素のアニメーションに関する他の記事では、アニメーション中の`details`要素にカスタムデータ属性を持たせて連打防止フラグとする方法が紹介されています。しかし、複数の`details`要素がアニメーション中に`name`属性の復元タイミングがズレるとひとつのグループが複数の`open`属性を持つ可能性があります。

そのため、今回のケースではアニメーション中は他のアコーディオンの動作を封じる方が不具合の防止になるため、このような施策を行うようにします。

## オプションで印刷時に全てのアコーディオンを開くようにする

排他的アコーディオン自体が持つデメリットとして、全てのコンテンツを開いて印刷することができないというものがあります。

印刷の問題に関してはOpen UIで議論があったようですが、印刷時の強制的な展開は行わない結論になったようです。

[\`<details name>\` による排他的アコーディオンの実現](https://blog.w0s.jp/693)

そのため、印刷する時は全てのアコーディオンを開いておいたほうが良さそうなコンテンツの場合はオプションで印刷時に全展開するようにします。

印刷時の設定を追加する

```ts
export type AccordionOptions = {
  duration?: number
  easing?: string
  printAll?: boolean
}

const defaultOptions: AccordionOptions = {
  duration: 300,
  easing: 'ease-in-out',
  printAll: false,
}

const initializeDetailsAccordion = (details: HTMLDetailsElement, options: AccordionOptions = {}): void => {
  // ...

  if (mergedOptions.printAll) {
    window.addEventListener('beforeprint', () => handleBeforePrint(details, detailsName))
    window.addEventListener('afterprint', () => handleAfterPrint(details, detailsName))
  }
}

const openStatusAttribute = 'data-open-status'

const handleBeforePrint = (details: HTMLDetailsElement, detailsName: string | null): void => {
  if (!details) return
  details.setAttribute(openStatusAttribute, String(details.open))
  if (detailsName) details.removeAttribute('name')
  details.open = true
}

const handleAfterPrint = (details: HTMLDetailsElement, detailsName: string | null): void => {
  if (!details) return
  if (detailsName) details.setAttribute('name', detailsName)
  details.open = details.getAttribute(openStatusAttribute) === 'true'
  details.removeAttribute(openStatusAttribute)
}
```

`beforeprint`イベントが検知したら現在展開されている`details`要素を`data-open-status`属性に保存した後に`name`属性を取り除いて全展開します。その後、`afterprint`イベントが検知したら`name`属性を戻した後に`data-open-status`属性を参照して印刷前の展開状態を復元します。

ただし、アコーディオンメニューのように別に印刷しても嬉しくない（むしろ邪魔になり得る）要素の場合は、全展開しても余計な印刷が含まれるだけでなくコピー用紙の枚数やインクの量に負担を掛けることになるため、あくまでオプションで全展開がベストな場合以外には`false`にしておいたほうが良さそうです。

## なんでもかんでもdetails要素を使えばいいってわけではない

以前投稿した記事「[タブやアコーディオンの非表示コンテンツにはhidden=“until-found”を使うべし](https://www.tak-dcxi.com/article/use-until-found-for-hiding-tabs-and-accordions)」で触れたように、ランドマークの下にトリガーとなる見出しと開閉コンテンツといった構成の場合は`details`要素を使わずに`hidden="until-found"`と`aria-expanded`属性などで実装するほうが望ましいです。（理由はそちらの記事参照）

Note

`hidden="until-found"`を使用したアコーディオンの実装例に関しても「[タブやアコーディオンの非表示コンテンツにはhidden=“until-found”を使うべし](https://www.tak-dcxi.com/article/use-until-found-for-hiding-tabs-and-accordions#hiddenuntil-found%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%9F%E3%82%A2%E3%82%B3%E3%83%BC%E3%83%87%E3%82%A3%E3%82%AA%E3%83%B3%E3%81%AE%E5%AE%9F%E8%A3%85%E4%BE%8B)」にて紹介しています。そちらのコードも参考にしてください。

また、アコーディオンはユーザーに展開させる手間を与える機能であるため、_本当にそのアコーディオンが必要か？_ は設計段階で考慮したほうがいいかもしれません。

## 参考リンク

-   [4.11.1 The details element | HTML Standard](https://html.spec.whatwg.org/multipage/interactive-elements.html#the-details-element)
-   [Exclusive Accordion (Explainer)](https://open-ui.org/components/accordion.explainer/)
-   [`<details name>` による排他的アコーディオンの実現 | 富永日記帳](https://blog.w0s.jp/693)
-   [限定アコーディオン | CSS and UI | Chrome for Developers](https://developer.chrome.com/docs/css-ui/exclusive-accordion?hl=ja)
-   [これは知っておくとかなり便利！ details要素にname属性を与えると、連動して開閉するアコーディオンを実装できます | コリス](https://coliss.com/articles/build-websites/operation/css/exclusive-accordion.html)
-   [details / summaryで作るアコーディオンアニメーション | ぶろぐみ](https://blog-mi.com/details-summary/)
-   [detailsとsummaryタグで作るアコーディオンUI - アニメーションのより良い実装方法 - ICS MEDIA](https://ics.media/entry/220901/)
