<tbody>要素

Technical Summary

定義・配置・content model

tbody要素の基本定義

項目	仕様上の定義	条件・範囲
意味	表本体の行グループ	見出しやfooterとは異なるbody部分の行をまとめる
配置先	tableの子	caption、colgroup、thead、表本体、tfootなど、親要素のcontent modelと順序に従う
content model	0個以上のtrとscript-supporting elements	空のtbodyもcontent model上は許される
開始タグ・終了タグ	HTML構文では条件付きで省略できる	開始タグは、最初の内容がtrで、直前に終了タグを省略したtbody・thead・tfootがない場合に省略できる。終了タグは、次がtbodyまたはtfootの場合、または親要素に続く内容がない場合に省略できる
DOM interface	HTMLTableSectionElement	theadとtfootも同じinterfaceを使う
固有属性	定義なし	global attributesを利用できる

表本体は、0個以上のtbodyで表す方法か、1個以上のtrで表す方法がcontent modelにあります。一方、HTML parserでtable直下にtr tokenが現れると、DOMにはtbodyが補われます。HTMLソースの適合性と、parserがDOMを構築・回復する手順は別の規則です。

行グループとtable model

row groupはtable grid上で行をまとめる単位です。1つのcellは複数のrow groupにまたがることができません。そのためrowspan="0"は、cellが属するrow groupの残りの行に広がり、次のtbodyへは続きません。

表の主な行グループ

要素	一般的な役割	table model上の区分
thead	列の見出しを含む部分	row group
tbody	表本体の行を含む部分	row group。複数置ける
tfoot	合計などのfooter行を含む部分	row group

CSSの表示順や見た目だけからDOMの行グループを推定せず、実際の親要素とtable modelを確認します。row groupの区別は、th scope="rowgroup"の適用範囲や支援技術への構造公開にも関わります。

parserが作るDOM

<table id="items">
  <tr><td>りんご</td></tr>
</table>

// HTML parserが構築するDOM
table#items
└─ tbody  (暗黙に挿入)
   └─ tr
      └─ td

table insertion modeでtrが直接現れた場合、parserは属性のないtbody要素を挿入してからtokenを再処理します。また、table body insertion modeでtdまたはthが直接現れる不正なmarkupでは、parse errorとして属性のないtrを挿入し、そのcell tokenを再処理します。これらはparser recoveryの挙動であり、作成するHTMLで依存すべき記法ではありません。

HTMLTableSectionElement API

tbodyとtableから使う主なrow API

member	戻り値・動作	範囲・境界
tbody.rows	section直下のtrを含むHTMLCollection	行の挿入や削除を反映するlive collection
table.tBodies	tableの子であるtbodyを含むHTMLCollection	thead・tfootや入れ子table内のtbodyは含めない
tbody.insertRow(index)	新しいtrを作ってsectionに挿入する	-1は末尾。範囲外indexはIndexSizeError
tbody.deleteRow(index)	sectionから指定したtrを削除する	-1は最後の行。行がない場合などの境界はindex規則に従う

const table = document.querySelector("table");
const body = table.tBodies[0];
body.rows.length;       // このtbody内の行数
body.insertRow(-1);     // このtbodyの末尾に行を追加
body.deleteRow(-1);     // このtbodyの最後の行を削除

tbody.rowsはそのsectionの行を返します。table.rowsはtable全体の行collectionです。どちらも似た名前ですが、対象にする範囲が異なります。

Accessibility mapping

HTML-AAMはnative tbodyにWAI-ARIAのrowgroup roleを対応付けます。これはtable内の行をまとめる構造であり、表示される見出し文字列ではありません。実際のbrowser Accessibility treeやplatform APIに現れる結果は、OS・browser・table構造などの条件を記録して観測します。

Fact / Evidence（主張 / 根拠）

仕様上の主張と実装の測定結果を別々に記録します。browserのrole queryはHTML-AAMの規範的mappingやplatform Accessibility APIそのものではありません。

Evidence

1. HTML Standard: The tbody element — context, content model, tag omission, and section API
2. HTML Standard: Forming a table — row groups, cell slots, and row-span boundaries
3. HTML Standard: Table parsing modes — implied section and row insertion
4. HTML Accessibility API Mappings: tbody — rowgroup role and platform mappings
5. Web Platform Tests: the-tbody-element — section row collection and row methods
6. Web Platform Tests: rowspan-0.html — row-span behavior at a row-group boundary

Implementation Evidence

仕様上の要求と、選定環境でのbrowser観測、WPT実行、Accessibility role queryを分けて記録します。各結果は記載したfixture・browser・テスト範囲に限られます。

browserのrole・name queryはplatform Accessibility APIやスクリーンリーダーの発話と同じ測定ではありません。実施した層と未測定の範囲を分けて扱います。

Coverage / Open Issues

• 仕様確認済みcontent model、table内の順序、行グループ、table parser、HTMLTableSectionElement、HTML-AAM mapping
• 未完了実装観測は選定fixtureとbrowser 1環境に限る。HTML parserの全recovery経路と複数table構造は未網羅
• 未完了WPTは選定ファイルに限る。wpt.liveが配信した正確なupstream revisionと他browserの結果は未確認
• 未完了platform Accessibility API、Windows UI Automation、支援技術の読み上げ、他OS、Expert-gap Review

このTopicは初期Coverageです。選定した測定の成功は、すべてのHTML構造、browser、OS、支援技術で同じ結果になることを示しません。

関連Surface

初心者向けの例はYugienのtbody要素ページを参照してください。表全体のmodelはtable Topic、header row groupはthead Topic、summary row groupはtfoot Topic、行と行番号はtr Topic、row group headerとcell associationはth Topicとtd Topicで扱います。