限定アコーディオン

同じ name を持つ複数の <details> 要素で排他的アコーディオンを作成する。

アコーディオン

ウェブでよく使われる UI パターンは、アコーディオン コンポーネントです。このコンポーネントは、個別に展開(または折りたたむ)ことでコンテンツを表示(または非表示にする)できる複数の開示ウィジェットで構成されています。

このパターンをウェブに実装するには、いくつかの <details> 要素を組み合わせて、通常は視覚的にグループ化し、同じものに属することを示します。

<ph type="x-smartling-placeholder">
</ph>
デモ: HTML と CSS を使用したアコーディオン

他にはないアコーディオン

対応ブラウザ

  • Chrome: 120。 <ph type="x-smartling-placeholder">
  • Edge: 120。 <ph type="x-smartling-placeholder">
  • Firefox: 130。 <ph type="x-smartling-placeholder">
  • Safari: 17.2。 <ph type="x-smartling-placeholder">

アコーディオン パターンのバリエーションとして排他アコーディオンがあります。このアコーディオンでは、開示ウィジェットのうち 1 つのみを同時に開くことができます。

これをウェブで実現するために、name 属性を <details> 要素に追加できるようになりました。この属性を使用すると、同じ name 値を持つ複数の <details> 要素がセマンティック グループを形成し、排他的アコーディオンとして動作します。グループの <details> 要素のいずれかを開くと、以前に開いたものが自動的に閉じます。

<details name="learn-css">
  <summary>Welcome to Learn CSS!</summary>
  <p>…</p>
</details>
<details name="learn-css">
  <summary>Box Model</summary>
  <p>…</p>
</details>
<details name="learn-css">
  <summary>Selectors</summary>
  <p>…</p>
</details>
<ph type="x-smartling-placeholder">
</ph>
デモ: HTML と CSS による排他的アコーディオン。

1 つのページに排他的アコーディオンを複数設定できます。<details> 要素で新しい name 値を使用すると、新しい論理グループが作成されます。

<ph type="x-smartling-placeholder">
</ph>
デモ: HTML と CSS を使用した複数の排他的アコーディオン

排他的アコーディオンの一部である <details> 要素は、必ずしも兄弟である必要はありません。ドキュメント全体に散らばっている可能性があります。要素をグループ化するのは name 属性であり、DOM の順序ではありません。

専用のアコーディオンをポリフィルする

次の JavaScript を使用すると、排他的アコーディオンの動作をポリフィルできます。このコードは、<details> 要素の toggle イベントに依存しています。

name を含む <details> 要素が開くと、name 属性の値が同じである他の開いている <details> 要素を見つけて閉じます。

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");
          }
        });
    }
  });
});

一部の古いバージョンのブラウザでは、この toggle イベントは発生しません。これらのブラウザでは、ポリフィル コードは機能しません。段階的なエンハンスメントの観点からは、これは許容される動作です。