Метод HTMLTableElement.insertRow()
добавляет новую строку в таблицу и возвращает на неё ссылку.
Синтаксис
var row = HTMLTableElement.insertRow(optional index = -1);
HTMLTableElement
— ссылка на HTML table элемент.index
— индекс новой строкиrow
присваивается ссылка на новую строку. Ссылка на HTMLTableRowElement.
Если значениеindex
равно -1 или количеству строк, то строка добавляется как последняя. Если значениеindex
превышает количество строк, выбрасывается исключение IndexSizeError. Если аргумент index пропущен, он равен значению по умолчанию — -1.- Если таблица содержит несколько элементов
tbody
, то, по умолчанию, новая строка будет добавлена в последний элементtbody
. Добавить строку в определённый элементtbody
:
var specific_tbody=document.getElementById(tbody_id);
var row=specific_tbody.insertRow(index)
Пример
<table id="TableA">
<tr>
<td>Old top row</td>
</tr>
</table>
<script type="text/javascript">
function addRow(tableID) {
// Get a reference to the table
var tableRef = document.getElementById(tableID);
// Insert a row in the table at row index 0
var newRow = tableRef.insertRow(0);
// Insert a cell in the row at index 0
var newCell = newRow.insertCell(0);
// Append a text node to the cell
var newText = document.createTextNode('New top row');
newCell.appendChild(newText);
}
// Call addRow() with the ID of a table
addRow('TableA');
</script>
Чтобы быть валидным HTML документом, элемент TR должен содержать хотя бы один TD элемент.
Обратите внимание, что insertRow
добавляет строку непосредственно в таблицу и возвращает ссылку на эту строку. Строку не нужно добавлять отдельно, как в случае с методомdocument.createElement(),
для создания нового TR элемента.
Спецификации
Спецификации | Статус | Комментарии |
---|---|---|
HTML Living Standard Определение 'HTMLTableElement.insertRow()' в этой спецификации. |
Живой стандарт | |
Document Object Model (DOM) Level 2 HTML Specification Определение 'HTMLTableElement.insertRow()' в этой спецификации. |
Устаревшая | Specifies in more detail where the row is inserted. |
Document Object Model (DOM) Level 1 Specification Определение 'HTMLTableElement.insertRow()' в этой спецификации. |
Устаревшая | Initial definition |
Поддержка браузерами
We're converting our compatibility data into a machine-readable JSON format.
This compatibility table still uses the old format,
because we haven't yet converted the data it contains.
Find out how you can help!
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 4 | (Да) | 3[1] | 5.5 | 10 | 4 |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? | (Да) | ? | ? | ? | ? |
[1] Начиная с Gecko 20.0 (Firefox 20.0 / Thunderbird 20.0 / SeaMonkey 2.17) аргумент index опционален и значением по умолчанию является -1 согласно спецификации HTML.