<summary> 詳細内容(<details>)の要約や概要を設定する
取り扱い | 現行の標準 |
カテゴリ |
なし |
親にできる要素 | <details> |
子にできる要素 | フレージング・コンテンツ。または一つのヘッディング・コンテンツ |
対応ブラウザ | caniuseで確認 |
<summary>タグの説明
<summary>
は、<details>
によって設置された「ディスクロージャー・ウィジェット」の詳細内容に対して、その要約や概要、キャプションといった、いわゆるサマリーを指定するために使用するタグです。
ディスクロージャー・ウィジェットとは、ユーザーのリクエストに応じて表示/非表示を切り替えることができるインターフェイスのことです。
<summary>
は、<details>
の最初の子要素として記述する必要があります。
<summary>タグの特徴
- レイアウトの初期値はブロックレベルです。文章の改行に影響を与えます。
- 視覚的な効果として、開閉可能なことを表すマーカーが文字の先頭に配置されます。
- 同一のページ内に複数使うことができます。ただし、この要素自体を入れ子にすることはできません。
<summary>に指定できる主な属性
- グローバル属性
- 全てのHTML要素に指定できる共通の属性です。詳細は一覧表で解説します。
- イベントハンドラ
- 全てのHTML要素に指定できるコンテンツ属性です。
<summary>の使い方とサンプル
このタグを使ったマークアップのサンプルです。<summary>
で指定された内容を操作すると、<details>
の内容が表示されます。
HTML
<details>
<summary>summaryタグで指定した要約</summary>
<div>details要素に含まれる詳細内容。</div>
</details>
表示確認
summaryタグで指定した要約
details要素に含まれる詳細内容。summary要素をクリックすると、details要素にopen属性が付与されて内容が表示されます。親要素の高さが制限されていない場合は、自動的に調整されます。
<details>
にopen
属性を与えて、初めから内容を開示しておくこともできます。
HTML
<details open>
<summary>open属性で開閉を操作</summary>
<div>予め詳細を開いておきたい場合は、open属性をマークアップに加えます。</div>
</details>
表示確認
open属性で開閉を操作
予め詳細を開いておきたい場合は、open属性をマークアップに加えます。
その他、CSSを組み合わせて色々なインターフェイスを作ることができます。アコーディオン形式のメニューを作成する方法は<details>
のページで解説しています。
<summary>に関連するHTMLタグ
文字列の表現を指定する要素 | |
---|---|
<div> | ブロックレベル要素としての範囲を指定 |
<span> | インライン要素としての範囲を指定する |
<br> | 改行を行う |
<wbr> | 文章の中で改行可能位置を指定する |
<b> | 文字を太字にする |
<mark> | 文章の中で目立たせたい箇所をマーキングする |
<pre> | ソースを整形済みテキストとして表示する |
<bdi> | ページの書字方向とは別の書字方向を指定する |
<bdo> | 書字方向を指定する |
<ruby> | ルビを振る文字列の範囲を指定する |
<rt> | ルビの内容を指定する |
<rp> | ルビが非対応な環境で読みがなを囲う記号を指定する |
<rtc> | ルビテキストの集まりを指定する |
<sub> | 下付き文字として表示する |
<sup> | 上付き文字として表示する |
<details> | 折りたたみ可能なディスクロージャー・ウィジェットを設置する |
<summary> | 折りたたみ可能なディスクロージャー・ウィジェットの概要を設定する |