HTML の <hgroup> 要素は、文書のセクションの、複数レベルの見出しを表します。これは <h1>–<h6> 要素のセットをグループ化します。
このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。
| コンテンツカテゴリ | フローコンテンツ, 見出しコンテンツ, 知覚可能コンテンツ |
|---|---|
| 許可されている内容 | 1個以上の <h1>, <h2>, <h3>,<h4>, <h5>,<h6> |
| タグの省略 | 不可。開始と終了タグの両方が必要。 |
| 許可されている親要素 | フローコンテンツを受け入れるすべての要素 |
| 許可されている ARIA ロール | tab, presentation |
| DOM インターフェイス | HTMLElement |
属性
この要素にはグローバル属性のみがあります。
使用上の注意
<hgroup> 要素は HTML5 (W3C) 仕様から削除されましたが、 WHATWG 版の HTML には依然として含まれています。ほとんどのブラウザーで部分的に実装されており、実装が削除される可能性は低くなっています。
ただし、<hgroup> 要素の主要な目的は HTML 仕様書で定義されたアウトラインのアルゴリズムによって見出しをどのように表示するかに作用することですが、どのブラウザーでもアウトラインのアルゴリズムは実装されていないため、 <hgroup> のセマンティクスは実際のところ、理論上のものになっています。
HTML5 (W3C) 仕様書では、<hgroup>を使用せずに副見出し、サブタイトル、代替タイトル、スローガンをマークアップする方法についてアドバイスを提供しています。
<hgroup> 要素は、複数レベルの見出しを構成するために文書のセクションの主見出しと副次的な見出し（副見出しや副題など）をグループ化することが可能です。
言い換えると、 <hgroup> 要素は副次的な子の <h1>–<h6> がアウトライン内で独自のセクションを生成することを妨げます。これらの <h1>–<h6> 要素は <hgroup> の子でなければ通常どおりです。
よって HTML 仕様書で定義されているアウトラインのアルゴリズムで生成される理論的なアウトラインでは、<hgroup> は全体としてひとつの論理的な見出しを構成します。そして <hgroup> の子である <h1>–<h6> とともに、理論的なアウトライン内でひとつの論理的な見出しを構成するために複数レベルのユニットとしてのアウトラインになります。
このようなアウトラインの (理論的ではない) 描画ビューを生成するために、マルチレベルの性質を伝えるため <hgroup> の見出しをどのように描画するかについて、レンダリングツールのデザインでいくつかの選択が必要です。例えば以下のように、描画されたアウトラインで <hgroup> を表示するさまざまな方法が考えられます:
- 主見出しの後および最初の副次的な見出しの前にコロンと空白 (“
:”) または同様の句読点を置く形で (および同じまたは同様の句読点を、他の副次的な見出しの前に置いて)<hgroup>を描画されたアウトラインで表示する - 主見出しの後に、括弧でくくった副次的な見出しを置く形で、
<hgroup>を描画されたアウトラインで表示する
以下の HTML 文書で考えてみましょう。
<!DOCTYPE html>
<title>HTML Standard</title>
<body>
<hgroup id="document-title">
<h1>HTML</h1>
<h2>Living Standard — Last Updated 12 August 2016</h2>
</hgroup>
<p>Some intro to the document.</p>
<h2>Table of contents</h2>
<ol id=toc>...</ol>
<h2>First section</h2>
<p>Some intro to the first section.</p>
</body>
この文書のアウトラインを描画すると、以下のようになるでしょう。
ここでは主見出し「HTML」の後にコロンと空白を置いて、副次的な見出し「Living Standard — Last Updated 12 August 2016」が続きます。
あるいは、以下のようにアウトラインを描画することもできるでしょう。
ここでは主見出し「HTML」の後に、括弧でくくった副次的な見出し「 (Living Standard — Last Updated 12 August 2016)」があります。
例
<hgroup id="document-title"> <h1>HTML</h1> <h2>Living Standard — Last Updated 12 August 2016</h2> </hgroup>
仕様書
| 仕様書 | 状態 | 備考 |
|---|---|---|
| HTML Living Standard <hgroup> の定義 |
現行の標準 |
ブラウザーの対応
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。
| デスクトップ | モバイル | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
hgroup | Chrome 完全対応 5 | Edge 完全対応 あり | Firefox 完全対応 4 | IE 完全対応 9 | Opera 完全対応 11.1 | Safari 完全対応 4.1 | WebView Android 完全対応 2.2 | Chrome Android 完全対応 あり | Edge Mobile 完全対応 あり | Firefox Android 完全対応 4 | Opera Android 完全対応 11.1 | Safari iOS 完全対応 4.2 | Samsung Internet Android 完全対応 あり |
凡例
- 完全対応
- 完全対応