ARIA: gridcell-Rolle
Die Rolle gridcell wird verwendet, um eine Zelle in einem Grid oder Treegrid darzustellen. Sie soll die Funktionalität des HTML-Elements <td> für die tabellenartige Gruppierung von Informationen nachbilden.
<div role="gridcell">Potato</div>
<div role="gridcell">Cabbage</div>
<div role="gridcell">Onion</div>
Elemente mit role="gridcell" müssen untergeordnete Elemente eines Elements mit der Rolle row sein.
<div role="row">
<div role="gridcell">Jane</div>
<div role="gridcell">Smith</div>
<div role="gridcell">496-619-5098</div>
…
</div>
Die erste Regel von ARIA lautet: Wenn ein natives HTML-Element oder -Attribut die benötigte Semantik und das benötigte Verhalten bietet, verwenden Sie es, statt einem anderen Element durch ARIA eine neue Funktion zu geben. Verwenden Sie stattdessen das HTML-Element <td>:
<td>Potato</td>
<td>Cabbage</td>
<td>Onion</td>
Beschreibung
>gridcells bei dynamisch hinzugefügten, ausgeblendeten oder entfernten Zeilen und Spalten
Wenn in einer Tabelle, einem Grid oder einem Treegrid Zeilen und/oder Spalten dynamisch hinzugefügt, ausgeblendet oder entfernt werden können, sollte jedes Element mit role="gridcell" seine Position innerhalb der tabellenartigen Gruppierung mithilfe von ARIA beschreiben.
Verwenden Sie aria-colindex, um die Position einer gridcell innerhalb der Spalten anzugeben, und aria-rowindex für ihre Position innerhalb der Zeilen. Geben Sie mit aria-colcount und aria-rowcount am übergeordneten Element mit role="grid" die Gesamtzahl der Spalten beziehungsweise Zeilen an.
Der folgende Beispielcode zeigt eine tabellenartige Gruppierung von Informationen, aus der die dritte und vierte Spalte entfernt wurden. aria-colindex beschreibt die Position der Spalten und ermöglicht Personen, die Hilfstechnologien verwenden, zu erkennen, dass bestimmte Spalten entfernt wurden:
<div role="grid" aria-colcount="6">
<div role="rowgroup">
<div role="row">
<div role="columnheader" aria-colindex="1">First name</div>
<div role="columnheader" aria-colindex="2">Last name</div>
<div role="columnheader" aria-colindex="5">City</div>
<div role="columnheader" aria-colindex="6">Zip</div>
</div>
</div>
<div role="rowgroup">
<div role="row">
<div role="gridcell" aria-colindex="1">Debra</div>
<div role="gridcell" aria-colindex="2">Burks</div>
<div role="gridcell" aria-colindex="5">New York</div>
<div role="gridcell" aria-colindex="6">14127</div>
</div>
</div>
…
</div>
Die Position von gridcells beschreiben, wenn die Gesamtstruktur unbekannt ist
Wenn die tabellenartige Gruppierung von Inhalten keine Informationen über Spalten und Zeilen bereitstellt, muss die Position von gridcells mithilfe von aria-describedby programmatisch beschrieben werden. Die für aria-describedby angegebenen id-Werte sollten auf übergeordnete Elemente verweisen, die als Zeilen und Spalten dienen sollen.
Wenn aria-describedby auf übergeordnete Elemente mit den Rollen rowheader oder columnheader verweist, können Hilfstechnologien die Position des gridcell-Elements und seine Beziehung zur übrigen tabellenartigen Gruppierung von Inhalten erkennen.
Interaktive Grids und Treegrids
Bearbeitbare Zellen
Sowohl <td>-Elemente als auch Elemente mit der Rolle gridcell können bearbeitbar gemacht werden, ähnlich wie Zellen in einer Tabellenkalkulation. Dazu wird das HTML-Attribut contenteditable verwendet.
<td contenteditable="true">Notes</td>
<div role="gridcell" contenteditable="true">Item cost</div>
contenteditable macht das Element, auf das es angewendet wird, über die Tab-Taste fokussierbar. Wenn eine gridcell bedingt in einen Zustand versetzt wird, in dem die Bearbeitung nicht zulässig ist, ändern Sie den Wert von aria-readonly am gridcell-Element entsprechend.
Aufklappbare Zellen
In einem Treegrid können gridcells durch Ändern des Attributs aria-expanded anzeigen, ob sie auf- oder zugeklappt sind. Beachten Sie, dass dieses Attribut, sofern es angegeben ist, nur für die einzelne gridcell gilt, nicht für die umgebende Zeile. Der wichtigste Anwendungsfall sind Pivot-Tabellen, in denen gruppierte Daten hierarchisch dargestellt werden.
Zugehörige WAI-ARIA-Rollen, -Zustände und -Eigenschaften
grid-
Zeigt an, dass ein übergeordnetes Element eine tabellen- oder baumartige Gruppierung von Informationen ist.
row-
Ist erforderlich, um anzuzeigen, dass die
gridcellzu einer Zeile einer tabellenartigen Gruppierung von Informationen gehört. columnheader-
Gibt an, welches Element die zugehörige Spaltenüberschrift ist.
aria-colindex-
Gibt die Position eines Elements im Verhältnis zu den übrigen Spalten der tabellenartigen Gruppierung von Informationen an.
rowheader-
Gibt an, welches Element die zugehörige Zeilenüberschrift ist.
aria-rowindex-
Gibt die Position eines Elements im Verhältnis zu den übrigen Zeilen der tabellenartigen Gruppierung von Informationen an.
Beispiele
Das folgende Beispiel erstellt eine tabellenartige Gruppierung von Informationen:
<h3 id="table-title">Jovian gas giant planets</h3>
<div role="grid" aria-describedby="table-title">
<div role="rowgroup">
<div role="row">
<div role="columnheader">Name</div>
<div role="columnheader">Diameter (km)</div>
<div role="columnheader">Length of day (hours)</div>
<div role="columnheader">Distance from Sun (10<sup>6</sup>km)</div>
<div role="columnheader">Number of moons</div>
</div>
</div>
<div role="rowgroup">
<div role="row">
<div role="gridcell">Jupiter</div>
<div role="gridcell">142,984</div>
<div role="gridcell">9.9</div>
<div role="gridcell">778.6</div>
<div role="gridcell">67</div>
</div>
</div>
<div role="rowgroup">
<div role="row">
<div role="gridcell">Saturn</div>
<div role="gridcell">120,536</div>
<div role="gridcell">10.7</div>
<div role="gridcell">1433.5</div>
<div role="gridcell">62</div>
</div>
</div>
</div>
Bedenken hinsichtlich der Barrierefreiheit
gridcell und bestimmte zugehörige ARIA-Rollen und -Eigenschaften werden von Hilfstechnologien nur unzureichend unterstützt. Verwenden Sie nach Möglichkeit stattdessen HTML-Tabellen-Markup.
Bewährte Verfahren
Die erste Regel von ARIA lautet: Wenn ein natives HTML-Element oder -Attribut die benötigte Semantik und das benötigte Verhalten bietet, verwenden Sie es, statt einem anderen Element eine ARIA-Rolle, einen ARIA-Zustand oder eine ARIA-Eigenschaft zuzuweisen, um es barrierefrei zu machen. Daher empfiehlt es sich, natives HTML-Tabellen-Markup zu verwenden, statt Form und Funktionalität einer Tabelle mit ARIA und JavaScript nachzubilden.
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # gridcell> |