HTMLTableSectionElement: insertRow() 方法

基线 广泛可用

此功能已经很成熟,可以在许多设备和浏览器版本上使用。它自 2015 年 7 月.

报告反馈

insertRow() 方法是 HTMLTableSectionElement 接口的一部分,它在给定的表格分区元素(<thead><tfoot><tbody>)中插入一个新的行(<tr>),然后返回对该新行的引用。

语法

注意:insertRow() 将行直接插入到分区中。不需要像使用 Document.createElement() 创建新的 <tr> 元素那样单独追加行。
insertRow()
insertRow(index)

js

index 可选

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

返回值

一个 HTMLTableRowElement,它引用新行。

异常

IndexSizeError DOMException

如果 index 大于行数或小于 -1,则抛出此异常。

示例

在此示例中,两个按钮允许您向表格主体分区添加和删除行;它还会使用表格中当前的行数更新 <output> 元素。

HTML

html
<table>
  <thead>
    <th>Col 1</th>
    <th>Col 2</th>
    <th>Col 3</th>
  </thead>
  <tbody>
    <tr>
      <td>X</td>
      <td>Y</td>
      <td>Z</td>
    </tr>
  </tbody>
</table>
<button id="add">Add a row</button>
<button id="remove">Remove last row</button>
<div>This table's body has <output>1</output> row(s).</div>

JavaScript

注意:insertRow() 将行直接插入到分区中。不需要像使用 Document.createElement() 创建新的 <tr> 元素那样单独追加行。
// Obtain relevant interface elements
const bodySection = document.querySelectorAll("tbody")[0];
const rows = bodySection.rows; // The collection is live, therefore always up-to-date
const rowNumberDisplay = document.querySelectorAll("output")[0];

const addButton = document.getElementById("add");
const removeButton = document.getElementById("remove");

function updateRowNumber() {
  rowNumberDisplay.textContent = rows.length;
}

addButton.addEventListener("click", () => {
  // Add a new row at the end of the body
  const newRow = bodySection.insertRow();

  // Add cells inside the new row
  ["A", "B", "C"].forEach(
    (elt) => (newRow.insertCell().textContent = `${elt}${rows.length}`),
  );

  // Update the row counter
  updateRowNumber();
});

removeButton.addEventListener("click", () => {
  // Delete the row from the body
  bodySection.deleteRow(-1);

  // Update the row counter
  updateRowNumber();
});

结果

规范

规范
HTML 标准
# dom-tbody-insertrow

浏览器兼容性

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

另请参阅