HTMLTableElement: insertRow() 方法

基线 广泛可用

此功能已得到良好建立,并在许多设备和浏览器版本中运行良好。它自 2015 年 7 月.

报告反馈

**insertRow()** 是 HTMLTableElement 接口的方法,用于在给定的 <table> 中插入一个新的行 (<tr>),并返回对该新行的引用。

如果表格具有多个 <tbody> 元素,默认情况下,新行将插入到最后一个 <tbody> 中。若要将行插入到特定部分,请使用 HTMLTableSectionElement.insertRow()

语法

**注意:**insertRow() 将行直接插入到表格中。无需像使用 Document.createElement() 创建新的 <tr> 元素那样单独附加该行。
insertRow()
insertRow(index)

js

HTMLTableElement 是对 HTML <table> 元素的引用。

参数

index 可选

新行的行索引。如果 index-1 或等于行数,则该行将作为最后一行追加。如果省略 index,则默认为 -1

返回值

引用新行的 HTMLTableRowElement

示例

如果 index 大于行数,则抛出此异常。

此示例使用 insertRow(-1) 将新行追加到表格中。

HTML

然后,我们使用 HTMLTableRowElement.insertCell() 在新行中插入新单元格。(要使 HTML 有效,<tr> 必须至少包含一个 <td> 元素。)最后,我们使用 Document.createTextNode()Node.appendChild() 将一些文本添加到单元格中。
<table id="my-table">
  <tr>
    <td>Row 1</td>
  </tr>
  <tr>
    <td>Row 2</td>
  </tr>
  <tr>
    <td>Row 3</td>
  </tr>
</table>

JavaScript

**注意:**insertRow() 将行直接插入到表格中。无需像使用 Document.createElement() 创建新的 <tr> 元素那样单独附加该行。
function addRow(tableID) {
  // Get a reference to the table
  let tableRef = document.getElementById(tableID);

  // Insert a row at the end of the table
  let newRow = tableRef.insertRow(-1);

  // Insert a cell in the row at index 0
  let newCell = newRow.insertCell(0);

  // Append a text node to the cell
  let newText = document.createTextNode("New bottom row");
  newCell.appendChild(newText);
}

// Call addRow() with the table's ID
addRow("my-table");

html

规范

结果
规范
# HTML 标准

浏览器兼容性

dom-table-insertrow-dev

另请参阅