The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
|Content categories||Flow content, heading content, palpable content.|
|Permitted content||One or more <h1> (en-US), <h2> (en-US), <h3> (en-US), <h4> (en-US), <h5> (en-US), and/or <h6> (en-US).|
|Permitted parent elements||Any element that accepts flow content.|
|Permitted ARIA roles||
注意: 本元素已经从HTML5（W3C）规范中删除，但是它仍旧在 WHATWG 的 HTML 版本里。大多数浏览器都部分地实现，所以它不太可能消失。
HTML5 (W3C) 规范提供了如何标记副标题，小标题，可选标题和标语（Subheadings, subtitles, alternative titles and taglines）的建议。
<hgroup> element allows the primary heading for a document section to be grouped with any secondary headings—such as subheadings or alternative titles—to form a multi-level heading.
In other words, the
<hgroup> element prevents any of its secondary
<h1>–<h6> children from creating separate sections of their own in the outline—as those
<h1>–<h6> elements otherwise normally would if they were not children of any
So in the abstract outline produced by the HTML outline algorithm defined in the HTML specification, the
<hgroup> as a whole forms a single logical heading, with the entire set of
<h1>–<h6> children of the
<hgroup> going into the outline as one multi-level unit, to comprise that single logical heading in the abstract outline.
To produce any (non-abstract) rendered view of such an outline, some choice must be made in the design of the rendering tool about how to render
<hgroup> headings in such a way as to convey their multi-level nature. There are a variety of ways an
<hgroup> might be shown in a rendered outline; for example:
<hgroup>might be shown in a rendered outline in with a colon character and space (“
:”) or other such punctuation after the primary heading and before the first secondary heading (and with the same or similar punctuation before any other secondary headings
<hgroup>might be shown in a rendered outline in with the primary heading followed by parentheses around the secondary heading(s)
Consider the following HTML document:
<!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>
A rendered outline for that document might look like the following:
That is, the rendered outline might show the primary title, HTML, followed by a colon and space, followed by the secondary title, Living Standard — Last Updated 12 August 2016.
Or, the rendered outline for that document might instead look like the following:
That is, the rendered outline might show the primary title, HTML, followed by the secondary title shown in parentheses: (Living Standard — Last Updated 12 August 2016).
<hgroup> <h1>Main title</h1> <h2>Secondary title</h2> </hgroup>
|Feature||Chrome||Firefox (Gecko)||Internet Explorer||Opera||Safari|
|Basic support||5||4.0 (2.0)||9.0||11.10||4.1|
|Feature||Android||Firefox Mobile (Gecko)||IE Mobile||Opera Mobile||Safari Mobile|
|Basic support||2.2||4.0 (2.0)||9.0||11.0||5.0|