HTMLTableSectionElement: insertRow()-Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die insertRow()-Methode des HTMLTableSectionElement-Interfaces fügt eine neue Zeile (<tr>) in das gegebene Tabellenabschnittelement (<thead>, <tfoot> oder <tbody>) ein und gibt dann eine Referenz auf diese neue Zeile zurück.
Hinweis: insertRow() fügt die Zeile direkt in den Abschnitt ein. Die Zeile muss nicht separat angehängt werden, wie es der Fall wäre, wenn Document.createElement() verwendet worden wäre, um das neue <tr>-Element zu erstellen.
Syntax
insertRow() insertRow(index) Parameter
indexOptional-
Der Zeilenindex der neuen Zeile. Wenn
index-1oder gleich der Anzahl der Zeilen ist, wird die Zeile als letzte Zeile angehängt. Wennindexweggelassen wird, ist der Standardwert-1.
Rückgabewert
Ein HTMLTableRowElement, das auf die neue Zeile verweist.
Ausnahmen
IndexSizeErrorDOMException-
Wird ausgelöst, wenn
indexgrößer ist als die Anzahl der Zeilen oder kleiner als-1.
Beispiele
In diesem Beispiel ermöglichen zwei Schaltflächen das Hinzufügen und Entfernen von Zeilen aus dem Tabellenkörperabschnitt; es aktualisiert auch ein <output>-Element mit der Anzahl der derzeit in der Tabelle vorhandenen Zeilen.
HTML
<table> <thead> <tr> <th>Col 1</th> <th>Col 2</th> <th>Col 3</th> </tr> </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(); }); Ergebnis
Spezifikationen
| Specification |
|---|
| HTML # dom-tbody-insertrow |