aria-rowindex

Das aria-rowindex Attribut definiert die Position eines Elements in Bezug auf die Gesamtanzahl der Zeilen innerhalb einer Tabelle, eines Rasters oder eines Baumrasters.

Beschreibung

Einige Tabellen haben viele, viele Zeilen. Das Laden nur eines Teilabschnitts der Zeilen kann als Designanforderung erfolgen, um die Leistung zu verbessern oder die Benutzererfahrung zu steigern.

Wenn nur ein Teil der Zeilen geladen wird, müssen Sie allen Benutzern mitteilen, welche Teilmengen der Zeilen angezeigt werden. Das aria-rowindex Attribut wird verwendet, um den Zeilenindex oder die Position der Zelle oder Zeile in Bezug auf die Gesamtanzahl der Zeilen innerhalb einer Tabelle, eines Rasters oder eines Baumrasters zu definieren.

Das Attribut kann auf dem <tr> Element oder auf einem Element mit der Rolle row eingefügt sowie direkt auf dem <td>, <th> oder einem Element mit der Rolle cell oder gridcell angewendet werden. Der Wert ist die Position der Zeile in Bezug auf die vollständige Tabelle.

Der Wert für aria-rowindex ist eine ganze Zahl, die größer oder gleich 1 ist, größer als der aria-rowindex Wert aller vorherigen Zeilen und kleiner oder gleich der Anzahl der Zeilen in der vollständigen Tabelle.

Wenn alle Zeilen geladen und im DOM sind, müssen Sie aria-rowindex nicht einfügen, da Browser den Index jeder Zeile automatisch berechnen. Wenn jedoch nur ein Teil der Zeilen im DOM vorhanden ist, muss aria-rowindex hinzugefügt werden, um die Position jeder Zeile in Bezug auf die gesamte Tabelle anzugeben. Wenn nur ein Teil der Zeilen geladen wird, müssen Sie außerdem aria-rowcount auf dem übergeordneten Tabellenelement einfügen, auch wenn Sie die Gesamtanzahl der Zeilen nicht kennen.

Wenn die Tabelle mit nur einem Teil der Zeilen eine Zelle enthält, die sich über mehr als eine Zeile erstreckt, müssen sowohl die Zeile als auch die Zelle das aria-rowindex gesetzt haben. Wenn eine Zelle sich über mehr als eine Zeile erstreckt - wenn eine Zellenrolle das aria-rowspan Attribut enthält oder eine HTML-Zelle ein rowspan Attribut mit einem Wert größer als 1 hat - fügen Sie zusätzlich zum entsprechenden Zeilenumspannungsattribut den aria-rowindex Wert der Zeile auf der überspannenden Zelle ein. Der Wert sollte der Zeilenindex der Zeile sein, in der die Umspannung beginnt.

Hinweis: Das aria-rowindex muss zu jeder Zeile hinzugefügt werden, ist aber auf den Zellen optional, außer bei Zellen, die sich über Zeilen erstrecken: Das aria-rowindex Attribut ist auf allen überspannenden Zellen erforderlich.

Beispiele

Das folgende Beispiel zeigt ein Raster mit 24 Zeilen, von denen die erste Zeile und die Zeilen 7 bis 10 dem Benutzer angezeigt werden. Die letzte "position"-Zelle erstreckt sich über Spalte 9 und 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>

Beachten Sie, dass sowohl aria-rowspan als auch aria-rowindex auf der Torwartzelle vorhanden sind, die sich über zwei Zeilen erstreckt.

Werte

<integer>

Eine ganze Zahl, die größer oder gleich 1 ist, größer als der aria-rowindex der vorherigen Zeile, falls vorhanden, und kleiner oder gleich dem Wert von aria-rowcount.

Zugehörige Schnittstellen

Element.ariaRowIndex

Die ariaRowIndex Eigenschaft, Teil der Element Schnittstelle, spiegelt den Wert des aria-rowindex Attributs wider.

ElementInternals.ariaRowIndex

Die ariaRowIndex Eigenschaft, Teil der ElementInternals Schnittstelle, spiegelt den Wert des aria-rowindex Attributs wider.

Zugehörige Rollen

Verwendet in Rollen:

Geerbt in Rollen:

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# aria-rowindex

Siehe auch