HTMLTableCellElement
HTMLTableCellElement インターフェイスは、(継承によって利用できる通常の HTMLElement インターフェイスに加えて)表のセルのレイアウトを操作したり行を表したりするための特別なプロパティとメソッドを提供します。
プロパティ
親である 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プロパティを用いて、指定された行または列、あるいは現在の行グループ内のまだスコープされていないセル(つまり、同じ祖先の<thead>,<tbody>,<tfoot>要素)に適用するように設定することが可能です。もしscopeに何も値が指定されなければ、見出しはこの方法で直接セルと関連付けられることはありません。scopeに指定可能な値は以下の通りです。col-
見出しセルは同じ列(
colspanが使われている場合は列)の続くセルに適用され、列の終わりか列内の別の<th>が新しいスコープを確立するまで適用されます。 colgroup-
見出しセルは、現在の列グループ内の、まだスコープが適用されていないすべてのセルに適用される。この値は、セルが列グループ内にある場合にのみ許可されます。
row-
見出しセルは、同じ行(
rowspanが使われている場合は行)の続くセルに適用され、行の終わりか同じ行の別の<th>が新しいスコープを確立するまで適用されます。 rowgroup-
見出しセルは、現在の行グループ内の、まだスコープが適用されていない全てのセルに適用される。この値は、セルが行グループの中にある場合にのみ許可される。
- The empty string (
"") -
見出しセルは事前に定義された範囲を持ちません。ユーザーエージェントは文脈の手がかりに基づいて範囲を確立します。
メソッド
親である HTMLElement からメソッドを継承しています。
非推奨のプロパティ
警告: これらのプロパティは非推奨になっており、もう使用するべきではありません。これらは主に古いコードベースを理解しやすくすることを目的に文書化されています。
HTMLTableCellElement.align非推奨-
文字列で、
align属性を反映した列挙値です。これは、周囲のコンテキストに対する要素の内容の整列を示す。指定できる値は"left","right","center"です。 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"のいずれかになります。 HTMLTableCellElement.width非推奨-
文字列で、可能であればセルが描画されるべきピクセル幅の数を指定します。このプロパティは、廃止された
width属性を反映します。代わりに CSS のwidthプロパティを使用してください。
仕様書
| Specification |
|---|
| HTML Standard # htmltablecellelement |
ブラウザーの互換性
BCD tables only load in the browser