Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

HTMLTableCellElement

Baseline
Weitgehend verfügbar
*

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Die Schnittstelle HTMLTableCellElement stellt spezielle Eigenschaften und Methoden zur Verfügung, mit denen sich das Layout und die Darstellung von Tabellenzellen in einem HTML-Dokument bearbeiten lassen – sowohl von Kopfzellen (<th>) als auch von Datenzellen (<td>). Diese ergänzen die Eigenschaften und Methoden der regulären Schnittstelle HTMLElement, die durch Vererbung ebenfalls verfügbar sind.

EventTarget Node Element HTMLElement HTMLTableCellElement

Instanzeigenschaften

Erbt Eigenschaften von der übergeordneten Schnittstelle HTMLElement.

HTMLTableCellElement.abbr

Ein String, der für <th>-Elemente (nicht für <td>) verwendet werden kann und eine alternative Bezeichnung für die Kopfzelle angibt. Diese alternative Bezeichnung kann in anderen Kontexten verwendet werden, etwa bei der Beschreibung der Kopfzellen, die einer Datenzelle zugeordnet sind. Sie bietet insbesondere Screenreadern eine kürzere Bezeichnung und ist ein wertvolles Hilfsmittel für die Barrierefreiheit. Der Wert von abbr ist normalerweise eine Abkürzung oder ein Akronym, kann aber auch ein anderer im jeweiligen Kontext geeigneter Text sein.

HTMLTableCellElement.cellIndex Schreibgeschützt

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

HTMLTableCellElement.colSpan

Eine positive Zahl, die angibt, über wie viele Spalten sich die Zelle erstreckt. Dadurch kann die Zelle Platz über mehrere Spalten der Tabelle hinweg einnehmen. Sie spiegelt das Attribut colspan wider.

HTMLTableCellElement.headers Schreibgeschützt

Eine DOMTokenList, die eine Liste der id-Werte von <th>-Elementen beschreibt, die der Zelle zugeordnete Kopfzellen darstellen. Sie spiegelt das Attribut headers wider.

HTMLTableCellElement.rowSpan

Eine positive Zahl, die angibt, über wie viele Zeilen sich die Zelle erstreckt. Dadurch kann die Zelle Platz über mehrere Zeilen der Tabelle hinweg einnehmen. Sie spiegelt das Attribut rowspan 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 ("").

Veraltete Eigenschaften

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

HTMLTableCellElement.align

Ein String mit dem Wert des Attributs align, sofern es vorhanden ist; andernfalls ein leerer String. Damit kann der Inhalt des Elements entsprechend den Werten "left", "right" und "center" ausgerichtet werden. Verwenden Sie stattdessen die CSS-Eigenschaft text-align.

HTMLTableCellElement.axis

Ein String mit einem Namen, der Zellen virtuell gruppiert. Er spiegelt das veraltete Attribut axis wider.

HTMLTableCellElement.bgColor

Ein String mit der Hintergrundfarbe der Zellen. Er spiegelt das veraltete Attribut bgColor wider.

HTMLTableCellElement.ch

Ein String mit einem einzelnen Zeichen, an dem alle Zellen einer Spalte ausgerichtet werden. Er spiegelt das Attribut char wider. Der Standardwert ist das in der jeweiligen Sprache verwendete Dezimaltrennzeichen, beispielsweise '.' für Englisch oder ',' für Französisch. Diese Eigenschaft war optional und wurde nicht besonders gut unterstützt.

HTMLTableCellElement.chOff

Ein String mit einer Ganzzahl, die angibt, wie viele Zeichen rechts vom durch HTMLTableCellElement.ch festgelegten Zeichen verbleiben müssen (bei von links nach rechts geschriebenen Schriften; bei von rechts nach links geschriebenen Schriften entsprechend links davon). Diese Eigenschaft war optional und wurde nicht besonders gut unterstützt.

HTMLTableCellElement.height

Ein String mit der empfohlenen Höhe der Zelle in Pixeln. Er spiegelt das veraltete Attribut height wider.

HTMLTableCellElement.noWrap

Ein boolescher Wert, der das Attribut nowrap widerspiegelt und angibt, ob der Zelleninhalt auf mehrere Zeilen umgebrochen werden kann.

HTMLTableCellElement.vAlign

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

HTMLTableCellElement.width

Ein String, der angibt, mit welcher Breite in Pixeln die Zelle nach Möglichkeit dargestellt werden soll. Diese Eigenschaft spiegelt das ebenfalls veraltete Attribut width wider. Verwenden Sie stattdessen die CSS-Eigenschaft width.

Instanzmethoden

Keine spezifischen Methoden; erbt Methoden von der übergeordneten Schnittstelle HTMLElement.

Spezifikationen

Spezifikation
HTML
# htmltablecellelement

Browser-Kompatibilität

Siehe auch

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