HTMLTableElement：createCaption() 方法

基线 广泛可用

此功能已得到良好确立，并且可以在许多设备和浏览器版本中使用。它自以下时间起在浏览器中可用 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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。