ARIA: aria-rowindex 属性
aria-rowindex 属性は、表、グリッド、またはツリーグリッドの行の合計数に対する要素の位置を定義します。
解説
行数が非常に多い表もあります。設計上の要件、パフォーマンスの向上、またはユーザー体験の向上のために、行の一部だけを読み込む場合があります。
行の一部だけを読み込む場合は、どの行が表示されているかをすべてのユーザーに知らせる必要があります。aria-rowindex 属性は、表、グリッド、またはツリーグリッドの行の合計数に対するセルまたは行のインデックス、つまり位置を定義するために使用します。
<tr> 要素、または row ロールを持つ要素に指定します。また、<td>、<th>、または cell か gridcell ロールを持つ要素に直接指定することもできます。値は、表全体におけるその行の位置です。
aria-rowindex の値は 1 以上の整数で、前にある行の aria-rowindex の値より大きく、表全体の行数以下でなければなりません。
すべての行が読み込まれ、DOM に存在する場合は、ブラウザーが各行のインデックスを自動的に計算するため、aria-rowindex を含める必要はありません。ただし、DOM に行の一部だけが存在する場合は、表全体における各行の位置を示すために aria-rowindex が必要です。行の一部だけを読み込む場合は、合計行数が分からなくても、祖先の表に aria-rowcount も含める必要があります。
行の一部だけを含む表に複数行にまたがるセルがある場合、行とセルの両方に aria-rowindex を設定する必要があります。セルが複数行にまたがる場合、つまり、セルロールに aria-rowspan 属性が含まれるか、HTML のセルで rowspan 属性に 1 より大きい値が設定されている場合は、適切な行またがり属性に加えて、またがるセルにも行の aria-rowindex の値を含めてください。この値は、またがりが始まる行のインデックスにしてください。
メモ:
aria-rowindex は各行に追加する必要がありますが、セルへの指定は任意です。ただし、複数行にまたがるセルでは例外で、すべての該当セルに aria-rowindex 属性が必要です。
値
<integer>-
1以上の整数で、前の行がある場合はそのaria-rowindexより大きく、aria-rowcountの値以下。
関連するインターフェイス
Element.ariaRowIndex-
Elementインターフェイスの一部であるariaRowIndexプロパティは、aria-rowindex属性の値を反映します。 ElementInternals.ariaRowIndex-
ElementInternalsインターフェイスの一部であるariaRowIndexプロパティは、aria-rowindex属性の値を反映します。
関連するロール
次のロールで使用されます。
次のロールに継承されます。
例
次の例は 24 行あるグリッドで、1 行目と 7 行目から 10 行目までをユーザーに表示しています。最後の "Position" セルは 9 行目から 10 行目までにまたがっています。
<div role="grid" aria-rowcount="24">
<div role="rowgroup">
<div role="row" aria-rowindex="1">
<span role="columnheader">First Name</span>
<span role="columnheader">Last Name</span>
<span role="columnheader">Position</span>
</div>
</div>
<div role="rowgroup">
<div role="row" aria-rowindex="7">
<span role="gridcell">Morgan</span>
<span role="gridcell">Brian</span>
<span role="gridcell">Midfielder</span>
</div>
<div role="row" aria-rowindex="8">
<span role="gridcell">Abby</span>
<span role="gridcell">Dahlkemper</span>
<span role="gridcell">Defender</span>
</div>
<div role="row" aria-rowindex="9">
<span role="gridcell">Ashlyn</span>
<span role="gridcell">Harris</span>
<span role="gridcell" aria-rowspan="2" aria-rowindex="9">Goalkeeper</span>
</div>
<div role="row" aria-rowindex="10">
<span role="gridcell">Alyssa</span>
<span role="gridcell">Naeher</span>
</div>
</div>
</div>
2 行にまたがる "Goalkeeper" セルには、aria-rowspan と aria-rowindex の両方があることに注目してください。
仕様書
| 仕様書 |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # aria-rowindex> |