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.
Instanzeigenschaften
Erbt Eigenschaften von seinem Elternteil, HTMLElement
.
HTMLTableElement.caption
-
Ein
HTMLTableCaptionElement
, das die erste<caption>
repräsentiert, die ein Kind des Elements ist, odernull
, wenn keine gefunden wird. Wird ein Wert gesetzt und es handelt sich nicht um ein<caption>
, wird einDOMException
mit dem NamenHierarchyRequestError
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, odernull
, wenn keine gefunden wird. Wird ein Wert gesetzt und es handelt sich nicht um ein<thead>
, wird einDOMException
mit dem NamenHierarchyRequestError
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, odernull
, wenn keine gefunden wird. Wird ein Wert gesetzt und es handelt sich nicht um ein<tfoot>
, wird einDOMException
mit dem NamenHierarchyRequestError
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. DieHTMLCollection
ist live und wird automatisch aktualisiert, wenn sich dasHTMLTableElement
ändert. HTMLTableElement.tBodies
Schreibgeschützt-
Gibt eine Live-
HTMLCollection
zurück, die alle<tbody>
des Elements enthält. DieHTMLCollection
ist live und wird automatisch aktualisiert, wenn sich dasHTMLTableElement
ä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 angegebenenindex
Position eingefügt. Falls nötig, wird ein<tbody>
erstellt. Wenn derindex
-1
ist, wird die neue Zeile an die Sammlung angehängt. Ist derindex
kleiner als-1
oder größer als die Anzahl der Zeilen in der Sammlung, wird einDOMException
mit dem WertIndexSizeError
ausgelöst. HTMLTableElement.deleteRow()
-
Entfernt die Zeile, die dem angegebenen
index
Parameter entspricht. Wenn derindex
-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 einDOMException
mit dem WertIndexSizeError
ausgelöst.
Spezifikationen
Specification |
---|
HTML # htmltableelement |
Browser-Kompatibilität
Siehe auch
- Das HTML-Element, das dieses Interface implementiert:
<table>
.