Loading

ROUTE

ルートゼロの
アクティビティ

HTML detailsのname属性でJavaScriptなしのアコーディオンを作る

2

FAQのようなアコーディオンで『一度に1つだけ開く』動きを作りたいなら、複数のdetails要素へ同じname属性を付ける方法があります。対応ブラウザーでは、JavaScriptを書かなくても1つを開いたときに同じグループの別のdetailsが閉じます。name属性は2024年9月以降の最新ブラウザー群で広く利用できるようになっています。まずHTMLだけの最小構成を理解し、そのうえで『複数を同時に開きたい画面では使わない』という判断まで押さえましょう。

detailsのname属性とは?

detailsは、summaryを押すと追加情報を開閉できるHTML要素です。同じname値を持つdetailsをグループ化すると、そのグループでは一度に1つだけ開く排他的なアコーディオンとして動作します。

用語解説:排他的なアコーディオン
同じグループの項目を複数同時に開かず、1項目を開くと別の開いていた項目が閉じるUIです。

WHATWG HTMLでは、nameは相互排他的なdetailsグループの名前として定義されています。nameを指定する場合、空文字にはせず、関連するdetailsはsectionやarticleなど同じまとまりの中に置くことが推奨されています。


JavaScriptなしでアコーディオンを作る最小例

3つのdetailsへ同じname="faq"を指定します。これだけで、対応ブラウザーでは1つを開くと同じグループの別項目が閉じます。

<section>
  <h2>よくある質問</h2>

  <details name="faq">
    <summary>HTMLとは何ですか?</summary>
    <p>Webページの構造を表すためのマークアップ言語です。</p>
  </details>

  <details name="faq">
    <summary>CSSとは何ですか?</summary>
    <p>文字色や余白など、見た目を指定するための仕組みです。</p>
  </details>

  <details name="faq">
    <summary>JavaScriptは必要ですか?</summary>
    <p>この開閉グループだけなら必須ではありません。</p>
  </details>
</section>

summaryがクリックやキーボード操作の入口になり、開いたdetailsにはopen属性が付いた状態になります。nameによる排他制御はブラウザー側が行います。


open属性と一緒に使うときの注意

最初から1項目を開いて見せたい場合は、そのdetailsにopen属性を付けられます。同じnameグループで複数のdetailsへopenを付けるマークアップは避けてください。HTML標準では同じグループに複数のopenを持つdetailsを置かないよう求めています。

<details name="setup" open>
  <summary>1. HTMLファイルを作る</summary>
  <p>まずindex.htmlを用意します。</p>
</details>

<details name="setup">
  <summary>2. ブラウザーで開く</summary>
  <p>保存したファイルをブラウザーで確認します。</p>
</details>

初期表示で開くのは1項目に絞ると、HTMLの状態と実際の表示が一致しやすくなります。


普通のdetailsとの違い

構成 開き方 向いている例
nameなしのdetails 各項目を独立して開閉できる 比較しながら複数項目を読みたい説明
同じnameのdetails グループ内で一度に1つだけ開く 短いFAQや手順の補足を省スペースで見せたい画面

『アコーディオンにしたいから必ずnameを付ける』わけではありません。利用者が複数項目を見比べる必要があるなら、独立したdetailsのほうが使いやすい場合があります。

アクセシビリティと使い勝手で確認したいこと

WHATWG HTMLは、排他的なアコーディオンが最大表示領域を減らせる一方、複数項目を同時に見たい利用者には不便になる場合があると注意しています。UIの省スペース化だけで決めず、読む目的を基準に選びましょう。

  • 各summaryだけを読んでも内容を予測できる文言にする。
  • 関連するdetailsをsectionやarticleなど同じ領域にまとめる。
  • グループの前に見出しを置き、何の項目群か分かるようにする。
  • キーボードだけでもsummaryへ移動して開閉できるか確認する。
  • 複数項目を並べて比較する必要があるならnameを外すことも検討する。

古いブラウザーではどうなる?

MDNではdetailsのnameによるグループ化をBaseline 2024として案内しています。古いブラウザーではnameによる排他制御が使えない可能性がありますが、detailsとsummary自体が利用できれば各項目を独立した開閉UIとして使える場合があります。

要件として『必ず1つしか開いてはいけない』ことが重要なら、対象ブラウザーの対応範囲を確認し、必要に応じてJavaScriptのフォールバックを検討します。単に読みやすく折りたためればよい場合は、排他制御が効かなくても情報へアクセスできる構成を優先しましょう。

うまく1つだけ開かないときの確認

  • グループ化したいdetailsすべてに同じname値が付いているか。
  • nameが空文字になっていないか。
  • 別のdetailsだけスペルが違っていないか。
  • 同じグループのdetailsが同じDOMツリー内にあるか。
  • ブラウザーがdetailsのname属性へ対応しているか。
  • 同一グループに複数のopen属性を付けていないか。

まずHTMLだけの小さな例で動作を確認し、それから実際のCSSを加えると、構造の問題と見た目の問題を分けて調べやすくなります。

よくある質問とまとめ

detailsのname属性だけでアコーディオンになりますか?

対応ブラウザーでは、同じnameを付けたdetailsを一度に1つだけ開くグループにできます。独自JavaScriptは必須ではありません。

複数の項目を同時に開きたい場合は?

nameによる同一グループ化を使わず、通常のdetailsとして独立させます。

summary以外をクリックして開閉できますか?

基本の操作入口はsummaryです。独自のクリック領域や複雑な状態管理が必要なら別途JavaScriptやUI設計を検討します。

detailsのname属性を使うと、FAQなどの排他的なアコーディオンをHTML中心で小さく実装できます。最初は3項目程度のサンプルを作り、nameなしの場合との使い勝手を比較してみてください。

ルートゼロの採用情報を見る

RANKINGranking-icon

すべてを開示している会社です

ポジティブな面もネガティブな面も、包み隠さず誠実にお答えします。
気になることがあれば、面談の際にすべてオープンにお話します。