<figure>

Une illustration autonome avec une légende facultative : image, graphique, extrait de code, citation.

Affichage
block
Balise fermante
Obligatoire
Contenu autorisé
Du contenu de flux et, facultativement, un <figcaption> au début ou à la fin
Sur cette page

Exemple

#
HTML
<figure>
  <img
    src="/collections/covers/kurs-html-css-od-podstaw.webp"
    alt="Un mur de temple égyptien découpé comme une mise en page : une large bande en haut, un grand panneau au milieu et une rangée de panneaux plus petits en bas"
    width="300"
    height="200"
  >
  <figcaption>Fig. 1. Une mise en page ressemble à un mur de blocs de pierre.</figcaption>
</figure>
Aperçu

Définition et utilisation

#

L’élément <figure> enveloppe un contenu qui illustre le texte principal mais garde aussi un sens en dehors de lui : une photo, un schéma, un graphique, un listing de code, une citation ou un tableau. Vous ajoutez une légende avec l’élément <figcaption>, comme premier ou dernier enfant.

Un bon test : pourriez-vous déplacer cette illustration à la fin du chapitre ou dans une annexe, tout en gardant un texte cohérent grâce à un renvoi du type « voir la figure 3 » ? Si oui, c’est un <figure>. Une image qui fait partie d’une phrase, ou une icône dans un bouton, n’a pas besoin de cet élément.

Par défaut, les navigateurs écartent <figure> des bords avec une marge de 40 pixels à gauche et à droite. La légende <figcaption> devient le nom accessible de toute l’illustration, mais l’image à l’intérieur a toujours besoin de son propre alt.

Syntaxe

#
Syntaxe
<figure>
  …
  <figcaption>Légende</figcaption>
</figure>

Attributs

#

Cet élément n’a pas d’attributs propres. Il accepte les attributs globaux, comme class, id ou hidden.

Plus d’exemples

#
Un listing de code avec légende
HTML
<figure>
  <figcaption>Listing 2. Le document HTML le plus simple</figcaption>
  <pre><code>&lt;!DOCTYPE html&gt;
&lt;html lang="fr"&gt;
  &lt;head&gt;&lt;title&gt;Ma page&lt;/title&gt;&lt;/head&gt;
  &lt;body&gt;Bonjour !&lt;/body&gt;
&lt;/html&gt;</code></pre>
</figure>
Aperçu
Une citation avec son auteur
HTML
<figure>
  <blockquote>
    <p>Le meilleur moment pour apprendre à programmer était il y a un an. Le deuxième meilleur est aujourd’hui.</p>
  </blockquote>
  <figcaption>Ola, diplômée de la formation JavaScript</figcaption>
</figure>
Aperçu

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
figure {
  display: block;
  margin-block: 1em;
  margin-inline: 40px;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • La légende et alt jouent des rôles différents. alt remplace l’image, alors que <figcaption> la commente : ne répétez donc pas la même phrase dans les deux.
  • La marge latérale par défaut de 40 pixels casse souvent la mise en page sur téléphone. Remettez-la à zéro en CSS : figure { margin: 0; }.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.