HTMLTableElement

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

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:

<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

Browser-Kompatibilität

Siehe auch

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