HTMLTableRowElement: insertCell() 方法

基线 广泛可用

此功能已经很成熟,并且在许多设备和浏览器版本中都有效。它自 2015 年 7 月.

insertCell() 方法是 HTMLTableRowElement 接口的方法,它在表格行 (<tr>) 中插入一个新单元格 (<td>),并返回对该单元格的引用。

注意:insertCell() 直接将单元格插入行中。不需要像使用 Document.createElement() 创建新的 <td> 元素那样,使用 Node.appendChild() 将单元格分别追加到行中。

但是,不能使用 insertCell() 来创建新的 <th> 元素。

语法

js
insertCell()
insertCell(index)

参数

index 可选

新单元格的单元格索引。如果 index-1 或等于单元格数量,则将单元格追加为行中的最后一个单元格。如果省略 index,则默认为 -1

返回值

一个 HTMLTableCellElement,它引用新的单元格。

异常

IndexSizeError DOMException

如果 index 大于单元格数量,则抛出此异常。

示例

此示例使用 HTMLTableRowElement.insertCell() 将新单元格追加到行中。

HTML

html
<table>
  <thead>
    <tr>
      <th>C1</th>
      <th>C2</th>
      <th>C3</th>
      <th>C4</th>
      <th>C5</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Cell 1</td>
      <td>Cell 2</td>
    </tr>
  </tbody>
</table>

<button id="add">Add a cell</button>
<button id="remove">Remove last cell</button>
<div>This first row has <output>2</output> cell(s).</div>

JavaScript

js
// Obtain relevant interface elements
const bodySection = document.querySelectorAll("tbody")[0];
const row = bodySection.rows[0]; // Select the first row of the body section
const cells = row.cells; // The collection is live, therefore always up-to-date
const cellNumberDisplay = document.querySelectorAll("output")[0];

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

function updateCellNumber() {
  cellNumberDisplay.textContent = cells.length;
}

addButton.addEventListener("click", () => {
  // Add a new cell at the end of the first row
  const newCell = row.insertCell();
  newCell.textContent = `Cell ${cells.length}`;

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

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

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

结果

规范

规范
HTML 标准
# dom-tr-insertcell-dev

浏览器兼容性

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

另请参阅