MDN self-hosted library · e01.org

HTMLTableElement: createCaption() method

HTML DOM

HTML DOM

The createCaption() method of the HTMLTableElement interface creates a caption element, inserts it as the first child of the given table, and returns it. If the table already has a <caption> element child, this method returns the first such child without creating one.

When creation is needed, this method creates and inserts the element directly, without requiring separate calls to methods such as Document.createElement() and Node.insertBefore().

Syntax

createCaption()

Parameters

None.

Return value

An HTMLTableCaptionElement.

Examples

This example uses JavaScript to add a caption to a table that initially lacks one.

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!";

Result

Examples

Specifications

Browser compatibility

See also

  • HTMLTableElement.createTBody()
  • HTMLTableElement.createTFoot()
  • HTMLTableElement.createTHead()
  • HTMLTableElement.deleteCaption()