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: 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.

html
<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.

html
<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>:

html
<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:

html
<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.

html
<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 gridcell zu 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:

html
<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

Siehe auch