ARIA: cell-Rolle
Der Wert cell des ARIA-Attributs role kennzeichnet ein Element als Zelle in einer tabellarischen Struktur, die keine Informationen zu Spalten- oder Zeilenüberschriften enthält. Damit die Zelle unterstützt wird, muss sie in einem Element mit der Rolle row verschachtelt sein.
<div role="row">
<span role="cell">France</span>
<span role="cell">67 million</span>
</div>
Eine bessere, semantisch aussagekräftigere Möglichkeit, die obigen Zellen zu schreiben, ist die Verwendung des semantischen Elements <td>.
<tr role="row">
<td role="cell">France</td>
<td role="cell">67 million</td>
</tr>
Beschreibung
Ein Element mit role="cell" ist eine Zelle innerhalb einer Zeile, optional innerhalb einer rowgroup, in einer table. Befindet sich die Zelle in einem grid oder treegrid, verwenden Sie stattdessen gridcell. Die Verwendung nativer HTML-Elemente <td> wird nachdrücklich empfohlen, wann immer sie möglich ist.
Jedes Element mit role="cell" MUSS in einem Containerelement mit role="row" verschachtelt sein. Diese Zeile kann wiederum in einem Element mit role="rowgroup" verschachtelt sein und sollte sich innerhalb eines grid, einer table oder eines treegrid befinden. Enthält eine Zelle Informationen zu einer Spalten- oder Zeilenüberschrift, verwenden Sie entsprechend die Rollen columnheader oder rowheader. Enthält die Zelle keine Überschrifteninformationen und ist sie in einem grid oder treegrid verschachtelt, ist die Rolle gridcell möglicherweise besser geeignet.
Eine Zelle kann mehrere Eigenschaftenattribute enthalten, die ihre Position innerhalb der tabellarischen Datenstruktur verdeutlichen. Dazu gehören aria-colindex, aria-colspan, aria-rowindex und aria-rowspan.
Zugehörige WAI-ARIA-Rollen, -Zustände und -Eigenschaften
Kontextrollen
- role="row"
-
Ein Element mit
role="row"ist eine Zeile aus Zellen innerhalb einer tabellarischen Struktur. Eine Zeile enthält eine oder mehrere Zellen, Rasterzellen, Spaltenüberschriften oder Zeilenüberschriften innerhalb einesgrid, einertableoder einestreegridund optional innerhalb einerrowgroup. - role="rowgroup"
-
Rowist als übergeordnetes Element einer Zelle erforderlich.Rowgroupist ein optionales übergeordnetes Kontextelement einer Zeile. Es stellt eine Beziehung zwischen untergeordneten Zeilen her. Es entspricht strukturell den Elemententhead,tfootundtbodyin einem HTML-Elementtable. - role="table"
-
Einer der drei möglichen Kontexte (neben
gridundtreegrid), in denen sich eine Zeile mit Zellen befinden kann. Die Rolletablekennzeichnet die Zelle als Teil einer nicht interaktiven Tabellenstruktur mit Daten, die in Zeilen und Spalten angeordnet sind, ähnlich dem nativen HTML-Element<table>. - role="grid"
-
Einer der drei möglichen Kontexte (neben
tableundtreegrid), in denen sich eine Zeile mitcellsundgridcellsbefinden kann. Die Rollegridkennzeichnet eine Zelle als Teil einer möglicherweise interaktiven Tabellenstruktur mit Daten, die in Zeilen und Spalten angeordnet sind, ähnlich dem nativen HTML-Element<table>. - role="treegrid"
-
Ähnlich einem Raster, jedoch mit Zeilen, die wie bei einer Baumstruktur ein- und ausgeklappt werden können.
Untergeordnete Rollen
- role="gridcell"
-
Eine Zelle in einer Zeile innerhalb eines
gridodertreegrid. - role="columnheader"
-
Eine Überschriftenzelle, die strukturell einem HTML-Element
<th>mit Geltungsbereich für eine Spalte entspricht. Anders als eine gewöhnliche Zelle stellt die Rollecolumnheadereine Beziehung zwischen der Überschriftenzelle und allen Zellen der entsprechenden Spalte her. - role="rowheader"
-
Eine Überschriftenzelle, die strukturell einem HTML-Element
<th>mit Geltungsbereich für eine Zeile entspricht. Anders als eine gewöhnliche Zelle stellt die Rollerowheadereine Beziehung zwischen der Überschriftenzelle und allen Zellen der entsprechenden Zeile her.
Zustände und Eigenschaften
aria-colspan-
Ähnlich dem Attribut
colspander HTML-Elemente<th>und<td>legt es fest, über wie viele Spalten sich die Zelle erstreckt. aria-rowspan-
Ähnlich dem Attribut
rowspander HTML-Elemente<th>und<td>legt es fest, über wie viele Zeilen sich die Zelle erstreckt. - Attribut
aria-colindex -
Das Attribut
aria-colindexwird nur benötigt, wenn Spalten im DOM nicht vorhanden sind. Als Wert erhält es eine ganze Zahl zwischen 1 und der Gesamtzahl der Spalten innerhalb dertable, desgridoder destreegrid.aria-colindexgibt den Spaltenindex oder die Position eines Elements bezogen auf die Gesamtzahl der Spalten innerhalb einer Zeile an. Sind alle Spalten im DOM vorhanden, ist dieses Attribut nicht erforderlich. - Attribut
aria-rowindex -
Das Attribut
aria-rowindexwird nur benötigt, wenn Zeilen im DOM nicht vorhanden sind. Es gibt an, in welcher Zeile sich die aktuelle Zelle bezogen auf die Gesamtzahl der Zeilen befindet. Als Wert erhält das Attribut eine ganze Zahl zwischen 1 und der Gesamtzahl der Zeilen innerhalb der Tabelle, des Rasters oder des Baumrasters. Diese Zahl gibt die Position beziehungsweise den Index der Zelle an. Beispielsweise hätte eine Zelle in der ersten Zeile des ersten Tabellenkopfs wahrscheinlicharia-rowindex="1"und Zellen in Zeile 47 hättenaria-rowindex="47", fallsaria-rowindexerforderlich ist, weil nicht alle Zeilen im DOM vorhanden sind. Wenn die vorhandenen Zeilen aufeinanderfolgen und keine Zellen einencolspan- oderrowspan-Wert größer als eins haben, kann diese Eigenschaft statt auf allen Zellen auch auf deren übergeordneten Zeilen gesetzt werden.
Tastaturinteraktionen
Keine.
Erforderliche JavaScript-Funktionen
Die erste Regel für die Verwendung von ARIA lautet: Wenn Sie statt der Umwidmung eines Elements und des Hinzufügens einer ARIA-Rolle, eines ARIA-Zustands oder einer ARIA-Eigenschaft zur Herstellung der Barrierefreiheit eine native Funktion mit der benötigten Semantik und dem benötigten Verhalten verwenden können, sollten Sie das tun. Verwenden Sie nach Möglichkeit das HTML-Element <td> anstelle der ARIA-Rolle cell.
Bewährte Vorgehensweisen
Verwenden Sie <table>, <tbody>, <thead>, <tr>, <th>, <td> usw. ausschließlich für die Struktur von Datentabellen. Sie können ARIA-Rollen hinzufügen, um die Barrierefreiheit sicherzustellen, wenn die native Semantik der Tabelle beispielsweise durch CSS entfernt wurde. Ein relevanter Anwendungsfall für die ARIA-Rolle table liegt vor, wenn die native Semantik einer Tabelle durch die CSS-Eigenschaft display, etwa durch display: grid, überschrieben wird. In diesem Fall können Sie die ARIA-Tabellenrollen verwenden, um die Semantik wiederherzustellen.
<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-rowindex="1">ARIA Role</th>
<th role="columnheader" aria-sort="none" aria-rowindex="1">
Semantic Element
</th>
</tr>
</thead>
<tbody role="rowgroup">
<tr role="row">
<td role="cell" aria-rowindex="11">header</td>
<td role="cell" aria-rowindex="11">h1</td>
</tr>
<tr role="row">
<td role="cell" aria-rowindex="16">header</td>
<td role="cell" aria-rowindex="16">h6</td>
</tr>
<tr role="row">
<td role="cell" aria-rowindex="18">rowgroup</td>
<td role="cell" aria-rowindex="18">thead</td>
</tr>
<tr role="row">
<td role="cell" aria-rowindex="24">term</td>
<td role="cell" aria-rowindex="24">dt</td>
</tr>
</tbody>
</table>
Oben sehen Sie die semantisch korrekte Schreibweise einer Tabelle. Die ARIA-Rollen sind nicht erforderlich, solange die native Semantik der Tabelle und damit auch der Tabellenzeilen nicht verändert wurde, beispielsweise durch die Eigenschaft display.
Zusätzliche Vorteile
Wird die Rolle auf ein <td> angewendet, gibt sie dem Element seine Zellensemantik zurück, falls diese beispielsweise durch display: grid; entfernt wurde.
Beispiele
<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-rowindex="1"
>ARIA Role</span
>
<span role="columnheader" aria-sort="none" aria-rowindex="1"
>Semantic Element</span
>
</div>
</div>
<div role="rowgroup">
<div role="row">
<span role="cell" aria-rowindex="11">header</span>
<span role="cell" aria-rowindex="11">h1</span>
</div>
<div role="row">
<span role="cell" aria-rowindex="16">header</span>
<span role="cell" aria-rowindex="16">h6</span>
</div>
<div role="row">
<span role="cell" aria-rowindex="18">rowgroup</span>
<span role="cell" aria-rowindex="18">thead</span>
</div>
<div role="row">
<span role="cell" aria-rowindex="24">term</span>
<span role="cell" aria-rowindex="24">dt</span>
</div>
</div>
</div>
Das obige Beispiel zeigt eine nicht semantische ARIA-Tabelle, bei der fünf von 81 Zeilen im DOM vorhanden sind: eine im Tabellenkopf und vier im Tabellenkörper. Da nicht alle Zeilen im DOM vorhanden sind, wurde die Eigenschaft aria-rowindex auf jede Zelle angewendet. Würde sich keine Zelle über mehr als eine Zeile oder Spalte erstrecken, könnte aria-rowindex statt auf den einzelnen Zellen der Zeile auf der Zeile selbst gesetzt werden.
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # cell> |
| Unknown specification> |