<hgroup> #
::: section-content
The <hgroup>
HTML element represents a heading and related
content. It groups a single
<h1>–<h6>
element with
one or more
<p>
.
:::
Try it #
::: section-content ::: iframe ::: {.output-header .border-rounded-top}
HTML Demo: <hgroup> #
Reset :::
::: {#warning-no-script .warning-container} ::: warning The interactive example cannot be shown because JavaScript is disabled. ::: :::
::: {#warning-mathml-not-supported .warning-container .hidden} ::: warning The interactive example cannot be shown because MathML is not supported by your browser. ::: :::
::: {#editor-container .editor-container .tabbed-standard .hidden .border-rounded-bottom editor-type=“tabbed”} ::: {#tab-container .section .tabs} ::: {#tablist .tab-list role=“tablist”} HTML
CSS
JavaScript :::
::: {#html-panel .section .hidden tabindex=“0” role=“tabpanel” aria-labelledby=“html” aria-hidden=“true”}
::: {#html-editor} Or: The Modern PrometheusFrankenstein
Victor Frankenstein, a Swiss scientist, has a great ambition: to create intelligent life. But when his creature first stirs, he realizes he has made a monster. A monster which, abandoned by his master and shunned by everyone who sees it, follows Dr Frankenstein to the very ends of the earth.
::: :::::: {#css-panel .section .hidden tabindex=“0” role=“tabpanel” aria-labelledby=“css” aria-hidden=“true”} ::: {#css-editor} hgroup { text-align: right; padding-right: 16px; border-right: 10px solid #00c8d7; }
hgroup h1 {
margin-bottom: 0;
}
hgroup p {
margin: 0;
font-weight: bold;
}
::: :::
::: {#js-panel .section .hidden tabindex=“0” role=“tabpanel” aria-labelledby=“js” aria-hidden=“true”} ::: {#js-editor} ::: ::: :::
::: {#output .output-container}
Output #
::: :::
::: {.section .console-container .hidden aria-hidden=“true”}
Console Output #
![] clear console
::: {#console .console} ::: :::
::: {#html-output .output .editor-tabbed} %html-content% ::: ::: :::
Attributes #
::: section-content This element only includes the global attributes. :::
Usage notes #
::: section-content
The <hgroup>
element allows the grouping of a heading with any
secondary content, such as subheadings, an alternative title, or
tagline. Each of these types of content represented as a <p>
element
within the <hgroup>
.
The <hgroup>
itself has no impact on the document outline of a web
page. Rather, the single allowed heading within the <hgroup>
contributes to the document outline.
:::
Examples #
::: section-content ::: code-example [html]{.language-name}
<!doctype html>
<title>HTML Standard</title>
<body>
<hgroup id="document-title">
<h1>HTML: Living Standard</h1>
<p>Last Updated 12 July 2022</p>
</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>
::: :::
Result #
::: section-content ::: {#sect1 .code-example} ::: iframe ::: ::: :::
Accessibility concerns #
::: section-content
The <hgroup>
presently has no strong accessibility semantics. The
content of the element (a heading and optional paragraphs) is what is
exposed by browser accessibility APIs.
:::
Technical summary #
::: section-content
Content categories | Flow content, heading content, palpable content. |
---|---|
Permitted content | Zero or more <p> elements,
followed by one h1, h2, h3, h4, h5, or h6 element, followed by zero or more <p> elements. |
Tag omission | None, both the starting and ending tag are mandatory. |
Permitted parents | Any element that accepts flow content. |
Implicit ARIA role | generic |
Permitted ARIA roles | Any |
DOM interface | HTMLElement |
Specifications #
::: _table #
Specification #
HTML Standard
[#
the-hgroup-element]{.small}
:::
Browser compatibility #
::: _table Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
hgroup
5 12 4 9 11.1 5 2.2 18 4 11.1 4.2 1.0
:::
See also #
::: section-content
- Others section-related elements:
<body>
,<article>
,<section>
,<aside>
, h1, h2, h3, h4, h5, h6,<nav>
,<header>
,<footer>
,<address>
; - Sections and outlines of an HTML document. :::
::: _attribution
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5
or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/hgroup{._attribution-link}
:::