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.

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

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

EventTarget Node Element HTMLElement HTMLTableElement

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLTableElement.caption

Ein HTMLTableCaptionElement, das die erste <caption> repräsentiert, die ein Kind des Elements ist, oder null, wenn keine gefunden wird. Wird ein Wert gesetzt und es handelt sich nicht um ein <caption>, wird ein DOMException mit dem Namen HierarchyRequestError ausgelöst. Wenn ein korrektes Objekt übergeben wird, wird es als erstes Kind dieses Elements in den Baum eingefügt und die erste <caption>, die ein Kind dieses Elements ist, wird aus dem Baum entfernt, falls vorhanden.

HTMLTableElement.tHead

Ein HTMLTableSectionElement, das die erste <thead> repräsentiert, die ein Kind des Elements ist, oder null, wenn keine gefunden wird. Wird ein Wert gesetzt und es handelt sich nicht um ein <thead>, wird ein DOMException mit dem Namen HierarchyRequestError ausgelöst. Wenn ein korrektes Objekt übergeben wird, wird es im Baum direkt vor dem ersten Element eingefügt, das weder eine <caption>, noch eine <colgroup> ist, oder als letztes Kind, wenn kein solches Element vorhanden ist, und die erste <thead>, die ein Kind dieses Elements ist, wird aus dem Baum entfernt, falls vorhanden.

HTMLTableElement.tFoot

Ein HTMLTableSectionElement, das die erste <tfoot> repräsentiert, die ein Kind des Elements ist, oder null, wenn keine gefunden wird. Wird ein Wert gesetzt und es handelt sich nicht um ein <tfoot>, wird ein DOMException mit dem Namen HierarchyRequestError ausgelöst. Wenn ein korrektes Objekt übergeben wird, wird es im Baum direkt vor dem ersten Element eingefügt, das weder eine <caption>, noch eine <colgroup>, noch eine <thead> ist, oder als letztes Kind, wenn kein solches Element vorhanden ist, und die erste <tfoot>, die 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, d.h. alle <tr>, die ein Kind des Elements sind, oder ein Kind eines seiner <thead>, <tbody> und <tfoot> Kinder. Die Zeilenmitglieder eines <thead> erscheinen zuerst in Baumordnung und die Mitglieder eines <tbody> zuletzt, ebenfalls in Baumordnung. 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 aufzählbaren Wert enthält, der das align Attribut widerspiegelt. Er gibt die Ausrichtung des Inhalts des Elements im Verhältnis zum 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 des Rahmens der Tabelle in Pixeln enthält. Er spiegelt das veraltete border Attribut wider.

HTMLTableElement.cellPadding Veraltet

Ein String, der die Breite des horizontalen und vertikalen Abstands zwischen Zellinhalten und Zellgrenzen in Pixeln enthält. Er spiegelt das veraltete cellpadding Attribut wider.

HTMLTableElement.cellSpacing Veraltet

Ein String, der die Breite des horizontalen und vertikalen Abstands zwischen Zellen in Pixeln 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.

Instanzmethoden

Erbt Methoden von seinem Elternteil, HTMLElement.

HTMLTableElement.createTHead()

Gibt ein HTMLTableSectionElement zurück, das die erste <thead> repräsentiert, die ein Kind des Elements ist. Wenn keine gefunden wird, wird eine neue erstellt und im Baum direkt vor dem ersten Element eingefügt, das weder eine <caption>, noch eine <colgroup> ist, oder als letztes Kind, wenn kein solches Element vorhanden ist.

HTMLTableElement.deleteTHead()

Entfernt die erste <thead>, die ein Kind des Elements ist.

HTMLTableElement.createTFoot()

Gibt ein HTMLTableSectionElement zurück, das die erste <tfoot> repräsentiert, die ein Kind des Elements ist. Wenn keine gefunden wird, wird eine neue erstellt und als letztes Kind in den Baum eingefügt.

HTMLTableElement.deleteTFoot()

Entfernt die erste <tfoot>, die 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 in den Baum nach dem letzten Element eingefügt, das eine <tbody> ist, oder als letztes Kind, wenn kein solches Element vorhanden ist.

HTMLTableElement.createCaption()

Gibt ein HTMLElement zurück, das die erste <caption> repräsentiert, die ein Kind des Elements ist. Wenn keine gefunden wird, wird eine neue erstellt und im Baum als erstes Kind des <table> Elements eingefügt.

HTMLTableElement.deleteCaption()

Entfernt die erste <caption>, die ein Kind des Elements ist.

HTMLTableElement.insertRow()

Gibt ein HTMLTableRowElement zurück, das eine neue Zeile der Tabelle repräsentiert. Es wird in die Zeilensammlung unmittelbar vor das <tr> Element an der angegebenen index Position eingefügt. Falls nötig, wird ein <tbody> erstellt. Wenn der index -1 ist, wird die neue Zeile an die Sammlung angehängt. Ist der index kleiner als -1 oder größer als die Anzahl der Zeilen in der Sammlung, 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.

Spezifikationen

Specification
HTML
# htmltableelement

Browser-Kompatibilität

Siehe auch

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