Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Метод 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.

Смотри также

Метки документа и участники

 Внесли вклад в эту страницу: 4rontender
 Обновлялась последний раз: 4rontender,