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.
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 vonabbr
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 vonid
-Werten von<th>
-Elementen beschreibt, die Header darstellen, die mit der Zelle verknüpft sind. Sie spiegelt dasheaders
-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ürscope
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-Eigenschafttext-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-Eigenschaftvertical-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-Eigenschaftwidth
.
Spezifikationen
Specification |
---|
HTML Standard # htmltablecellelement |
Browser-Kompatibilität
BCD tables only load in the browser