Элемент HTMLTableSectionElement: метод insertRow()
Базовая линия Широко доступен
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Метод insertRow() интерфейса HTMLTableSectionElement добавляет новую строку (<tr>) в заданный элемент раздела таблицы (<thead>, <tfoot> или <tbody>), а затем возвращает ссылку на эту новую строку.
Примечание: insertRow() добавляет строку непосредственно в раздел. Строка не требует отдельного добавления, как это было бы в случае, если бы для создания нового элемента <tr> использовался Document.createElement().
Синтаксис
insertRow() insertRow(index)
Параметры
indexНеобязательно-
Индекс строки новой строки. Если
indexравно или больше числа строк, строка добавляется в конец. Еслиindexопущено, оно по умолчанию равно-1.
Возвращаемое значение
Объект HTMLTableRowElement, ссылающийся на новую строку.
Исключения
-
IndexSizeErrorDOMException -
Выбрасывается, если
indexбольше, чем количество строк, или меньше, чем-1.
Примеры
В этом примере две кнопки позволяют добавлять и удалять строки из раздела тела таблицы; также обновляется элемент <output> с количеством строк в таблице.
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
// 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 |
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
insertRow |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
См. также
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableSectionElement/insertRow