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 的浏览器中加载。
另请参阅
HTMLTableElement.insertRow()
- 表示单元格的 HTML 元素:
HTMLTableCellElement