HTMLTableElement: createCaption() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

HTMLTableElement.createCaption() 方法返回与给定 <table> 元素关联的 <caption> 元素。如果表中不存在 <caption> 元素,此方法会创建它,然后返回它。

注意: 如果不存在标题,createCaption() 会将新标题直接插入表中。与使用 Document.createElement() 创建新的 <caption> 元素时需要单独添加标题不同,这里不需要单独添加。

语法

js
createCaption()

参数

无。

返回值

HTMLTableCaptionElement

示例

本示例使用 JavaScript 为一个最初没有标题的表格添加标题。

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

结果

规范

规范
HTML
# dom-table-createcaption-dev

浏览器兼容性