HTMLTableElement : méthode createCaption()
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.
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>.
Syntaxe
createCaption()
Paramètres
Aucun.
Valeur de retour
Un objet HTMLTableCaptionElement.
Exemples
Cet exemple utilise JavaScript pour ajouter une légende à un tableau qui n'en possède pas initialement.
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
let table = document.querySelector("table");
let caption = table.createCaption();
caption.textContent = "Cette légende a été créée par JavaScript !";
Résultat
Spécifications
| Specification |
|---|
| HTML # dom-table-createcaption-dev |