Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

ARIA: rowgroup-Rolle

Ein Element mit role="rowgroup" ist eine Gruppe von Zeilen innerhalb einer tabellarischen Struktur. Eine rowgroup enthält eine oder mehrere Zeilen mit Zellen, Grid-Zellen, Spaltenüberschriften oder Zeilenüberschriften innerhalb eines grid, einer table oder eines treegrid.

html
<div
  role="table"
  aria-label="Populations"
  aria-describedby="country_population_desc">
  <div id="country_population_desc">World Populations by Country</div>
  <div role="rowgroup">
    <div role="row">
      <span role="columnheader" aria-sort="descending">Country</span>
      <span role="columnheader" aria-sort="none">Population</span>
    </div>
  </div>
  <div role="rowgroup">
    <div role="row">
      <span role="cell">Finland</span>
      <span role="cell">5.5 million</span>
    </div>
    <div role="row">
      <span role="cell">France</span>
      <span role="cell">67 million</span>
    </div>
  </div>
</div>

Beschreibung

Rowgroup stellt eine Beziehung zwischen den zugehörigen Zeilenelementen her und ist das strukturelle Gegenstück zu den HTML-Elementen <thead>, <tfoot> und <tbody>. Zwischen verschiedenen Arten von Zeilengruppen wird jedoch nicht unterschieden. Ihre Elemente müssen in Elementen mit der Rolle table oder grid enthalten sein oder diesen zugeordnet sein. Es wird dringend empfohlen, nach Möglichkeit die nativen HTML-Elemente <thead>, <tfoot> und <tbody> zu verwenden.

Um einen ARIA-Tabellenkopf, -Tabellenfuß oder -Tabellenkörper zu erstellen, fügen Sie dem Element role="rowgroup" hinzu. Diese Zeilengruppe sollte innerhalb eines Grid, einer Tabelle oder eines Treegrid verschachtelt sein und eine oder mehrere Zeilen umfassen. Jede Zeile enthält wiederum untergeordnete Zellen. Je nachdem, ob es sich um Spalten- oder Zeilenüberschriften oder um einfache Zellen oder Grid-Zellen handelt, können diese Zellen unterschiedlichen Typs sein.

Hinweis: Es wird dringend empfohlen, nach Möglichkeit das native HTML-Tabellenelement (<table>) zusammen mit den Elementen für Tabellenkopf (<thead>), Tabellenfuß (<tfoot>) und Tabellenkörper (<tbody>) zu verwenden.

Zugehörige WAI-ARIA-Rollen, -Zustände und -Eigenschaften

Kontextrollen

role="table"

Einer der drei möglichen Kontexte (neben grid und treegrid), in denen eine Zeile vorkommt. Diese Rolle kennzeichnet die Zeile als Teil einer nicht interaktiven Tabellenstruktur, deren Daten in Zeilen und Spalten angeordnet sind, ähnlich dem nativen HTML-Element <table>.

role="grid"

Einer der drei möglichen Kontexte (neben table und treegrid), in denen eine Zeile vorkommt. Diese Rolle kennzeichnet die Zeile als Teil einer nicht interaktiven Tabellenstruktur, deren Daten in Zeilen und Spalten angeordnet sind, ähnlich dem nativen HTML-Element <table>.

role="treegrid"

Ähnlich wie ein Grid, jedoch mit Zeilen, die sich wie in einer Baumstruktur auf- und zuklappen lassen.

Untergeordnete Rollen

role="row"

Eine Zeile mit Zellen innerhalb einer tabellarischen Struktur. Eine Zeile enthält eine oder mehrere Zellen, Grid-Zellen oder Spaltenüberschriften und manchmal eine Zeilenüberschrift.

Tastaturinteraktionen

Keine.

Erforderliche JavaScript-Funktionen

Keine.

