tr 要素

4.9.8 tr 要素

カテゴリー
なし
この要素を使うことができるコンテキスト：
thead 要素の子として。
tbody 要素の子として。
tfoot要素の子として。
table 要素の子として：ただし、caption, colgroup, thead 要素の後に位置し、table 要素の子となる tbody 要素が他にない場合に限ります。
コンテンツ・モデル：
0 個以上 td 要素か th 要素
コンテンツ属性：
グローバル属性
DOMインタフェース：
interface HTMLTableRowElement : HTMLElement {
  readonly attribute long rowIndex;
  readonly attribute long sectionRowIndex;
  readonly attribute HTMLCollection cells;
  HTMLElement insertCell(optional in long index);
  void deleteCell(in long index);
};

tr 要素は、テーブルの中のセルの行を表します。

tr 要素は、テーブル・モデルに属します。

tr . rowIndex

テーブルの rows リスト内における行の位置を表します。

該当の要素がテーブルになければ、-1 を返します。

tr . sectionRowIndex

テーブル・セクションの rows リスト内における行の位置を返します。

該当の要素がテーブル・セクション内になければ、-1 を返します。

tr . cells

行の td 要素と th 要素の HTMLCollection を返します。

cell = tr . insertCell( [ index ] )

td 要素を生成し、引数で指定された位置にあるそのテーブル行にそれを挿入します。そして、その td 要素を返します。

その位置は、行内のセルに対応します。index が -1 なら、それは引数が省略された場合のデフォルトではありますが、行末に挿入することに相当します。

指定の位置が -1 より小さい、または、セルの数より大きいなら、INDEX_SIZE_ERR 例外を投げます。

tr . deleteCell(index)

行内の指定位置にある td または th 要素を削除します。

その位置は、行内のセルに対応します。index が -1 なら、それは行末のセルを削除することに相当します。

指定された位置が -1 より小さい、または、最後のセルの index より大きい場合や、該当のセルがない場合は、INDEX_SIZE_ERR を例外を投げます。

rowIndex 属性は、親が table 要素の場合、もしくは、親が tbody, thead, tfoot 要素で、さらにその親が table 要素の場合は、table 要素の rows コレクション内での該当の tr 要素の index を返さなければいけません。そのような table 属性がなければ、この属性は -1 を返さなければいけません。

sectionRowIndex 属性は、親が table, tbody, thead, tfoot 要素なら、親要素の rows コレクション内における該当の tr 要素の index を返さなければいけません（テーブルであれば、その rows コレクション、そして、テーブル・セクションであれば、その rows コレクション）。該当の親要素がなければ、この属性は -1 を返さなければいけません。

cells 属性は、tr 要素をルートとした HTMLCollection を返さなければいけません。そのフィルターは、その tr 要素の子となる td と th 要素のみに一致します。

insertCell(index) メソッドは、次の通りに動作しなければいけません：

index が -1 より小さい、または、cells コレクションの要素数より大きければ、このメソッドは INDEX_SIZE_ERR 例外を発出しなければいけません。

index がない、または、-1 に等しい、または、cells コレクションの項目数に等しいなら、このメソッドは td 要素を作成し、tr 要素にそれを追加し、新たに生成した td 要素を返さなければいけません。

そうでなければ、このメソッドは、td 要素を生成し、cells コレクションの要素のうち、指定の index の位置にある td または th 要素の直前に、tr 要素の子としてそれを挿入し、最後に、新たに生成したその td 要素を返さなければいけません。

deleteCell(index) メソッドは、その親から、cells コレクションの要素のうち、指定の index の位置にある要素を削除しなければいけません。index が 0 より小さい、または、cells コレクションの要素数に等しい、またはそれより大きいなら、このメソッドは、INDEX_SIZE_ERR 例外を発出しなければいけません。

※ 原文：http://www.w3.org/TR/2011/WD-html5-20110525/tabular-data.html#the-tr-element