解説
ネイティブ HTML の <table> に含まれていない cell および gridcell を対象としており、aria-colspan 属性の値は、table や grid、 treegrid 内の個々のセルがまたがる列の数を定義します。
HTML では、<th> 要素と <td> 要素が colspan 属性を持っています。意味づけされた <table> を使用する場合は、設計どおりにネイティブ属性である colspan 属性を使用してください。この ARIA 属性は、ネイティブの表に含まれていないセルとグリッドセルを対象としており、<table> 内のセルで使用された場合は無視されます。
メモ:
ARIA を使用する際の第一のルールは、必要な意味や動作がすでに組み込まれているネイティブ機能を使用できる場合は、要素を再利用して ARIA のロール、状態、プロパティを追加してアクセシブルにするのではなく、その機能を使うことです。可能な場合は、意味づけのない要素に ARIA のロールや属性を指定する代わりに、colspan 属性を持つ <th> や <td> を含む HTML の <table> 要素を使用してください。
aria-colspan の値は正の整数である必要があります。セルがまたがる列数のデフォルト値または想定値は 1 です。指定する値によって、セルまたはグリッドセルが同じ行の次のセルまたはグリッドセルと重ならないようにし、包含する表、グリッド、またはツリーグリッドの外側にセルが広がることがないようにしてください。
値
<integer>-
セルがまたがる列数を定義する、デフォルト値の 1 以上の整数です。この値は、セルが同じ行の次のセルと重ならない範囲にしてください。
関連インターフェイス
Element.ariaColSpan-
各要素のインターフェイスの一部である
ariaColSpanプロパティは、表、グリッド、またはツリーグリッド内のセルまたはグリッドセルがまたがる列数を定義するaria-colspan属性の値を反映します。
関連付けられたロール
次のロールで使用されます。
次のロールに継承されます。
例
以下は、ボウリングトーナメントリーグのスコアスプレッドシートの一部の例です。各ゲームは 10 フレームにまたがり、各フレームには 3 つのスコア (2 つのボールと現在の合計) が含まれます。各ゲームの 10 番目 (最後の) フレームは、誰かが全てストライクを取る場合に備えて 4 つの列にまたがります。
<div role="grid" aria-rowcount="27" aria-label="ボウリングリーグのスコア">
<div role="rowgroup">
<div role="row" aria-rowindex="1">
<!--
aria-rowspan と aria-colspan は、ヘッダーセルが複数の行や列にまたがるとき、正しいデータセルのヘッダー情報を支援技術に提供します。
-->
<span role="columnheader" aria-rowspan="2">チーム</span>
<span role="columnheader" aria-colspan="2">選手</span>
<span role="columnheader" aria-colspan="31">第 1 ゲームのフレーム</span>
<span role="columnheader" aria-colspan="31">第 2 ゲームのフレーム</span>
<span role="columnheader" aria-colspan="31">第 3 ゲームのフレーム</span>
<span role="columnheader" aria-rowspan="2">合計</span>
</div>
<div role="row" aria-rowindex="2">
<span role="columnheader">姓</span>
<span role="columnheader">名</span>
<span role="columnheader" aria-colspan="3">1</span>
<span role="columnheader" aria-colspan="3">2</span>
<span role="columnheader" aria-colspan="3">3</span>
<span role="columnheader" aria-colspan="3">4</span>
<span role="columnheader" aria-colspan="3">5</span>
<span role="columnheader" aria-colspan="3">6</span>
<span role="columnheader" aria-colspan="3">7</span>
<span role="columnheader" aria-colspan="3">8</span>
<span role="columnheader" aria-colspan="3">9</span>
<span role="columnheader" aria-colspan="4">10</span>
<span role="columnheader" aria-colspan="3">1</span>
<span role="columnheader" aria-colspan="3">2</span>
<span role="columnheader" aria-colspan="3">3</span>
<span role="columnheader" aria-colspan="3">4</span>
<span role="columnheader" aria-colspan="3">5</span>
<span role="columnheader" aria-colspan="3">6</span>
<span role="columnheader" aria-colspan="3">7</span>
<span role="columnheader" aria-colspan="3">8</span>
<span role="columnheader" aria-colspan="3">9</span>
<span role="columnheader" aria-colspan="4">10</span>
<span role="columnheader" aria-colspan="3">1</span>
<span role="columnheader" aria-colspan="3">2</span>
<span role="columnheader" aria-colspan="3">3</span>
<span role="columnheader" aria-colspan="3">4</span>
<span role="columnheader" aria-colspan="3">5</span>
<span role="columnheader" aria-colspan="3">6</span>
<span role="columnheader" aria-colspan="3">7</span>
<span role="columnheader" aria-colspan="3">8</span>
<span role="columnheader" aria-colspan="3">9</span>
<span role="columnheader" aria-colspan="4">10</span>
</div>
</div>
<div role="rowgroup">
<div role="row" aria-rowindex="10">
<span role="rowheader" aria-rowspan="3">The Mighty Quokkas</span>
<span role="cell">Henderson</span>
<span role="cell">Alice</span>
<span role="cell">7</span>
<span role="cell">/</span>
<span role="cell">20</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">39</span>
<span role="cell">9</span>
<span role="cell">-</span>
<span role="cell">48</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">76</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">96</span>
<span role="cell">8</span>
<span role="cell">/</span>
<span role="cell">113</span>
<span role="cell">7</span>
<span role="cell">-</span>
<span role="cell">120</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">146</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">166</span>
<span role="cell">6</span>
<span role="cell">/</span>
<span role="cell">X</span>
<span role="cell">186</span>
<span role="cell">7</span>
<span role="cell">2</span>
<span role="cell">9</span>
<span role="cell">6</span>
<span role="cell">-</span>
<span role="cell">15</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">35</span>
<span role="cell">7</span>
<span role="cell">/</span>
…
</div>
<div role="row" aria-rowindex="11">
<span role="cell">McPherson</span>
<span role="cell">Leslie</span>
<span role="cell">9</span>
<span role="cell">-</span>
<span role="cell">9</span>
<span role="cell">8</span>
<span role="cell">1</span>
<span role="cell">18</span>
…
</div>
</div>
</div>
もし <table> と意味づけされた表要素を使用していた場合、マークアップはより簡潔になり、デフォルトでアクセシブルになっていたでしょう。
仕様書
| 仕様書 |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # aria-colspan> |
関連情報
<th>と<td>のcolspan属性aria-colindex属性aria-rowspan属性cellロールcolumnheaderロールrowheaderロール