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 の表の行のレイアウトを操作したり行を表したりするための特別なプロパティとメソッドを提供します。

EventTarget Node Element HTMLElement HTMLTableRowElement

インスタンスプロパティ

親である HTMLElement から継承したプロパティがあります。

HTMLTableRowElement.cells 読取専用

行のセルを表す生きた HTMLCollection を返します。 HTMLCollection は生きており、セルが追加・削除された際に自動的に更新されます。

HTMLTableRowElement.rowIndex 読取専用

表全体におけるこの行の論理的な位置を表す long 値を返します。この行が表の中になかった場合は、 -1 を返します。

HTMLTableRowElement.sectionRowIndex 読取専用

所属する表の区間におけるこの行の論理的な位置を表す long 値を返します。この行が区間の中になかった場合は、 -1 を返します。

インスタンスメソッド

親である HTMLElement から継承したメソッドがあります。

deleteCell(index)

index の位置に対応するセルを取り除きます。 index-1 であった場合、末尾のセルを取り除きます。 index-1 より小さいか、このコレクションにあるセルの数より大きい場合、 DOMExceptionIndexSizeError の値で発生します。

insertCell(index)

HTMLTableCellElement でこの行の新しいセルを表します。セルはこのセルのコレクションの中で、行の中の index の位置の直前に挿入されます。 index-1 の場合、新しいセルはコレクションの末尾に追加されます。 index-1 より小さいか、このコレクションにあるセルの数より大きい場合、 DOMExceptionIndexSizeError の値で発生します。

非推奨のプロパティ

警告: これらのプロパティは非推奨になっており、もう使用するべきではありません。これらは主に古いコードベースを理解しやすくすることを目的に文書化されています。

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>