aria-rowindex

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

Beschreibung

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

Wenn nur ein Teil der Zeilen geladen wird, müssen alle Benutzer wissen, welche Teilmengen von Zeilen angezeigt werden. Das aria-rowindex-Attribut wird verwendet, um den Zeilenindex oder die Position der Zelle oder Zeile in Bezug auf die Gesamtzahl der Zeilen in einer Tabelle, einem Raster oder Baumraster zu definieren.

Eingebunden in das <tr>-Element oder in ein Element mit der Rolle row, oder direkt in das <td>, <th> oder ein Element mit der Rolle cell oder gridcell, ist der Wert die Position der Zeile in Bezug auf die gesamte 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 vorhergehenden Zeilen, und kleiner oder gleich der Anzahl der Zeilen in der gesamten Tabelle.

Wenn alle Zeilen geladen und im DOM sind, müssen Sie aria-rowindex nicht einbeziehen, da Browser automatisch den Index jeder Zeile berechnen. Wenn jedoch nur ein Teil der Zeilen im DOM vorhanden ist, wird aria-rowindex benötigt, um die Position jeder Zeile in Bezug auf die gesamte Tabelle anzuzeigen. Wenn nur ein Teil der Zeilen geladen ist, müssen Sie auch aria-rowcount beim Tabellen-Vorfahren einfügen, selbst wenn Sie die Gesamtanzahl der Zeilen nicht kennen.

Wenn die Tabelle mit nur einem Teil der Zeilen eine Zelle hat, 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 umfasst oder die HTML-Zelle ein rowspan-Attribut mit einem Wert größer als 1 hat－muss der aria-rowindex-Wert der Zeile in der übergreifenden Zelle zusätzlich zum entsprechenden Zeilenspan-Attribut enthalten sein. Der Wert sollte der Zeilenindex der Zeile sein, bei der der Span beginnt.

Hinweis: Der aria-rowindex muss zu jeder Zeile hinzugefügt werden, ist aber optional für die Zellen, außer für Zellen, die sich über Zeilen erstrecken: das aria-rowindex-Attribut ist für alle übergreifenden 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 in der Torhüter-Zelle 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