<hgroup>

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

L'élément HTML <hgroup> représente un titre et son contenu associé. Il regroupe un élément <h1>-<h6> avec un ou plusieurs paragraphes <p>.

Exemple interactif

Attributs

Cet élément inclut uniquement les attributs universels.

Notes d'utilisation

L'élément <hgroup> permet de regrouper le titre principal d'une section avec du contenu secondaire associé, tel que son (ou ses) sous-titre(s), un titre alternatif ou un slogan. Chaque contenu de ce type sera représenté par un élément <p> au sein de l'élément <hgroup>.

L'élément <hgroup> en tant que tel n'a pas d'effet sur le plan (outline) d'une page web. C'est le titre intégré au sein de l'élément <hgroup> qui contribue au plan du document.

Exemples

html
<hgroup id="document-title">
  <h1>HTML : standard évolutif</h1>
  <p>Dernière mise à jour le 12 juillet 2022</p>
</hgroup>
<p>Une introduction dans le document.</p>
<h2>Table des matières</h2>
<ol id="toc">
  …
</ol>
<h2>Première section</h2>
<p>Une introduction à la première section.</p>

Résultat

Accessibilité

L'élément <hgroup> n'a pas de sémantique forte pour l'accessibilité. C'est le contenu de l'élément (le titre et les éventuels paragraphes) qui sont exposés aux API d'accessibilité du navigateur.

Résumé technique

Catégories de contenu Contenu de flux, contenu de titre, contenu tangible.
Contenu autorisé Zéro ou plusieurs éléments <p>, suivi par un élément de titre (<h1-6>), suivis par zéro ou plusieurs éléments <p>.
Omission de balise Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires
Parents autorisés Tout élément qui accepte du contenu de flux.
Rôle ARIA implicite Aucun rôle correspondant
Rôles ARIA autorisés Tous
Interface DOM HTMLElement

Spécifications

Specification
HTML Standard
# the-hgroup-element

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi