HTMLTableElement

Baseline Weitgehend verfgbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Juli 2015 browserbergreifend verfgbar.

* Einige Teile dieser Funktion werden mglicherweise unterschiedlich gut untersttzt.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Das HTMLTableElement Interface bietet spezielle Eigenschaften und Methoden (zustzlich zu der regulren HTMLElement-Objektschnittstelle, die es durch Vererbung ebenfalls zur Verfgung hat) zur Manipulation des Layouts und der Prsentation von Tabellen in einem HTML-Dokument.

EventTarget Node Element HTMLElement 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 eingefgt wird. Wenn der zugewiesene Wert kein HTMLTableCaptionElement oder null ist, wird eine TypeError ausgelst.
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 eingefgt 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 ausgelst; andernfalls, wenn es kein <thead>-Element oder null ist, wird eine HierarchyRequestError-DOMException ausgelst.
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 eingefgt wird. Wenn der zugewiesene Wert kein HTMLTableSectionElement oder null ist, wird eine TypeError ausgelst; andernfalls, wenn es kein <tfoot>-Element oder null ist, wird eine HierarchyRequestError-DOMException ausgelst.
HTMLTableElement.rows Schreibgeschtzt: Gibt eine lebendige HTMLCollection aller <tr>-Elemente zurck, 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 zurckgegebene Objekt wird automatisch aktualisiert, wenn sich das HTMLTableElement ndert.
HTMLTableElement.tBodies Schreibgeschtzt: Gibt eine lebendige HTMLCollection aller <tbody>-Elementkinder der gegebenen <table> zurck. Das zurckgegebene Objekt wird automatisch aktualisiert, wenn sich das HTMLTableElement ndert.

Veraltete Eigenschaften

Warnung: Die folgenden Eigenschaften sind veraltet. Sie sollten deren Nutzung vermeiden.

HTMLTableElement.align: Ein String, der einen Enum-Wert enthlt, der das align-Attribut widerspiegelt. Es zeigt die Ausrichtung des Inhalts des Elements in Bezug auf den umgebenden Kontext an. Die mglichen Werte sind "left", "right" und "center".
HTMLTableElement.bgColor: Ein String, der die Hintergrundfarbe der Zellen enthlt. Es spiegelt das veraltete bgColor-Attribut wider.
HTMLTableElement.border: Ein String, der die Breite der Umrandung der Tabelle in Pixeln enthlt. 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 enthlt. Es spiegelt das veraltete cellpadding-Attribut wider.
HTMLTableElement.cellSpacing: Ein String, der die Breite des horizontalen und vertikalen Abstands zwischen Zellen in Pixeln enthlt. Es spiegelt das veraltete cellspacing-Attribut wider.
HTMLTableElement.frame: Ein String, der den Typ der ueren Rahmen der Tabelle enthlt. 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 enthlt. 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 enthlt. Es spiegelt das veraltete summary-Attribut wider.
HTMLTableElement.width: Ein String, der die Lnge in Pixeln oder in Prozent der gewnschten Breite der gesamten Tabelle enthlt. Es spiegelt das veraltete width-Attribut wider.

Instanzmethoden

Erbt Methoden von seinem Elternteil, HTMLElement.

HTMLTableElement.createTHead(): Erstellt ein <thead>-Element, fgt es vor dem ersten Elementkind der gegebenen <table> ein, das weder ein <caption> noch ein <colgroup> ist, oder als letztes Kind, wenn keine solche Einfgestelle gefunden wird, und gibt es zurck. Wenn die Tabelle bereits ein <thead>-Elementkind hat, gibt diese Methode das erste solche Kind zurck, ohne eines zu erstellen.
HTMLTableElement.deleteTHead(): Entfernt das erste <thead>-Elementkind aus einer gegebenen <table>, falls vorhanden.
HTMLTableElement.createTFoot(): Erstellt ein <tfoot>-Element, fgt es als letztes Kind der gegebenen <table> ein und gibt es zurck. Wenn die Tabelle bereits ein <tfoot>-Elementkind hat, gibt diese Methode das erste solche Kind zurck, ohne eines zu erstellen.
HTMLTableElement.deleteTFoot(): Entfernt das erste <tfoot>-Elementkind aus einer gegebenen <table>, falls vorhanden.
HTMLTableElement.createTBody(): Erstellt ein <tbody>-Element, fgt es unmittelbar nach dem letzten <tbody>-Elementkind der gegebenen <table> ein, oder als letztes Kind, wenn kein solches Element vorhanden ist, und gibt es zurck.
HTMLTableElement.createCaption(): Erstellt ein <caption>-Element, fgt es als erstes Kind der gegebenen <table> ein, und gibt es zurck. Wenn die Tabelle bereits ein <caption>-Elementkind hat, gibt diese Methode das erste solche Kind zurck, ohne eines zu erstellen.
HTMLTableElement.deleteCaption(): Entfernt das erste <caption>-Elementkind aus einer gegebenen <table>, falls vorhanden.
HTMLTableElement.insertRow(): Erstellt ein <tr>-Element, fgt es an der angegebenen Position in der rows-Sammlung ein und gibt es zurck. Wenn die rows-Sammlung leer ist und die Tabelle auch keine <tbody>-Elemente hat, wird zuerst ein <tbody>-Element erstellt und eingefgt.
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 hufig verwendete Methoden sind HTMLTableElement.insertRow und HTMLTableRowElement.insertCell.

Um eine Zeile und einige Zellen zu einer bestehenden Tabelle hinzuzufgen:

html

<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

Spezifikation
HTML # htmltableelement

Browser-Kompatibilitt

Siehe auch

Das HTML-Element, welches diese Schnittstelle implementiert: <table>.

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden