tbody 要素

4.9.5 tbody 要素

カテゴリー:
なし
この要素を使うことができるコンテキスト:
table 要素の子として。ただし、caption, colgroup, thead 要素より後ろで、table 要素の子となる tr 要素が 1 つもない場合に限ります。
コンテントモデル:
0 個以上の tr 要素とスクリプトサポート要素
コンテント属性:
グローバル属性
text/html におけるタグの省略:
tbody 要素の開始タグは、tbody 要素の中で最初が tr 要素で、かつ、その要素の直前が tbody, thead, tfoot 要素のいずれかであり、それらの終了タグが省略されていたなら(それらの要素が空なら省略できません。)、省略することができます。tbody 要素の終了タグは、tbody 要素の直後に tbodytfoot 要素がある、または、親要素に何もコンテンツがないなら、省略することができます。
指定可能な ARIA role 属性 の値:
あらゆるロールの値
指定可能な ARIA ステートとプロパティ属性:
グローバル aria-* 属性
許可ロールに該当する aria-* 属性
DOM インタフェース:
interface HTMLTableSectionElement : HTMLElement {
  readonly attribute HTMLCollection rows;
  HTMLElement insertRow(optional long index = -1);
  void deleteRow(long index);
};

The HTMLTableSectionElement インタフェースは theadtfoot 要素にも使われます。

tbody 要素は、その tbody 要素が親を持ち、その親要素が table 要素なら、その親の table 要素に対するデータの集まりから構成されるブロック表します。

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

tbody . rows

テーブルセクションの tr 要素の HTMLCollection を返します。

tr = tbody . insertRow( [ index ] )

tr 要素を生成し、テーブルセクションの中の引数に指定された位置に、それを挿入します。そして、その tr 要素を返します。

その位置は、テーブルセクション内の行に対応します。index が -1 なら、これは引数が省略された場合のデフォルトとなりますが、テーブルセクションの最後に挿入することと同じです。

指定された位置が -1 より小さいか、もしくは、行数より大きければ、IndexSizeError 例外を投げます。

tbody . deleteRow(index)

テーブルセレクションの引数に指定された位置にある tr 要素を削除します。

その位置は、テーブルセクションの中にある行に対応します。index が -1 なら、テーブルセクションの最後の行を削除することに相当します。

指定された位置が -1 より小さい、または、最後の行の index より大きい、または、行が一つもなければ、IndexSizeError 例外を投げます。

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

insertRow(index) メソッドは、要素 table section で呼び出れたとき、次の通りに動作しなければいけません:

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

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

そうでなければ、このメソッドは、tr 要素を生成し、table section 要素の子としてそれを挿入しなければいけません。挿入場所は、rows コレクションの tr 要素のうち、index に位置する tr 要素の直前です。最後に、新たに生成された tr 属性を返さなければいけません。

deleteRow(index) メソッドは、その親から、rows コレクションの要素のうち、index に位置する要素を削除しなければいけません。もし index が 0 より小さい、もしくは、rows コレクションの要素数に等しいか、それより大きければ、このメソッドは IndexSizeError 例外を投げなければいけません。


※ 原文:http://www.w3.org/TR/2014/REC-html5-20141028/tabular-data.html#the-tbody-element