Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

<hgroup> : l'élément de regroupement de titres

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

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

Exemple interactif

<hgroup>
  <h1>Frankenstein</h1>
  <p>Ou&nbsp;: Le Prométhée moderne</p>
</hgroup>
<p>
  Victor Frankenstein, un scientifique suisse, a une grande ambition&nbsp;:
  créer une vie intelligente. Mais lorsque sa créature s'éveille pour la
  première fois, il se rend compte qu'il a créé un monstre. Un monstre qui,
  abandonné par son maître et rejeté par tous ceux qui le voient, poursuit le Dr
  Frankenstein aux confins de la terre.
</p>
hgroup {
  text-align: right;
  padding-right: 16px;
  border-right: 10px solid #00c8d7;
}

hgroup h1 {
  margin-bottom: 0;
}

hgroup p {
  margin: 0;
  font-weight: bold;
}

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

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 l'un des éléments h1, h2, h3, h4, h5, or h6, 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 group
Rôles ARIA autorisés Tous les rôles sont autorisés.
Interface DOM HTMLElement

Spécifications

Specification
HTML
# the-hgroup-element

Compatibilité des navigateurs

Voir aussi