Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

figcaption — une légende pour le contenu de figure

L’élément `figcaption` fournit une légende au contenu de `figure`. Il doit en être un enfant direct, placé au début ou à la fin.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<figure>
  <!-- Figure content -->
  <figcaption>Caption text</figcaption>
</figure>

figcaption représente une légende ou une explication du reste du contenu de son élément parent figure. Il ne se limite pas aux illustrations : il peut aussi décrire un diagramme ou une liste de code. La légende peut inclure des informations sur la source.

Un élément figure peut contenir au maximum un élément figcaption enfant direct, placé en premier ou en dernier. La légende est facultative. Ne la placez ni entre des parties du contenu décrit ni dans un conteneur supplémentaire au lieu de la placer directement dans figure.

figcaption accepte du contenu de type flow, par exemple du texte, des liens et des paragraphes. Il prend en charge les attributs globaux et utilise l’interface DOM HTMLElement. Les balises ouvrante et fermante sont toutes deux obligatoires. Dans l’exemple, la légende décrit une équation présentée sous forme de listing ; elle ne fait pas partie du code lui-même.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Caption example</title>
</head>
<body>
  <figure>
    <pre><code>2 + 3 = 5</code></pre>
    <figcaption>Listing 1. An addition equation.</figcaption>
  </figure>
</body>
</html>

Résultat

2 + 3 = 5
Listing 1. An addition equation.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources