HTMLTableElement

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⁩.

* Some parts of this feature may have varying levels of support.

Das HTMLTableElement-Interface bietet spezielle Eigenschaften und Methoden (über die regulären HTMLElement-Objektschnittstellen hinaus, die es auch durch Vererbung zur Verfügung hat) zur Manipulation des Layouts und der Darstellung von Tabellen in einem HTML-Dokument.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLTableElement.caption: Ein HTMLTableCaptionElement, das das erste <caption> darstellt, welches ein Kind des Elements ist, oder null, wenn keines gefunden wird. Wenn es gesetzt wird und das Objekt kein <caption> darstellt, wird ein DOMException mit dem Namen HierarchyRequestError ausgelöst. Wenn ein korrektes Objekt gegeben ist, wird es als erstes Kind dieses Elements in den Baum eingefügt und das erste <caption>, das ein Kind dieses Elements ist, wird aus dem Baum entfernt, falls vorhanden.
HTMLTableElement.tHead: Ein HTMLTableSectionElement, das das erste <thead> darstellt, welches ein Kind des Elements ist, oder null, wenn keines gefunden wird. Wenn es gesetzt wird und das Objekt kein <thead> darstellt, wird ein DOMException mit dem Namen HierarchyRequestError ausgelöst. Wenn ein korrektes Objekt gegeben ist, wird es unmittelbar vor dem ersten Element, das weder ein <caption> noch ein <colgroup> ist, oder als letztes Kind eingefügt, falls kein solches Element existiert, und das erste <thead>, das ein Kind dieses Elements ist, wird aus dem Baum entfernt, falls vorhanden.
HTMLTableElement.tFoot: Ein HTMLTableSectionElement, das das erste <tfoot> darstellt, welches ein Kind des Elements ist, oder null, wenn keines gefunden wird. Wenn es gesetzt wird und das Objekt kein <tfoot> darstellt, wird ein DOMException mit dem Namen HierarchyRequestError ausgelöst. Wenn ein korrektes Objekt gegeben ist, wird es unmittelbar vor dem ersten Element, das weder ein <caption>, <colgroup> noch ein <thead> ist, oder als letztes Kind eingefügt, falls kein solches Element existiert, und das erste <tfoot>, das ein Kind dieses Elements ist, wird aus dem Baum entfernt, falls vorhanden.
HTMLTableElement.rows Schreibgeschützt: Gibt eine live HTMLCollection zurück, die alle Zeilen des Elements enthält, das heißt alle <tr>, die ein Kind des Elements oder ein Kind eines seiner <thead>, <tbody> und <tfoot> Kindelemente sind. Die Zeilenmitglieder eines <thead> erscheinen zuerst, in Baumreihenfolge, und die Mitglieder eines <tbody> zuletzt, ebenfalls in Baumreihenfolge. Die HTMLCollection ist live und wird automatisch aktualisiert, wenn sich das HTMLTableElement ändert.
HTMLTableElement.tBodies Schreibgeschützt: Gibt eine live HTMLCollection zurück, die alle <tbody> des Elements enthält. Die HTMLCollection ist live und wird automatisch aktualisiert, wenn sich das HTMLTableElement ändert.

Veraltete Eigenschaften

Warnung: Die folgenden Eigenschaften sind veraltet. Sie sollten deren Verwendung vermeiden.

HTMLTableElement.align Veraltet: Ein String, der einen Enumerationswert enthält, der das align-Attribut widerspiegelt. Er gibt die Ausrichtung des Inhalts des Elements in Bezug auf den umgebenden Kontext an. Die möglichen Werte sind "left", "right" und "center".
HTMLTableElement.bgColor Veraltet: Ein String, der die Hintergrundfarbe der Zellen enthält. Er spiegelt das veraltete bgColor-Attribut wider.
HTMLTableElement.border Veraltet: Ein String, der die Breite in Pixeln des Rahmens der Tabelle enthält. Er spiegelt das veraltete border-Attribut wider.
HTMLTableElement.cellPadding Veraltet: Ein String, der die Breite in Pixeln des horizontalen und vertikalen Abstands zwischen Zellinhalt und Zellrahmen enthält. Er spiegelt das veraltete cellpadding-Attribut wider.
HTMLTableElement.cellSpacing Veraltet: Ein String, der die Breite in Pixeln des horizontalen und vertikalen Abstands zwischen den Zellen enthält. Er spiegelt das veraltete cellspacing-Attribut wider.
HTMLTableElement.frame Veraltet: Ein String, der die Art der äußeren Ränder der Tabelle enthält. Er spiegelt das veraltete frame-Attribut wider und kann einen der folgenden Werte annehmen: "void", "above", "below", "hsides", "vsides", "lhs", "rhs", "box" oder "border".
HTMLTableElement.rules Veraltet: Ein String, der die Art der inneren Ränder der Tabelle enthält. Er spiegelt das veraltete rules-Attribut wider und kann einen der folgenden Werte annehmen: "none", "groups", "rows", "cols" oder "all".
HTMLTableElement.summary Veraltet: Ein String, der eine Beschreibung des Zwecks oder der Struktur der Tabelle enthält. Er spiegelt das veraltete summary-Attribut wider.
HTMLTableElement.width Veraltet: Ein String, der die Länge in Pixeln oder in Prozent der gewünschten Breite der gesamten Tabelle enthält. Er spiegelt das veraltete width-Attribut wider.

Instanz-Methoden

Erbt Methoden von seinem Elternteil, HTMLElement.

HTMLTableElement.createTHead(): Gibt ein HTMLTableSectionElement zurück, das das erste <thead> darstellt, welches ein Kind des Elements ist. Wenn keines gefunden wird, wird ein neues erstellt und unmittelbar vor dem ersten Element, das weder ein <caption> noch ein <colgroup> ist, oder als letztes Kind, falls ein solches Element nicht existiert, in den Baum eingefügt.
HTMLTableElement.deleteTHead(): Entfernt das erste <thead>, das ein Kind des Elements ist.
HTMLTableElement.createTFoot(): Gibt ein HTMLTableSectionElement zurück, das das erste <tfoot> darstellt, welches ein Kind des Elements ist. Wenn keines gefunden wird, wird ein neues erstellt und als letztes Kind in den Baum eingefügt.
HTMLTableElement.deleteTFoot(): Entfernt das erste <tfoot>, das ein Kind des Elements ist.
HTMLTableElement.createTBody(): Gibt ein HTMLTableSectionElement zurück, das ein neues <tbody> darstellt, welches ein Kind des Elements ist. Es wird in den Baum eingefügt, nach dem letzten Element, das ein <tbody> ist, oder als letztes Kind, falls ein solches Element nicht existiert.
HTMLTableElement.createCaption(): Gibt ein HTMLElement zurück, das das erste <caption> darstellt, welches ein Kind des Elements ist. Wenn keines gefunden wird, wird ein neues erstellt und als erstes Kind des <table>-Elements in den Baum eingefügt.
HTMLTableElement.deleteCaption(): Entfernt das erste <caption>, das ein Kind des Elements ist.
HTMLTableElement.insertRow(): Gibt ein HTMLTableRowElement zurück, das eine neue Zeile der Tabelle darstellt. Es wird in die Zeilensammlung unmittelbar vor dem <tr>-Element an der angegebenen index-Position eingefügt. Falls notwendig, wird ein <tbody> erstellt. Wenn der index -1 ist, wird die neue Zeile an die Sammlung angehängt. Wenn der index kleiner als -1 oder größer als die Anzahl der Zeilen in der Sammlung ist, wird ein DOMException mit dem Wert IndexSizeError ausgelöst.
HTMLTableElement.deleteRow(): Entfernt die Zeile, die dem angegebenen index-Parameter entspricht. Wenn der index-Wert -1 ist, wird die letzte Zeile entfernt; wenn er kleiner als -1 oder größer als die Anzahl der Zeilen in der Sammlung ist, wird ein DOMException mit dem Wert IndexSizeError ausgelöst.

Beispiele

Verwendung der DOM-Tabellen-Schnittstelle

Das HTMLTableElement-Interface bietet einige praktische Methoden zum Erstellen und Manipulieren von Tabellen. Zwei häufig verwendete Methoden sind HTMLTableElement.insertRow und HTMLTableRowElement.insertCell.

Um eine Zeile und einige Zellen zu einer bestehenden Tabelle hinzuzufügen:

html

<table id="table0">
  <tr>
    <td>Row 0 Cell 0</td>
    <td>Row 0 Cell 1</td>
  </tr>
</table>

const table = document.getElementById("table0");
const row = table.insertRow(-1);

for (let i = 0; i < 2; i++) {
  const cell = row.insertCell(-1);
  const text = `Row ${row.rowIndex} Cell ${i}`;
  cell.appendChild(document.createTextNode(text));
}

Spezifikationen

Specification
HTML # htmltableelement

Browser-Kompatibilität

Siehe auch

Das HTML-Element, das diese Schnittstelle implementiert: <table>.

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden