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 的浏览器中加载。