<summary>: SUMMARY 要素
最終更新:2026-10-13
<summary>SUMMARY 要素
details の最初の子要素として、ユーザーがクリックして開閉する可視の見出しを提供します。
| カテゴリ | セマンティック |
|---|---|
| コンテンツモデル | details の最初の子要素のみ |
| 許可される親要素 | フローコンテンツを受け入れる要素 |
| 閉じタグ | 必要 </summary> タグ |
| ステータス | 標準 |
📝 構文
<summary>概要の見出し</summary>
▶ サンプル
下のコードを編集して、playground でリアルタイム結果を確認:
🌐 ブラウザサポート
| ブラウザ | |||||
|---|---|---|---|---|---|
| <summary> | ✓ v1 | ✓ v12 | ✓ v1 | ✓ v1 | ✓ v1 |
| すべての主要ブラウザでサポート | |||||
ヒント: summary は details 内の最初の子要素でなければなりません。ない場合はブラウザーが汎用ラベルを表示します。
❓ よくある質問
Qsummary は details の中でしか使えないのですか?
Aはい。
<summary> は <details> の最初の子要素としてのみ使え、単独では意味を持ちません。折りたたみパネルの「タイトルバー」の役割で、クリックして開閉する動作はブラウザがネイティブで提供するため、JS は不要です。Qsummary の中に見出しやアイコンを置けますか?
A置けます。
<summary> には見出しとフレージングコンテンツを許可します。たとえば <summary><h3>条項その1</h3></summary> のように書けるほか、<span> でアイコンを置くこともできます。なお、summary を置くとブラウザのデフォルトの三角マーカーは上書きされるため、矢印は自分で補う必要があります。Qsummary のデフォルトの三角矢印を消すには?
ACSS で
summary { list-style: none; } とし、WebKit 系はさらに summary::-webkit-details-marker { display: none; } を加えます。その後は ::before/::after で独自のインジケーターを作り、details[open] と組み合わせて矢印の向きを切り替えられます。🏷️ 関連タグ
💡 関連ケース
今後さらにケーススタディを追加予定です。