HTMLTableElement.createCaption()

Die HTMLTableElement.createCaption() Methode gibt das <caption> Element zurück, das einer <table> zugeordnet ist. Wenn in der Tabelle noch kein <caption> Element existiert, wird es durch diese Methode erzeugt und dann zurückgegeben..

Anmerkung: Wenn noch keine Überschrift vorhanden ist, fügt createCaption() sie direkt in die Tabelle ein. Die Überschrift muss nicht eigens hinzugefügt werden, wie man es tun müsste, wenn man das <caption> Element mittels Document.createElement() erzeugt hätte.

Syntax

HTMLTableCaptionElement = table.createCaption();

Rückgabewert

HTMLTableCaptionElement (en-US)

Beispiel

Dieses Beispiel verwendet JavaScript, um eine Tabelle um eine Überschrift zu erweitern.

HTML

<table>
  <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>
</table>

JavaScript

let table = document.querySelector('table');
let caption = table.createCaption();
caption.textContent = 'Diese Überschrift wurde mit JavaScript erzeugt!';

Ergebnis

Spezifikationen

Specification Status Comment
HTML Living Standard
Die Definition von 'HTMLTableElement: createCaption' in dieser Spezifikation.
Lebender Standard

Browserkompatibilität

BCD tables only load in the browser