HTMLTableSectionElement: deleteRow()-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 deleteRow()
-Methode der HTMLTableSectionElement
-Schnittstelle entfernt eine bestimmte Zeile (<tr>
) aus einem gegebenen <section>
.
Syntax
deleteRow(index)
Parameter
index
-
index
ist ein ganzzahliger Wert, der die Zeile darstellt, die gelöscht werden soll. Der spezielle Index-1
kann jedoch verwendet werden, um die allerletzte Zeile des Abschnitts zu entfernen.
Rückgabewert
Keiner (undefined
).
Ausnahmen
IndexSizeError
DOMException
-
Wird ausgelöst, wenn
index
größer oder gleich der Anzahl der verfügbaren Zeilen ist oder ein negativer Wert, der nicht-1
ist.
Beispiele
In diesem Beispiel ermöglichen zwei Schaltflächen das Hinzufügen und Entfernen von Zeilen aus dem Tabellenkörperschaftsabschnitt; es aktualisiert auch ein <output>
-Element mit der Anzahl der derzeit in der Tabelle vorhandenen Zeilen.
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(); });
Ergebnis
Spezifikationen
Specification |
---|
HTML> # dom-tbody-deleterow> |
Browser-Kompatibilität
Loading…