HTML <hgroup> 要素は、文書のセクションの、複数レベルの見出しを表します。これは <h1>–<h6> 要素のセットをグループ化します。
| コンテンツカテゴリー | フローコンテンツ, 見出しコンテンツ, 知覚可能コンテンツ |
|---|---|
| 許可されている内容 | 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 をチェックアウトしてプルリクエストを送信してください。
| 機能 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基本対応 | 5 | あり | 4 | 9 | 11.1 | 4.1 |
| 機能 | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| 基本対応 | 2.2 | あり | あり | 4 | 11 | 4.2 | あり |