HTMLTableElement: insertRow() 方法
基线 广泛可用
此功能已得到良好建立,并在许多设备和浏览器版本中运行良好。它自 2015 年 7 月.
报告反馈
**insertRow()
** 是 HTMLTableElement
接口的方法,用于在给定的 <table>
中插入一个新的行 (<tr>
),并返回对该新行的引用。
如果表格具有多个 <tbody>
元素,默认情况下,新行将插入到最后一个 <tbody>
中。若要将行插入到特定部分,请使用 HTMLTableSectionElement.insertRow()
语法
**注意:**
insertRow()
将行直接插入到表格中。无需像使用 Document.createElement()
创建新的 <tr>
元素那样单独附加该行。insertRow()
insertRow(index)
js
HTMLTableElement
是对 HTML <table>
元素的引用。
- 参数
-
index
可选
新行的行索引。如果 index
为 -1
或等于行数,则该行将作为最后一行追加。如果省略 index
,则默认为 -1
。
返回值
引用新行的 HTMLTableRowElement
。
示例
如果 index
大于行数,则抛出此异常。
此示例使用 insertRow(-1)
将新行追加到表格中。
HTML
然后,我们使用
HTMLTableRowElement.insertCell()
在新行中插入新单元格。(要使 HTML 有效,<tr>
必须至少包含一个 <td>
元素。)最后,我们使用 Document.createTextNode()
和 Node.appendChild()
将一些文本添加到单元格中。<table id="my-table">
<tr>
<td>Row 1</td>
</tr>
<tr>
<td>Row 2</td>
</tr>
<tr>
<td>Row 3</td>
</tr>
</table>
JavaScript
**注意:**
insertRow()
将行直接插入到表格中。无需像使用 Document.createElement()
创建新的 <tr>
元素那样单独附加该行。function addRow(tableID) {
// Get a reference to the table
let tableRef = document.getElementById(tableID);
// Insert a row at the end of the table
let newRow = tableRef.insertRow(-1);
// Insert a cell in the row at index 0
let newCell = newRow.insertCell(0);
// Append a text node to the cell
let newText = document.createTextNode("New bottom row");
newCell.appendChild(newText);
}
// Call addRow() with the table's ID
addRow("my-table");
html
规范
结果 |
---|
规范 # HTML 标准 |
浏览器兼容性
dom-table-insertrow-dev