HTMLTableElement: createCaption()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die createCaption()-Methode der HTMLTableElement-Schnittstelle erstellt ein <caption>-Element, fügt es als erstes Kind des angegebenen <table> ein und gibt es zurück. Wenn die Tabelle bereits ein <caption>-Elementkind hat, gibt diese Methode das erste solcher Kinder zurück, ohne eins zu erstellen.
Wenn eine Erstellung erforderlich ist, erstellt und fügt diese Methode das Element direkt ein, ohne dass separate Aufrufe von Methoden wie Document.createElement() und Node.insertBefore() erforderlich sind.
Syntax
createCaption()
Parameter
Keine.
Rückgabewert
Beispiele
Dieses Beispiel verwendet JavaScript, um einer Tabelle, die zunächst keine besitzt, eine Beschriftung hinzuzufügen.
HTML
<table>
<tbody>
<tr>
<td>Cell 1.1</td>
<td>Cell 1.2</td>
<td>Cell 1.3</td>
</tr>
<tr>
<td>Cell 2.1</td>
<td>Cell 2.2</td>
<td>Cell 2.3</td>
</tr>
</tbody>
</table>
JavaScript
const table = document.querySelector("table");
const caption = table.createCaption();
caption.textContent = "This caption was created by JavaScript!";
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-table-createcaption-dev |