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.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Elternteil, HTMLElement
.
-
Ein
HTMLTableCaptionElement
, das das erste<caption>
darstellt, welches ein Kind des Elements ist odernull
, falls keines gefunden wird. Wird ein Objekt festgelegt, das kein<caption>
darstellt, wird eineDOMException
mit dem NamenHierarchyRequestError
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 odernull
, falls keines gefunden wird. Wird ein Objekt festgelegt, das kein<thead>
darstellt, wird eineDOMException
mit dem NamenHierarchyRequestError
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 odernull
, falls keines gefunden wird. Wird ein Objekt festgelegt, das kein<tfoot>
darstellt, wird eineDOMException
mit dem NamenHierarchyRequestError
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. DieHTMLCollection
ist lebendig und wird automatisch aktualisiert, wenn sich dasHTMLTableElement
ändert. HTMLTableElement.tBodies
Nur lesbar-
Gibt eine lebende
HTMLCollection
zurück, die alle<tbody>
des Elements enthält. DieHTMLCollection
ist lebendig und wird automatisch aktualisiert, wenn sich dasHTMLTableElement
ä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. -
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. -
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 angegebenenindex
-Position ein. Falls notwendig, wird ein<tbody>
erstellt. Wenn derindex
-1
ist, wird die neue Zeile zur Sammlung hinzugefügt. Wenn derindex
kleiner als-1
oder größer als die Anzahl der Zeilen in der Sammlung ist, wird eineDOMException
mit dem WertIndexSizeError
ausgelöst. HTMLTableElement.deleteRow()
-
Entfernt die Zeile, die dem im Parameter angegebenen
index
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 eineDOMException
mit dem WertIndexSizeError
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>
.