HTMLTableElement: createCaption() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die HTMLTableElement.createCaption() Methode gibt das <caption>-Element zurück, das mit einem bestimmten <table> verbunden ist. Wenn kein <caption>-Element in der Tabelle existiert, wird dieses durch die Methode erstellt und anschließend zurückgegeben.

Hinweis: Wenn keine Beschriftung existiert, fügt createCaption() eine neue Beschriftung direkt in die Tabelle ein. Die Beschriftung muss nicht separat hinzugefügt werden, wie es der Fall wäre, wenn Document.createElement() verwendet worden wäre, um das neue <caption>-Element zu erstellen.

Syntax

js
createCaption()

Parameter

Keine.

Rückgabewert

HTMLTableCaptionElement

Beispiele

Dieses Beispiel verwendet JavaScript, um einer Tabelle, die ursprünglich keine hat, eine Beschriftung hinzuzufügen.

HTML

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

js
let table = document.querySelector("table");
let caption = table.createCaption();
caption.textContent = "This caption was created by JavaScript!";

Ergebnis

Spezifikationen

Specification
HTML Standard
# dom-table-createcaption-dev

Browser-Kompatibilität

BCD tables only load in the browser