HTMLTableCellElement

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.

Die HTMLTableCellElement-Schnittstelle bietet spezielle Eigenschaften und Methoden (zusätzlich zu der regulären HTMLElement-Schnittstelle, die ihr auch durch Vererbung zur Verfügung steht) zur Manipulation des Layouts und der Darstellung von Tabellenzellen, entweder Kopfzellen (<th>) oder Datenzellen (<td>), in einem HTML-Dokument.

EventTarget Node Element HTMLElement HTMLTableCellElement

Instanzeigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLTableCellElement.abbr

Ein String, der auf <th>-Elementen verwendet werden kann (nicht auf <td>) und eine alternative Bezeichnung für die Kopfzelle angibt. Diese alternative Bezeichnung kann in anderen Kontexten verwendet werden, wie z.B. bei der Beschreibung der Header, die für eine Datenzelle gelten. Dies ist besonders wertvoll für Screenreader und stellt ein nützliches Werkzeug für die Barrierefreiheit dar. Normalerweise ist der Wert von abbr eine Abkürzung oder ein Akronym, kann aber auch beliebiger Text sein, der kontextuell geeignet ist.

HTMLTableCellElement.cellIndex Nur lesbar

Eine Zahl, die die Position der Zelle in der cells-Sammlung des <tr> angibt, in dem sich die Zelle befindet. Gehört die Zelle nicht zu einem <tr>, wird -1 zurückgegeben.

HTMLTableCellElement.colSpan

Eine positive Zahl, die angibt, über wie viele Spalten sich diese Zelle erstrecken muss; dies ermöglicht es der Zelle, Platz über mehrere Spalten der Tabelle einzunehmen. Sie spiegelt das colspan-Attribut wider.

HTMLTableCellElement.headers Nur lesbar

Eine DOMTokenList, die eine Liste von id-Werten von <th>-Elementen beschreibt, die Header darstellen, die mit der Zelle verknüpft sind. Sie spiegelt das headers-Attribut wider.

HTMLTableCellElement.rowSpan

Eine positive Zahl, die angibt, über wie viele Zeilen sich diese Zelle erstrecken muss; dies ermöglicht es der Zelle, Platz über mehrere Zeilen der Tabelle einzunehmen. Sie spiegelt das rowspan-Attribut wider.

HTMLTableCellElement.scope

Ein String, der den Geltungsbereich einer <th>-Zelle angibt. Mögliche Werte für scope sind: col, colgroup, row, rowgroup oder der leere String ("").

Instanzmethoden

Keine spezifische Methode; erbt Methoden von seinem Elternteil, HTMLElement.

Veraltete Eigenschaften

Warnung: Diese Eigenschaften sind veraltet und sollten nicht mehr verwendet werden. Sie werden hauptsächlich dokumentiert, um das Verständnis älterer Codebasen zu unterstützen.

HTMLTableCellElement.align Veraltet

Ein String, der den Wert des align-Attributs enthält, falls vorhanden, oder einen leeren String, falls nicht gesetzt. Es kann verwendet werden, um die Ausrichtung des Inhalts des Elements im umgebenden Kontext auf "left", "right" und "center" zu setzen. Verwenden Sie stattdessen die CSS-Eigenschaft text-align.

HTMLTableCellElement.axis Veraltet

Ein String, der eine Namensgruppierung von Zellen in virtuellen beschreibt. Es spiegelt das veraltete axis-Attribut wider.

HTMLTableCellElement.bgColor Veraltet

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

HTMLTableCellElement.ch Veraltet

Ein String, der ein einzelnes Zeichen enthält. Dieses Zeichen ist dasjenige, an dem alle Zellen einer Spalte ausgerichtet werden. Es spiegelt das char-Attribut wider und basiert auf den Dezimalpunkten der Sprache, z.B. '.' für Englisch oder ',' für Französisch. Diese Eigenschaft war optional und wurde nicht sehr gut unterstützt.

HTMLTableCellElement.chOff Veraltet

Ein String, der eine ganze Zahl enthält, die angibt, wie viele Zeichen rechts (bei links-nach-rechts-Schriften; oder links bei rechts-nach-links-Schriften) des Zeichens definiert in HTMLTableCellElement.ch verbleiben müssen. Diese Eigenschaft war optional und wurde nicht sehr gut unterstützt.

HTMLTableCellElement.height Veraltet

Ein String, der eine Pixel-Länge der empfohlenen Höhe der Zelle enthält. Es spiegelt das veraltete height-Attribut wider.

HTMLTableCellElement.noWrap Veraltet

Ein boolescher Wert, der das nowrap-Attribut widerspiegelt und angibt, ob der Zellinhalt in mehrere Zeilen umgebrochen werden kann.

HTMLTableCellElement.vAlign Veraltet

Ein String, der einen Aufzählungswert darstellt, der angibt, wie der Inhalt der Zelle vertikal ausgerichtet werden muss. Es spiegelt das valign-Attribut wider und kann einen der folgenden Werte haben: "top", "middle", "bottom" oder "baseline". Verwenden Sie stattdessen die CSS-Eigenschaft vertical-align.

HTMLTableCellElement.width Veraltet

Ein String, der die Anzahl der Pixel angibt, die die Breite der Zelle idealerweise haben sollte. Diese Eigenschaft spiegelt das ebenfalls veraltete width-Attribut wider. Verwenden Sie stattdessen die CSS-Eigenschaft width.

Spezifikationen

Specification
HTML Standard
# htmltablecellelement

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • Die HTML-Elemente, die diese Schnittstelle implementieren: <th> und <td>.