HTMLTableElement : méthode createCaption()

Baseline Large disponibilité

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.

La méthode createCaption() de l'interface HTMLTableElement retourne l'élément HTML <caption> associé à un <table> donné. Si aucun élément <caption> n'existe sur le tableau, cette méthode le crée, puis le retourne.

Note : Si aucune légende n'existe, createCaption() insère une nouvelle légende directement dans le tableau. Il n'est pas nécessaire d'ajouter la légende séparément comme cela serait le cas si Document.createElement() avait été utilisé pour créer le nouvel élément <caption>.

html
<table>
  <tbody>
    <tr>
      <td>Cellule 1.1</td>
      <td>Cellule 1.2</td>
      <td>Cellule 1.3</td>
    </tr>
    <tr>
      <td>Cellule 2.1</td>
      <td>Cellule 2.2</td>
      <td>Cellule 2.3</td>
    </tr>
  </tbody>
</table>

JavaScript

js
let table = document.querySelector("table");
let caption = table.createCaption();
caption.textContent = "Cette légende a été créée par JavaScript !";

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 19 janv. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

API HTML DOM
HTMLTableElement
Propriétés d'instance
Méthodes d'instance
Héritage
Pages liées à HTML DOM
Guides
1. Utiliser les microtâches en JavaScript avec queueMicrotask()
2. Aller plus loin : Les microtâches et l'environnement d'exécution JavaScript

HTMLTableElement : méthode createCaption()

Dans cet article

Syntaxe

Paramètres

Valeur de retour

Exemples

HTML

JavaScript

Résultat

Spécifications

Compatibilité des navigateurs

Aider à améliorer MDN