<col>要素

Technical Summary

定義・配置・HTMLの条件

colは、親がtableのcolgroupであるとき、そのグループ内の1列以上を表します。colgroupにspan属性がある場合、その子にcolを置く形は適合しません。

spanと列数

spanを省略したcolは1列を表します。適合するHTMLで指定できる値は1〜1000の整数です。colgroupに子のcolがあるとき、列数は子のcolのspanを合計して表します。

<colgroup>
  <col>              <!-- 1列 -->
  <col span="2">     <!-- 2列 -->
</colgroup>

HTMLの適合条件と、DOM propertyに値を設定したときの動きは別の規則です。HTMLTableColElement.spanは既定値1のunsigned longで、scriptからの設定は1〜1000の範囲に丸められます。table modelの列形成では、不正な値や0は1として扱い、1000を超える値は1000に制限します。

colgroup spanだけでグループの列数を表す方法と、子のcol spanを合計する方法は、同じグループでは併用しません。

Table Model・parser・DOM API

table modelは、行、列、cellを格子状のslotとして組み立てます。colとspanは列とcolumn groupを形成する処理に参加しますが、cellはDOM上でtrの子です。cellがcolの子になるわけではありません。

適合するHTMLではcolをcolgroup内に置きます。parserはtable直下に現れたcolのために暗黙のcolgroupを作ることがありますが、これは入力HTMLが適合することを意味しません。

const column = document.querySelector("col");

column instanceof HTMLTableColElement; // true
column.span;                           // 省略時は1
column.span = 0;
column.span;                           // 1

// table cellはtrの子。colの子ではない。

colとcolgroupは同じHTMLTableColElement interfaceを使います。HTML Standardはtable.columnsのような列collection propertyを定義していません。

CSS列ボックス

CSS table modelでは列に対応するboxがありますが、そのboxはDOM上でcellを包みません。CSS 2.1では列と列グループに適用するpropertyを限定し、条件に応じてcellの描画やtable幅へ影響させます。

そのため、colorやpaddingなど通常の要素に使えるpropertyをcolへ指定しても、cell内の文字や余白に同じ効果が出るとは限りません。WPTのCSS列幅testにも未解決の差が記録されているため、測定値を全browserの保証として扱いません。

見出し関係とAccessibility mapping

colは列見出しの文字やaccessible nameを提供しません。人が見て読める見出しはthに書き、複雑な表では表の構造に合うscopeやheadersでheader associationを示します。列を色で区別する場合も、その色だけに情報を任せないようにします。

HTML-AAM Editor's Draftでは、colのcomputed roleと掲載されたplatform accessibility API mappingは「Not mapped」です。これは仕様上のmappingです。実際のbrowser accessibility tree、OS API、screen readerの読み上げは別々に観測する必要があります。

Fact / Evidence（主張 / 根拠）

主要な仕様上の主張と参照箇所を対応付けています。実装観測は下の表に分け、未測定範囲はCoverageに残します。

Evidence

1. HTML Standard: The col element — context, empty content model, end-tag omission, span, and interface
2. HTML Standard: Forming a table — columns, groups, slots, and cell spans
3. HTML Standard: The “in table” insertion mode — parser handling of table children
4. CSS 2.1: Columns — applicable properties and column effects
5. HTML-AAM: col — computed role and platform mappings
6. Web Platform Tests: col-span-limits.html — span limits, reflection, and table layout
7. Web Platform Tests: colgroup-col.html — tentative CSS column and column-group width checks

Implementation Evidence

ブラウザーのDOM・CSS観測、選定WPT、Accessibility tree queryを別々に記録します。各結果は実施した環境とtest範囲に限られます。

Coverage / Open Issues

• SPEC要素の意味、配置、content model、span、table model、CSS 2.1、HTML-AAM mapping
• IMPLChrome 1環境のfixture観測。他browser、OS build、印刷、複雑なrowspan/colspan gridは未測定
• WPT選定testのみ。wpt.liveが配信したrevision、test directory全体、他browserは未確認
• AAMChrome browser accessibility tree queryのみ。Windows UIA、IAccessible2、ATK、Apple AX、screen reader発話は未測定
• ReviewExpert-gap Reviewは未完了

このTopicは初期Coverageです。選定fixtureやWPTの結果を、すべてのHTML構造、browser、OS、CSS実装、支援技術へ一般化しません。

関連Surface

初心者向けの例はYugienのcol要素ページを参照してください。列グループはcolgroup Topic、表全体はtable Topic、列見出しとheader associationはth Topicで扱います。