HTMLTableRowElement: insertCell()-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 insertCell()-Methode des HTMLTableRowElement-Interfaces fügt eine neue Zelle (<td>) in eine Tabellenzeile (<tr>) ein und gibt eine Referenz auf die Zelle zurück.
Hinweis:>insertCell() fügt die Zelle direkt in die Zeile ein. Die Zelle muss nicht separat mit Node.appendChild() hinzugefügt werden, wie es der Fall wäre, wenn Document.createElement() verwendet worden wäre, um das neue <td>-Element zu erstellen.
Sie können insertCell() jedoch nicht verwenden, um ein neues <th>-Element zu erstellen.
Syntax
insertCell() insertCell(index) Parameter
indexOptional-
Der Zellindex der neuen Zelle. Wenn
index-1ist oder der Anzahl der Zellen entspricht, wird die Zelle als letzte Zelle in der Zeile hinzugefügt. Wennindexweggelassen wird, ist der Standardwert-1.
Rückgabewert
Ein HTMLTableCellElement, das auf die neue Zelle verweist.
Ausnahmen
IndexSizeErrorDOMException-
Wird ausgelöst, wenn
indexgrößer als die Anzahl der Zellen ist.
Beispiele
Dieses Beispiel verwendet HTMLTableRowElement.insertCell(), um eine neue Zelle an eine Zeile anzuhängen.
HTML
<table> <thead> <tr> <th>C1</th> <th>C2</th> <th>C3</th> <th>C4</th> <th>C5</th> </tr> </thead> <tbody> <tr> <td>Cell 1</td> <td>Cell 2</td> </tr> </tbody> </table> <button id="add">Add a cell</button> <button id="remove">Remove last cell</button> <div>This first row has <output>2</output> cell(s).</div> JavaScript
// Obtain relevant interface elements const bodySection = document.querySelectorAll("tbody")[0]; const row = bodySection.rows[0]; // Select the first row of the body section const cells = row.cells; // The collection is live, therefore always up-to-date const cellNumberDisplay = document.querySelectorAll("output")[0]; const addButton = document.getElementById("add"); const removeButton = document.getElementById("remove"); function updateCellNumber() { cellNumberDisplay.textContent = cells.length; } addButton.addEventListener("click", () => { // Add a new cell at the end of the first row const newCell = row.insertCell(); newCell.textContent = `Cell ${cells.length}`; // Update the row counter updateCellNumber(); }); removeButton.addEventListener("click", () => { // Delete the row from the body row.deleteCell(-1); // Update the row counter updateCellNumber(); }); Ergebnis
Spezifikationen
| Specification |
|---|
| HTML> # dom-tr-insertcell-dev> |
Browser-Kompatibilität
Siehe auch
HTMLTableElement.insertRow()- Das HTML-Element, das Zellen darstellt:
HTMLTableCellElement