HTMLTableRowElement
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.
HTMLTableRowElement
インターフェイスは、(継承によって利用できる通常の HTMLElement
インターフェイスに加えて)HTML の表の行のレイアウトを操作したり行を表したりするための特別なプロパティとメソッドを提供します。
インスタンスプロパティ
親である HTMLElement
から継承したプロパティがあります。
HTMLTableRowElement.cells
読取専用-
行のセルを表す生きた
HTMLCollection
を返します。HTMLCollection
は生きており、セルが追加・削除された際に自動的に更新されます。 HTMLTableRowElement.rowIndex
読取専用-
表全体におけるこの行の論理的な位置を表す
long
値を返します。この行が表の中になかった場合は、-1
を返します。 HTMLTableRowElement.sectionRowIndex
読取専用-
所属する表の区間におけるこの行の論理的な位置を表す
long
値を返します。この行が区間の中になかった場合は、-1
を返します。
インスタンスメソッド
親である HTMLElement
から継承したメソッドがあります。
deleteCell(index)
-
index
の位置に対応するセルを取り除きます。index
が-1
であった場合、末尾のセルを取り除きます。index
が-1
より小さいか、このコレクションにあるセルの数より大きい場合、DOMException
がIndexSizeError
の値で発生します。 insertCell(index)
-
HTMLTableCellElement
でこの行の新しいセルを表します。セルはこのセルのコレクションの中で、行の中のindex
の位置の直前に挿入されます。index
が-1
の場合、新しいセルはコレクションの末尾に追加されます。index
が-1
より小さいか、このコレクションにあるセルの数より大きい場合、DOMException
がIndexSizeError
の値で発生します。
非推奨のプロパティ
警告: これらのプロパティは非推奨になっており、もう使用するべきではありません。これらは主に古いコードベースを理解しやすくすることを目的に文書化されています。
HTMLTableRowElement.align
非推奨;-
文字列で、
align
属性を反映した列挙値です。これは、周囲のコンテキストに対する要素の内容の整列を示す。指定できる値は"left"
,"right"
,"center"
です。 HTMLTableRowElement.bgColor
非推奨;-
文字列で、セルの背景色です。これは、廃止された
bgColor
属性を反映したものです。 HTMLTableRowElement.ch
非推奨;-
文字列で、 1 つの文字を含みます。この文字は、列の全てのセルを揃えるための文字です。これは
char
を反映し、既定では言語に関連付けられた小数点の値、例えば英語なら'.'
、フランス語なら','
となります。このプロパティはオプションであり、あまり対応されていませんでした。 HTMLTableRowElement.chOff
非推奨;-
文字列で、
HTMLTableRowElement.ch
で定義された文字の右側(左書きの場合。右書きの場合は左側)に何文字残さなければならないかを示す整数です。このプロパティはオプションであり、あまり対応されていませんでした。 HTMLTableRowElement.vAlign
非推奨;-
文字列で、セルの内容がどのように垂直方向に配置されるかを示す列挙値です。これは
valign
属性を反映しており、"top"
,"middle"
,"bottom"
,"baseline"
のいずれかになります。
仕様書
Specification |
---|
HTML Standard # htmltablerowelement |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- このインターフェイスを実装している HTML 要素:
<tr>