DieHTMLTableElement Schnittstelle bietet spezielle Eigenschaften und Methoden (zusätzlich zur regulärenHTMLElement Objekt-Schnittstelle, die es ebenfalls durch Vererbung verfügbar hat) zur Manipulation der Layout- und Präsentationsdarstellung von Tabellen in einem HTML-Dokument.

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil,HTMLElement.

HTMLTableElement.caption

EinHTMLTableCaptionElement, das das erste<caption> darstellt, das ein Kind des Elements ist, odernull, wenn keines gefunden wird. Wenn gesetzt, wird einDOMException mit dem NamenHierarchyRequestError ausgelöst, falls das Objekt kein<caption> darstellt. Wird ein korrektes Objekt übergeben, 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

EinHTMLTableSectionElement, das das erste<thead> darstellt, das ein Kind des Elements ist, odernull, wenn keines gefunden wird. Wenn gesetzt, wird einDOMException mit dem NamenHierarchyRequestError ausgelöst, falls das Objekt kein<thead> darstellt. Wird ein korrektes Objekt übergeben, wird es im Baum unmittelbar vor dem ersten Element eingefügt, das weder ein<caption> noch ein<colgroup> ist, oder als letztes Kind, wenn kein solches Element vorhanden ist, und das erste<thead>, das ein Kind dieses Elements ist, wird aus dem Baum entfernt, falls vorhanden.

HTMLTableElement.tFoot

EinHTMLTableSectionElement, das das erste<tfoot> darstellt, das ein Kind des Elements ist, odernull, wenn keines gefunden wird. Wenn gesetzt, wird einDOMException mit dem NamenHierarchyRequestError ausgelöst, falls das Objekt kein<tfoot> darstellt. Wird ein korrektes Objekt übergeben, wird es im Baum unmittelbar vor dem ersten Element eingefügt, das weder ein<caption>, ein<colgroup> noch ein<thead> ist, oder als letztes Kind, wenn kein solches Element vorhanden ist, und das erste<tfoot>, das ein Kind dieses Elements ist, wird aus dem Baum entfernt, falls vorhanden.

HTMLTableElement.rowsSchreibgeschützt

Gibt eine lebendeHTMLCollection 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 Reihenfolgen der Zeilen in einem<thead> erscheinen zuerst in der Baumreihenfolge, und diese in einem<tbody> zuletzt, ebenfalls in der Baumreihenfolge. DieHTMLCollection ist live und wird automatisch aktualisiert, wenn sich dasHTMLTableElement ändert.

HTMLTableElement.tBodiesSchreibgeschützt

Gibt eine lebendeHTMLCollection zurück, die alle<tbody> des Elements enthält. DieHTMLCollection ist live und wird automatisch aktualisiert, wenn sich dasHTMLTableElement ändert.

Veraltete Eigenschaften

HTMLTableElement.alignVeraltet

Ein String, der einen enumerierten Wert enthält, der dasalign Attribut wiedergibt. 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.bgColorVeraltet

Ein String, der die Hintergrundfarbe der Zellen enthält. Er gibt das veraltetebgColor Attribut wieder.

HTMLTableElement.borderVeraltet

Ein String, der die Breite in Pixeln des Rahmens der Tabelle enthält. Er gibt das veralteteborder Attribut wieder.

HTMLTableElement.cellPaddingVeraltet

Ein String, der die Breite in Pixeln des horizontalen und vertikalen Abstands zwischen Zellinhalt und Zellrändern enthält. Er gibt das veraltetecellpadding Attribut wieder.

HTMLTableElement.cellSpacingVeraltet

Ein String, der die Breite in Pixeln des horizontalen und vertikalen Abstands zwischen Zellen enthält. Er gibt das veraltetecellspacing Attribut wieder.

HTMLTableElement.frameVeraltet

Ein String, der den Typ der äußeren Ränder der Tabelle enthält. Er gibt das veralteteframe Attribut wieder und kann einen der folgenden Werte annehmen:"void","above","below","hsides","vsides","lhs","rhs","box" oder"border".

HTMLTableElement.rulesVeraltet

Ein String, der den Typ der inneren Ränder der Tabelle enthält. Er gibt das veralteterules Attribut wieder und kann einen der folgenden Werte annehmen:"none","groups","rows","cols" oder"all".

HTMLTableElement.summaryVeraltet

Ein String, der eine Beschreibung des Zwecks oder der Struktur der Tabelle enthält. Er gibt das veraltetesummary Attribut wieder.

HTMLTableElement.widthVeraltet

Ein String, der die Länge in Pixeln oder in Prozent der gewünschten Breite der gesamten Tabelle enthält. Er gibt das veraltetewidth Attribut wieder.

Instanzmethoden

Erbt Methoden von seinem Elternteil,HTMLElement.

HTMLTableElement.createTHead()

Gibt einHTMLTableSectionElement zurück, das das erste<thead> darstellt, das ein Kind des Elements ist. Wenn keines gefunden wird, wird ein neues erstellt und im Baum unmittelbar vor dem ersten Element eingefügt, das weder ein<caption> noch ein<colgroup> ist, oder als letztes Kind, wenn kein solches Element vorhanden ist.

HTMLTableElement.deleteTHead()

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

HTMLTableElement.createTFoot()

Gibt einHTMLTableSectionElement zurück, das das erste<tfoot> darstellt, das ein Kind des Elements ist. Wenn keines gefunden wird, wird ein neues erstellt und im Baum als letztes Kind eingefügt.

HTMLTableElement.deleteTFoot()

Entfernt das erste<tfoot>, das ein Kind des Elements ist.

HTMLTableElement.createTBody()

Gibt einHTMLTableSectionElement zurück, das ein neues<tbody> darstellt, das ein Kind des Elements ist. Es wird im Baum nach dem letzten<tbody> Element eingefügt, oder als letztes Kind, wenn kein solches Element vorhanden ist.

HTMLTableElement.createCaption()

Gibt einHTMLElement zurück, das das erste<caption> darstellt, das ein Kind des Elements ist. Wenn keines gefunden wird, wird ein neues erstellt und im Baum als erstes Kind des<table> Elements eingefügt.

HTMLTableElement.deleteCaption()

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

HTMLTableElement.insertRow()

Gibt einHTMLTableRowElement zurück, das eine neue Zeile der Tabelle darstellt. Es wird in die Zeilen-Sammlung sofort vor dem<tr> Element an der angegebenenIndex-Position eingefügt. Bei Bedarf wird ein<tbody> erstellt. Wenn derIndex-1 ist, wird die neue Zeile an das Ende der Sammlung angehängt. 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 der angegebenenIndex-Position entsprechende Zeile. 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.

Beispiele

Verwendung der DOM-Tabellenschnittstelle

DieHTMLTableElement Schnittstelle bietet einige bequeme Methoden zum Erstellen und Manipulieren von Tabellen. Zwei häufig verwendete Methoden sindHTMLTableElement.insertRow undHTMLTableRowElement.insertCell.

Um eine Zeile und einige Zellen zu einer bestehenden Tabelle hinzuzufügen:

<table>  <tbody>    <tr>      <td>Row 0 Cell 0</td>      <td>Row 0 Cell 1</td>    </tr>  </tbody></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>.