HTMLTableElement: createCaption() メソッド

HTMLTableElement.createCaption() メソッドは、この <table> に関連付けられた <caption> 要素を返します。 この表に <caption> 要素がない場合が、このメソッドは生成して返します。

メモ: キャプションが存在しない場合、 createCaption() は新しいキャプションを表に直接挿入します。 Document.createElement() を使用して新しい <caption> 要素を生成する場合とは異なり、キャプションを個別に追加する必要はありません。

構文

js
createCaption()

引数

なし。

返値

HTMLTableCaptionElement

例

この例は JavaScript を使用して、表に最初は存在しないキャプションを追加します。

HTML

html
<table>
  <tr>
    <td>セル 1.1</td>
    <td>セル 1.2</td>
    <td>セル 1.3</td>
  </tr>
  <tr>
    <td>セル 2.1</td>
    <td>セル 2.2</td>
    <td>セル 2.3</td>
  </tr>
</table>

JavaScript

js
let table = document.querySelector("table");
let caption = table.createCaption();
caption.textContent = "このキャプションは JavaScript で生成されました。";

例

仕様書

Specification
HTML Standard
# dom-table-createcaption-dev

ブラウザーの互換性

BCD tables only load in the browser