HTMLTableSectionElement:deleteRow() 方法

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

HTMLTableSectionElement 接口的 deleteRow() 方法从给定的 <section> 中移除特定的行(<tr>)。

语法

js
deleteRow(index)

参数

index

index 是一个表示应该删除行的整数。然而,特殊索引 -1 可以用于删除当前分段的最后一行。

返回值

无(undefined)。

异常

IndexSizeError DOMException

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

示例

在这个示例中,有两个按钮允许你对表格主体添加和移除行,它还使用表中当前行数更新 <output> 元素。

HTML

html
<table>
  <thead>
    <th>列 1</th>
    <th>列 2</th>
    <th>列 3</th>
  </thead>
  <tbody>
    <tr>
      <td>X</td>
      <td>Y</td>
      <td>Z</td>
    </tr>
  </tbody>
</table>
<button id="add">添加一行</button>
<button id="remove">移除最后一行</button>
<div>表格主体有 <output>1</output> 行。</div>

JavaScript

js
// 获取相关接口元素
const bodySection = document.querySelectorAll("tbody")[0];
const rows = bodySection.rows; // 集合是动态的,因此其总是最新的
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", () => {
  // 在主体的末尾添加一个新行
  const newRow = bodySection.insertRow();

  // 在新行内添加单元格
  ["A", "B", "C"].forEach(
    (elt) => (newRow.insertCell().textContent = `${elt}${rows.length}`),
  );

  // 更新行计数
  updateRowNumber();
});

removeButton.addEventListener("click", () => {
  // 从主体删除行
  bodySection.deleteRow(-1);

  // 更新行计数
  updateRowNumber();
});

结果

规范

Specification
HTML Standard
# dom-tbody-deleterow

浏览器兼容性

BCD tables only load in the browser

参见