HTMLTableElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das HTMLTableElement-Interface bietet spezielle Eigenschaften und Methoden (zusätzlich zu den regulären Eigenschaften des HTMLElement-Objekts, die auch durch Vererbung zur Verfügung stehen) zur Manipulation des Layouts und der Präsentation von Tabellen in einem HTML-Dokument.

EventTarget Node Element HTMLElement HTMLTableElement

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, falls keines gefunden wird. Wird ein Objekt festgelegt, das kein <caption> darstellt, wird eine DOMException mit dem Namen HierarchyRequestError ausgelöst. Bei Angabe eines korrekten Objekts wird dieses als erstes Kind des 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, falls keines gefunden wird. Wird ein Objekt festgelegt, das kein <thead> darstellt, wird eine DOMException mit dem Namen HierarchyRequestError ausgelöst. Bei Angabe eines korrekten Objekts wird dieses unmittelbar vor dem ersten Element in den Baum eingefügt, das weder ein <caption> noch ein <colgroup> ist oder als letztes Kind, falls ein solches Element nicht existiert. 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, falls keines gefunden wird. Wird ein Objekt festgelegt, das kein <tfoot> darstellt, wird eine DOMException mit dem Namen HierarchyRequestError ausgelöst. Bei Angabe eines korrekten Objekts wird dieses unmittelbar vor dem ersten Element, das weder ein <caption>, ein <colgroup>, noch ein <thead> ist oder als letztes Kind, falls ein solches Element nicht existiert, in den Baum eingefügt. Das erste <tfoot>, das ein Kind dieses Elements ist, wird aus dem Baum entfernt, falls vorhanden.

HTMLTableElement.rows Nur lesbar

Gibt eine lebende HTMLCollection zurück, die alle Zeilen des Elements enthält, also alle <tr>, die ein Kind des Elements oder eines seiner <thead>, <tbody> und <tfoot>-Kinder sind. Die Zeilen in einem <thead> erscheinen zuerst in Baumreihenfolge, und die Mitglieder eines <tbody> zuletzt, ebenfalls in Baumreihenfolge. Die HTMLCollection ist lebendig und wird automatisch aktualisiert, wenn sich das HTMLTableElement ändert.

HTMLTableElement.tBodies Nur lesbar

Gibt eine lebende HTMLCollection zurück, die alle <tbody> des Elements enthält. Die HTMLCollection ist lebendig und wird automatisch aktualisiert, wenn sich das HTMLTableElement ändert.

Veraltete Eigenschaften

Warnung: Die folgenden Eigenschaften sind veraltet. Sie sollten vermeiden, diese zu verwenden.

HTMLTableElement.align Veraltet

Ein String, der einen enumerierten Wert 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 Raums zwischen Zellinhalt und Zellgrenzen enthält. Er spiegelt das veraltete cellpadding-Attribut wider.

HTMLTableElement.cellSpacing Veraltet

Ein String, der die Breite in Pixeln der horizontalen und vertikalen Trennung zwischen den Zellen enthält. Er spiegelt das veraltete cellspacing-Attribut wider.

HTMLTableElement.frame Veraltet

Ein String, der die Art der äußeren Rahmen 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 Rahmen 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. Falls 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. Falls 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, das ein Kind des Elements ist. Es wird nach dem letzten Element eingefügt, 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. Falls 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 fügt es in die Zeilensammlung unmittelbar vor dem <tr>-Element an der angegebenen index-Position ein. Falls notwendig, wird ein <tbody> erstellt. Wenn der index -1 ist, wird die neue Zeile zur Sammlung hinzugefügt. Wenn der index kleiner als -1 oder größer als die Anzahl der Zeilen in der Sammlung ist, wird eine DOMException mit dem Wert IndexSizeError ausgelöst.

HTMLTableElement.deleteRow()

Entfernt die Zeile, die dem im Parameter angegebenen index 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 eine DOMException mit dem Wert IndexSizeError ausgelöst.

Spezifikationen

Specification
HTML Standard
# htmltableelement

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • Das HTML-Element, das dieses Interface implementiert: <table>.