HTMLTableSectionElement：insertRow() 方法
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
HTMLTableSectionElement 接口的 insertRow() 方法在给定的表格分段元素（<thead>、<tfoot> 或 <tbody>）插入一个新行（<tr>），然后返回新行的引用。
备注：
insertRow() 将行直接插入到分段（section）中，该行不需要像使用 Document.createElement() 创建新的 <tr> 元素那样单独追加。
语法
js
insertRow()
insertRow(index)
参数
index可选-
新行的行索引，如果
index是-1或者等于行数，新行作为最后一行附加。如果省略index，则默认值是-1。
返回值
一个引用新行的 HTMLTableRowElement。
异常
IndexSizeErrorDOMException-
如果
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 # dom-tbody-insertrow |
浏览器兼容性
Loading…