Hinweis: Die erste Regel für die Verwendung von ARIA lautet: Wenn Sie eine native Funktion verwenden können, die die benötigte Semantik und das benötigte Verhalten bereits mitbringt, statt ein Element zweckzuentfremden und ihm eine ARIA-Rolle, einen ARIA-Zustand oder eine ARIA-Eigenschaft hinzuzufügen, um es zugänglich zu machen, dann tun Sie das. Verwenden Sie nach Möglichkeit das HTML-Element <table> anstelle der ARIA-Rolle table.

Bewährte Vorgehensweisen

Verwenden Sie für die Struktur von Datentabellen ausschließlich <table>, <tbody>, <thead>, <tr>, <th>, <td> und ähnliche Elemente. Wenn die native Semantik der Tabelle beispielsweise durch CSS entfernt wird, können Sie diese ARIA-Rollen hinzufügen, um die Barrierefreiheit sicherzustellen. Ein relevanter Anwendungsfall für die ARIA-Rolle table liegt vor, wenn die CSS-Eigenschaft display die native Semantik einer Tabelle überschreibt, etwa durch display: grid. In diesem Fall können Sie die Tabellensemantik mithilfe der ARIA-Tabellenrollen wiederherstellen.

html
<table
  role="table"
  aria-label="Semantic Elements"
  aria-describedby="semantic_elements_table_desc"
  aria-rowcount="81">
  <caption id="semantic_elements_table_desc">
    Semantic Elements to use instead of ARIA's roles
  </caption>
  <thead role="rowgroup">
    <tr role="row">
      <th role="columnheader" aria-sort="none">ARIA Role</th>
      <th role="columnheader" aria-sort="none">Semantic Element</th>
    </tr>
  </thead>
  <tbody role="rowgroup">
    <tr role="row" aria-rowindex="11">
      <td role="cell">header</td>
      <td role="cell">h1</td>
    </tr>
    <tr role="row" aria-rowindex="16">
      <td role="cell">header</td>
      <td role="cell">h6</td>
    </tr>
  </tbody>
</table>

Oben sehen Sie die semantische Schreibweise einer Tabelle. Die ARIA-Rollen sind nur erforderlich, wenn die native Semantik der Tabelle und damit auch der Tabellenzeilen verloren geht, beispielsweise durch Festlegen der display-Eigenschaft auf flex oder grid.

Zusätzliche Vorteile

Keine.

Beispiele

html
<div
  role="table"
  aria-label="Semantic Elements"
  aria-describedby="semantic_elements_table_desc"
  aria-rowcount="81">
  <div id="semantic_elements_table_desc">
    Semantic Elements to use instead of ARIA's roles
  </div>
  <div role="rowgroup">
    <div role="row">
      <span role="columnheader" aria-sort="none">ARIA Role</span>
      <span role="columnheader" aria-sort="none">Semantic Element</span>
    </div>
  </div>
  <div role="rowgroup">
    <div role="row" aria-rowindex="11">
      <span role="cell">header</span>
      <span role="cell">h1</span>
    </div>
    <div role="row" aria-rowindex="16">
      <span role="cell">header</span>
      <span role="cell">h6</span>
    </div>
    <div role="row" aria-rowindex="18">
      <span role="cell">rowgroup</span>
      <span role="cell">thead</span>
    </div>
    <div role="row" aria-rowindex="24">
      <span role="cell">term</span>
      <span role="cell">dt</span>
    </div>
  </div>
</div>

Oben sehen Sie eine nicht semantische ARIA-Tabelle mit Tabellenkopf und Tabellenkörper. Von insgesamt 81 Zeilen sind fünf im DOM vorhanden: eine im Tabellenkopf und vier im Tabellenkörper. Die Kopfzeile bildet allein eine Zeilengruppe und enthält zwei Spaltenüberschriften. Die Spalten sind sortierbar, derzeit aber nicht sortiert, wie die Eigenschaft aria-sort angibt. Der Tabellenkörper ist eine separate Zeilengruppe mit derzeit vier Zeilen im DOM. Da nicht alle Zeilen im DOM vorhanden sind, wurde jeder Zeile die Eigenschaft aria-rowindex hinzugefügt.

Spezifikationen

Spezifikation
Accessible Rich Internet Applications (WAI-ARIA)
# rowgroup

Siehe auch