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.
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 vonabbrist normalerweise eine Abkürzung oder ein Akronym, kann aber auch ein anderer im jeweiligen Kontext geeigneter Text sein. HTMLTableCellElement.cellIndexSchreibgeschü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-1zurü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
colspanwider. HTMLTableCellElement.headersSchreibgeschützt-
Eine
DOMTokenList, die eine Liste derid-Werte von<th>-Elementen beschreibt, die der Zelle zugeordnete Kopfzellen darstellen. Sie spiegelt das Attributheaderswider. 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
rowspanwider. HTMLTableCellElement.scope-
Ein String, der den Geltungsbereich einer
<th>-Zelle angibt. Mögliche Werte fürscopesindcol,colgroup,row,rowgroupoder 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-Eigenschafttext-align. HTMLTableCellElement.axis-
Ein String mit einem Namen, der Zellen virtuell gruppiert. Er spiegelt das veraltete Attribut
axiswider. HTMLTableCellElement.bgColor-
Ein String mit der Hintergrundfarbe der Zellen. Er spiegelt das veraltete Attribut
bgColorwider. HTMLTableCellElement.ch-
Ein String mit einem einzelnen Zeichen, an dem alle Zellen einer Spalte ausgerichtet werden. Er spiegelt das Attribut
charwider. 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.chfestgelegten 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
heightwider. HTMLTableCellElement.noWrap-
Ein boolescher Wert, der das Attribut
nowrapwiderspiegelt 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
valignwider und kann einen der folgenden Werte haben:"top","middle","bottom"oder"baseline". Verwenden Sie stattdessen die CSS-Eigenschaftvertical-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
widthwider. Verwenden Sie stattdessen die CSS-Eigenschaftwidth.
Instanzmethoden
Keine spezifischen Methoden; erbt Methoden von der übergeordneten Schnittstelle HTMLElement.
Spezifikationen
| Spezifikation |
|---|
| HTML> # htmltablecellelement> |