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 bereit, 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, die die Schnittstelle von HTMLElement erbt.
Instanzeigenschaften
Erbt Eigenschaften von der übergeordneten Schnittstelle HTMLElement.
HTMLTableCellElement.abbr-
Eine Zeichenfolge, die für
<th>-Elemente verwendet werden kann (nicht für<td>) und eine alternative Beschriftung für die Kopfzelle angibt. Diese kann in anderen Zusammenhängen verwendet werden, beispielsweise bei der Beschreibung der Kopfzellen, die einer Datenzelle zugeordnet sind. Insbesondere Screenreader können so eine kürzere Bezeichnung verwenden; die Eigenschaft ist daher ein wichtiges Hilfsmittel für die Barrierefreiheit. Der Wert vonabbrist üblicherweise eine Abkürzung oder ein Akronym, kann aber jeder im jeweiligen Kontext passende Text sein. HTMLTableCellElement.cellIndexSchreibgeschützt-
Eine Zahl, die die Position der Zelle in der
cells-Sammlung des<tr>-Elements angibt, in dem sich die Zelle befindet. Gehört die Zelle nicht zu einem<tr>, wird-1zurückgegeben. HTMLTableCellElement.colSpan-
Eine positive Zahl, die angibt, über wie viele Spalten sich die Zelle erstrecken soll. Dadurch kann die Zelle mehrere Spalten der Tabelle belegen. Sie spiegelt das Attribut
colspanwider. HTMLTableCellElement.headers-
Eine
DOMTokenList, die eine Liste vonid-Werten der<th>-Elemente beschreibt, die der Zelle als Kopfzellen zugeordnet sind. Sie spiegelt das Attributheaderswider. HTMLTableCellElement.rowSpan-
Eine positive Zahl, die angibt, über wie viele Zeilen sich die Zelle erstrecken soll. Dadurch kann die Zelle mehrere Zeilen der Tabelle belegen. Sie spiegelt das Attribut
rowspanwider. HTMLTableCellElement.scope-
Eine Zeichenfolge, die den Geltungsbereich einer
<th>-Zelle angibt. Mögliche Werte fürscopesindcol,colgroup,row,rowgroupoder die leere Zeichenfolge ("").
Veraltete Eigenschaften
Warnung: Diese Eigenschaften sind veraltet und sollten nicht mehr verwendet werden. Sie sind vor allem dokumentiert, um das Verständnis älterer Codebestände zu erleichtern.
HTMLTableCellElement.align-
Eine Zeichenfolge, die den Wert des Attributs
alignenthält, sofern es vorhanden ist, andernfalls eine leere Zeichenfolge. Mit ihr lässt sich die Ausrichtung des Elementinhalts auf"left","right"oder"center"festlegen. Verwenden Sie stattdessen die CSS-Eigenschafttext-align. HTMLTableCellElement.axis-
Eine Zeichenfolge mit einem Namen, der Zellen virtuell gruppiert. Sie spiegelt das veraltete Attribut
axiswider. HTMLTableCellElement.bgColor-
Eine Zeichenfolge, die die Hintergrundfarbe der Zellen enthält. Sie spiegelt das veraltete Attribut
bgColorwider. HTMLTableCellElement.ch-
Eine Zeichenfolge mit genau einem Zeichen, an dem alle Zellen einer Spalte ausgerichtet werden. Sie spiegelt das Attribut
charwider und hat standardmäßig den für die jeweilige Sprache üblichen Dezimaltrenner als Wert, beispielsweise'.'für Englisch oder','für Französisch. Diese Eigenschaft war optional und wurde nur unzureichend unterstützt. HTMLTableCellElement.chOff-
Eine Zeichenfolge mit einer Ganzzahl, die angibt, wie viele Zeichen rechts von dem durch
HTMLTableCellElement.chdefinierten Zeichen frei bleiben müssen (bei von links nach rechts geschriebenen Schriften; bei von rechts nach links geschriebenen Schriften links davon). Diese Eigenschaft war optional und wurde nur unzureichend unterstützt. HTMLTableCellElement.height-
Eine Zeichenfolge mit einer Pixelangabe für die vorgeschlagene Höhe der Zelle. Sie spiegelt das veraltete Attribut
heightwider. HTMLTableCellElement.noWrap-
Ein boolescher Wert, der das Attribut
nowrapwiderspiegelt und angibt, ob der Zelleninhalt auf mehrere Zeilen umgebrochen werden darf. HTMLTableCellElement.vAlign-
Eine Zeichenfolge mit einem Aufzählungswert, der angibt, wie der Zelleninhalt vertikal ausgerichtet werden soll. Sie 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-
Eine Zeichenfolge, die angibt, wie breit die Zelle nach Möglichkeit in Pixeln 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 |