HTMLTableElement

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLTableElement.caption

Ein HTMLTableCaptionElement, das das erste <caption>-Elementkind der gegebenen <table> darstellt, oder null, wenn kein solches Element existiert. Diese Eigenschaft kann zugewiesen werden, wodurch das vorhandene erste <caption>-Elementkind, falls vorhanden, entfernt und der gegebene Wert, falls nicht null, als erstes Kind eingefügt wird. Wenn der zugewiesene Wert kein HTMLTableCaptionElement oder null ist, wird eine TypeError ausgelöst.

HTMLTableElement.tHead

Ein HTMLTableSectionElement, das das erste <thead>-Elementkind der gegebenen <table> darstellt, oder null, wenn kein solches Element existiert. Diese Eigenschaft kann zugewiesen werden, wodurch das vorhandene erste <thead>-Elementkind, falls vorhanden, entfernt und der gegebene Wert, falls nicht null, unmittelbar vor dem ersten Elementkind eingefügt wird, das weder eine <caption> noch eine <colgroup> ist, oder als letztes Kind, wenn kein solches Element vorhanden ist. Wenn der zugewiesene Wert kein HTMLTableSectionElement oder null ist, wird eine TypeError ausgelöst; andernfalls, wenn es kein <thead>-Element oder null ist, wird eine HierarchyRequestError-DOMException ausgelöst.

HTMLTableElement.tFoot

Ein HTMLTableSectionElement, das das erste <tfoot>-Elementkind der gegebenen <table> darstellt, oder null, wenn kein solches Element existiert. Diese Eigenschaft kann zugewiesen werden, wodurch das vorhandene erste <tfoot>-Elementkind, falls vorhanden, entfernt und der gegebene Wert, falls nicht null, als letztes Kind eingefügt wird. Wenn der zugewiesene Wert kein HTMLTableSectionElement oder null ist, wird eine TypeError ausgelöst; andernfalls, wenn es kein <tfoot>-Element oder null ist, wird eine HierarchyRequestError-DOMException ausgelöst.

HTMLTableElement.rows Schreibgeschützt

Gibt eine lebendige HTMLCollection aller <tr>-Elemente zurück, die Kind des gegebenen <table>-Elements oder Kind eines der <thead>, <tbody> und <tfoot> der Tabelle sind. Die Mitglieder des <thead> erscheinen zuerst, gefolgt von Mitgliedern des <tbody> und der Tabelle selbst, und Mitglieder des <tfoot> kommen zuletzt, sortiert nach Baumreihenfolge innerhalb jeder Gruppe. Das zurückgegebene Objekt wird automatisch aktualisiert, wenn sich das HTMLTableElement ändert.

HTMLTableElement.tBodies Schreibgeschützt

Gibt eine lebendige HTMLCollection aller <tbody>-Elementkinder der gegebenen <table> zurück. Das zurückgegebene Objekt wird automatisch aktualisiert, wenn sich das HTMLTableElement ändert.

Veraltete Eigenschaften

HTMLTableElement.align

Ein String, der einen Enum-Wert enthält, der das align-Attribut widerspiegelt. Es zeigt die Ausrichtung des Inhalts des Elements in Bezug auf den umgebenden Kontext an. Die möglichen Werte sind "left", "right" und "center".

HTMLTableElement.bgColor

Ein String, der die Hintergrundfarbe der Zellen enthält. Es spiegelt das veraltete bgColor-Attribut wider.

HTMLTableElement.border

Ein String, der die Breite der Umrandung der Tabelle in Pixeln enthält. Es spiegelt das veraltete border-Attribut wider.

HTMLTableElement.cellPadding

Ein String, der die Breite des horizontalen und vertikalen Abstands zwischen Zelleninhalt und -grenzen in Pixeln enthält. Es spiegelt das veraltete cellpadding-Attribut wider.

HTMLTableElement.cellSpacing

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

HTMLTableElement.frame

Ein String, der den Typ der äußeren Rahmen der Tabelle enthält. Es 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

Ein String, der den Typ der inneren Rahmen der Tabelle enthält. Es spiegelt das veraltete rules-Attribut wider und kann einen der folgenden Werte annehmen: "none", "groups", "rows", "cols" oder "all".

HTMLTableElement.summary

Ein String, der eine Beschreibung des Zwecks oder der Struktur der Tabelle enthält. Es spiegelt das veraltete summary-Attribut wider.

HTMLTableElement.width

Ein String, der die Länge in Pixeln oder in Prozent der gewünschten Breite der gesamten Tabelle enthält. Es spiegelt das veraltete width-Attribut wider.

Instanzmethoden

Erbt Methoden von seinem Elternteil, HTMLElement.

HTMLTableElement.createTHead()

Erstellt ein <thead>-Element, fügt es vor dem ersten Elementkind der gegebenen <table> ein, das weder ein <caption> noch ein <colgroup> ist, oder als letztes Kind, wenn keine solche Einfügestelle gefunden wird, und gibt es zurück. Wenn die Tabelle bereits ein <thead>-Elementkind hat, gibt diese Methode das erste solche Kind zurück, ohne eines zu erstellen.

HTMLTableElement.deleteTHead()

Entfernt das erste <thead>-Elementkind aus einer gegebenen <table>, falls vorhanden.

HTMLTableElement.createTFoot()

Erstellt ein <tfoot>-Element, fügt es als letztes Kind der gegebenen <table> ein und gibt es zurück. Wenn die Tabelle bereits ein <tfoot>-Elementkind hat, gibt diese Methode das erste solche Kind zurück, ohne eines zu erstellen.

HTMLTableElement.deleteTFoot()

Entfernt das erste <tfoot>-Elementkind aus einer gegebenen <table>, falls vorhanden.

HTMLTableElement.createTBody()

Erstellt ein <tbody>-Element, fügt es unmittelbar nach dem letzten <tbody>-Elementkind der gegebenen <table> ein, oder als letztes Kind, wenn kein solches Element vorhanden ist, und gibt es zurück.

HTMLTableElement.createCaption()

Erstellt ein <caption>-Element, fügt es als erstes Kind der gegebenen <table> ein, und gibt es zurück. Wenn die Tabelle bereits ein <caption>-Elementkind hat, gibt diese Methode das erste solche Kind zurück, ohne eines zu erstellen.

HTMLTableElement.deleteCaption()

Entfernt das erste <caption>-Elementkind aus einer gegebenen <table>, falls vorhanden.

HTMLTableElement.insertRow()

Erstellt ein <tr>-Element, fügt es an der angegebenen Position in der rows-Sammlung ein und gibt es zurück. Wenn die rows-Sammlung leer ist und die Tabelle auch keine <tbody>-Elemente hat, wird zuerst ein <tbody>-Element erstellt und eingefügt.

HTMLTableElement.deleteRow()

Entfernt eine bestimmte Zeile (<tr>) aus einer gegebenen <table>. Wenn index -1 ist, wird die letzte Zeile entfernt.

Beispiele

Nutzung des DOM-Tabellen-Interfaces

Das HTMLTableElement-Interface bietet einige praktische Methoden zum Erstellen und Manipulieren von Tabellen. Zwei häufig verwendete Methoden sind HTMLTableElement.insertRow und HTMLTableRowElement.insertCell.

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

<table id="table0">
  <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, welches diese Schnittstelle implementiert: <table>.