HTMLTableCellElement
Baseline
広く利用可能
*
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
* この機能の一部は、対応レベルが異なる場合があります。
HTMLTableCellElement インターフェイスは、（継承によって利用できる通常の HTMLElement インターフェイスに加えて）表のセル（見出しセル <th> またはデータセル <td>）のレイアウトを操作したり行を表したりするための特別なプロパティとメソッドを提供します。
インスタンスプロパティ
親である HTMLElement から継承したプロパティがあります。
HTMLTableCellElement.abbr-
文字列で、
<th>要素上（<td>上ではない）で使用可能であり、見出しセルの代替ラベルを指定します。この代替ラベルは、データセルに適用される見出しを記述するときなど、他のコンテキストで使用することができます。これは、特にスクリーンリーダーが使用するための短い用語を提供するために使用され、貴重なアクセシビリティツールとなります。通常、abbrの値は省略形や頭字語ですが、文脈に応じて適切なテキストを指定することができます。 HTMLTableCellElement.cellIndex読取専用-
数値で、セルが含まれる
<tr>のcellsコレクション内での位置を表します。セルが<tr>に属さない場合は、-1を返します。 HTMLTableCellElement.colSpan-
正の数値で、このセルがまたがなければならない列の数を示します。これにより、セルが表の複数の列を占めるようになります。これは
colspan属性を反映したものです。 HTMLTableCellElement.headers読取専用-
DOMTokenListで、セルに関連する見出しを表す<th>要素のidのリストです。これはheaders属性を反映したものです。 HTMLTableCellElement.rowSpan-
正の数値で、このセルがまたがなければならない行の数を示します。これにより、セルが表の複数の行を占めるようになります。これは
rowspan属性を反映したものです。 HTMLTableCellElement.scope-
<th>セルのスコープを示す文字列です。scopeに指定できる値は、col、colgroup、row、rowgroup、または空文字列 ("") です。
インスタンスメソッド
親である HTMLElement からメソッドを継承しています。
非推奨のプロパティ
警告: これらのプロパティは非推奨になっており、もう使用するべきではありません。これらは主に古いコードベースを理解しやすくすることを目的に文書化されています。
HTMLTableCellElement.align-
文字列で、
align属性の値が（もしあれば）入ります。設定されていない場合は空文字列となります。これを使用することで、要素の内容の配置を、"left"、"right"、"center"のいずれかに設定することができます。代わりに、CSS のtext-alignプロパティを使用してください。 HTMLTableCellElement.axis-
仮想的にセルをグループ化する名前を含む文字列。これは、廃止された
axis属性を反映しています。 HTMLTableCellElement.bgColor-
文字列で、セルの背景色です。これは、廃止された
bgColor属性を反映したものです。 HTMLTableCellElement.ch-
文字列で、 1 つの文字を含みます。この文字は、列の全てのセルを揃えるための文字です。これは
charを反映し、既定では言語に関連付けられた小数点の値、例えば英語なら'.'、フランス語なら','となります。このプロパティはオプションであり、あまり対応されていませんでした。 HTMLTableCellElement.chOff-
文字列で、
HTMLTableCellElement.chで定義された文字の右側（左書きの場合。右書きの場合は左側）に何文字残さなければならないかを示す整数です。このプロパティはオプションであり、あまり対応されていませんでした。 HTMLTableCellElement.height-
文字列で、セルのヒントとなる高さのピクセル数が入ります。これは、廃止された
height属性を反映します。 HTMLTableCellElement.noWrap-
論理値で、
nowrap属性を反映します。セルの内容が複数の行に分割できるかどうかを示します。 HTMLTableCellElement.vAlign-
文字列で、セルの内容がどのように垂直方向に配置されるかを示す列挙値です。これは
valign属性を反映しており、"top","middle","bottom","baseline"のいずれかになります。代わりに CSS のvertical-alignプロパティを使用してください。 HTMLTableCellElement.width-
文字列で、可能であればセルが描画されるべきピクセル幅の数を指定します。このプロパティは、廃止された
width属性を反映します。代わりに CSS のwidthプロパティを使用してください。
仕様書
| 仕様書 |
|---|
| HTML # htmltablecellelement |