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 crée un élément HTML <caption>, l'insère comme premier enfant du tableau (<table>) donné, et le retourne. Si le tableau a déjà un enfant <caption>, cette méthode retourne le premier enfant de ce type sans en créer un nouveau.
Lorsque la création est nécessaire, cette méthode crée et insère l'élément directement, sans nécessiter d'appels séparés à des méthodes telles que Document.createElement() et Node.insertBefore().
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
const table = document.querySelector("table");
const caption = table.createCaption();
caption.textContent = "Cette légende a été créée par JavaScript !";
Résultat
Spécifications
| Spécification |
|---|
| HTML # dom-table-createcaption-dev |
Compatibilité des navigateurs
Voir aussi
- La méthode
HTMLTableElement.createTBody() - La méthode
HTMLTableElement.createTFoot() - La méthode
HTMLTableElement.createTHead() - La méthode
HTMLTableElement.deleteCaption()