このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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 行目までにまたがっています。

html
<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

関連情報