[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/de/docs/Web/API/HTMLTableSectionElement/insertRow [Back]  [Original]

HTMLTableSectionElement: insertRow() Methode - Web-APIs | MDN

Dieser Inhalt wurde automatisch aus dem Englischen bersetzt, und kann Fehler enthalten. Erfahre mehr ber dieses Experiment.

View in English Always switch to English

HTMLTableSectionElement: insertRow() Methode

Baseline Weitgehend verfgbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Juli 2015 browserbergreifend verfgbar.

Die insertRow() Methode des HTMLTableSectionElement Schnittstelle erstellt ein <tr>-Element, fgt es an der angegebenen Position im gegebenen Tabelle-Abschnittselement (<thead>, <tfoot> oder <tbody>) ein und gibt es zurck.

Diese Methode erstellt und fgt das Element direkt ein, ohne dass separate Aufrufe zu Methoden wie Document.createElement(), Node.insertBefore() und Node.appendChild() erforderlich sind.

In diesem Artikel

Syntax

js
insertRow()
insertRow(index)

Parameter

index Optional

Der Index der neuen Zeile in der rows Sammlung. Wenn index -1 ist oder der Anzahl der Zeilen entspricht, wird die Zeile als letzte Zeile angehngt. Wenn index weggelassen wird, ist der Standardwert -1.

Rckgabewert

Ein HTMLTableRowElement, das auf die neue Zeile verweist.

Ausnahmen

IndexSizeError DOMException

Wird ausgelst, wenn index grer ist als die Anzahl der Zeilen oder kleiner als -1.

Beispiele

In diesem Beispiel ermglichen zwei Schaltflchen, Zeilen im Tabellenkrper hinzuzufgen und zu entfernen; dabei wird auch ein <output>-Element mit der Anzahl der aktuell in der Tabelle vorhandenen Zeilen aktualisiert.

HTML

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

js
// 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

Spezifikation
HTML
# dom-tbody-insertrow

Browser-Kompatibilitt

Siehe auch


Web Proxy Viewer  |  New URL  |  Original Page