ARIA: aria-colspan-Attribut
Das Attribut aria-colspan definiert die Anzahl der Spalten, über die sich eine Zelle oder gridcell innerhalb einer table, eines grid oder eines treegrid erstreckt.
Beschreibung
Die Eigenschaft aria-colspan ist für cells und gridcells vorgesehen, die sich nicht in einer nativen HTML-<table> befinden. Ihr Wert definiert, über wie viele Spalten sich eine einzelne Zelle einer ARIA-table, eines ARIA-grid oder eines ARIA-treegrid erstreckt.
In HTML verfügen <th>- und <td>-Elemente über das Attribut colspan. Wenn Sie eine semantische <table> verwenden, nutzen Sie das native Attribut colspan. Dieses ARIA-Attribut ist für Zellen und gridcells vorgesehen, die sich nicht in einer nativen Tabelle befinden. Wird es für eine Zelle in einer <table> verwendet, wird es ignoriert.
Hinweis:
Die erste Regel für die Verwendung von ARIA lautet: Wenn Sie eine native Funktion verwenden können, die bereits die erforderliche Semantik und das erforderliche Verhalten bietet, sollten Sie dies tun, statt ein Element zweckzuentfremden und eine ARIA-Rolle, einen ARIA-Zustand oder eine ARIA-Eigenschaft hinzuzufügen, um es zugänglich zu machen. Verwenden Sie nach Möglichkeit HTML-<table>-Elemente einschließlich <td> und <th> mit dem Attribut colspan statt nicht semantischer Elemente mit ARIA-Rollen und -Attributen.
Der Wert von aria-colspan sollte eine positive Ganzzahl sein. Der Standardwert beziehungsweise angenommene Wert für die Spaltenanzahl einer Zelle ist 1. Stellen Sie sicher, dass der angegebene Wert nicht dazu führt, dass sich die Zelle oder gridcell mit der nächsten Zelle oder gridcell derselben Zeile überschneidet oder über die umgebende Tabelle, das grid oder das treegrid hinaus erstreckt.
Werte
<integer>-
Eine Ganzzahl, die mindestens dem Standardwert 1 entspricht und die Anzahl der Spalten definiert, über die sich die Zelle erstreckt. Der Wert muss so klein sein, dass sich die Zelle nicht mit der nächsten Zelle derselben Zeile überschneidet.
Zugehörige Schnittstellen
Element.ariaColSpan-
Die Eigenschaft
ariaColSpan, die zur Schnittstelle jedes Elements gehört, spiegelt den Wert des Attributsaria-colspanwider. Dieses definiert die Anzahl der Spalten, über die sich eine Zelle oder gridcell innerhalb einer Tabelle, eines grid oder eines treegrid erstreckt.
Zugehörige Rollen
Verwendet in der Rolle:
Wird an folgende Rollen vererbt:
Beispiel
Das folgende Beispiel zeigt einen Ausschnitt aus einer Ergebnistabelle einer Bowling-Turnierliga. Jedes Spiel umfasst 10 Frames, und jeder Frame umfasst drei Wertungsfelder: zwei Würfe und die aktuelle Gesamtpunktzahl. Der zehnte und letzte Frame jedes Spiels erstreckt sich über vier Spalten, falls jemand ausschließlich Strikes erzielt.
<div role="grid" aria-rowcount="27">
aria-label="Bowling League Scores"
<div role="rowgroup">
<div role="row" aria-rowindex="1">
<!--
aria-rowspan and aria-colspan provide
assistive technologies with the correct data cell header information
when header cells span more than one row or column.
-->
<span role="columnheader" aria-rowspan="2">Team</span>
<span role="columnheader" aria-colspan="2">Player</span>
<span role="columnheader" aria-colspan="31">Game 1 Frames</span>
<span role="columnheader" aria-colspan="31">Game 2 Frames</span>
<span role="columnheader" aria-colspan="31">Game 3 Frames</span>
<span role="columnheader" aria-rowspan="2">Total</span>
</div>
<div role="row" aria-rowindex="2">
<span role="columnheader">Last Name</span>
<span role="columnheader">First Name</span>
<span role="columnheader" aria-colspan="3">1</span>
<span role="columnheader" aria-colspan="3">2</span>
<span role="columnheader" aria-colspan="3">3</span>
<span role="columnheader" aria-colspan="3">4</span>
<span role="columnheader" aria-colspan="3">5</span>
<span role="columnheader" aria-colspan="3">6</span>
<span role="columnheader" aria-colspan="3">7</span>
<span role="columnheader" aria-colspan="3">8</span>
<span role="columnheader" aria-colspan="3">9</span>
<span role="columnheader" aria-colspan="4">10</span>
<span role="columnheader" aria-colspan="3">1</span>
<span role="columnheader" aria-colspan="3">2</span>
<span role="columnheader" aria-colspan="3">3</span>
<span role="columnheader" aria-colspan="3">4</span>
<span role="columnheader" aria-colspan="3">5</span>
<span role="columnheader" aria-colspan="3">6</span>
<span role="columnheader" aria-colspan="3">7</span>
<span role="columnheader" aria-colspan="3">8</span>
<span role="columnheader" aria-colspan="3">9</span>
<span role="columnheader" aria-colspan="4">10</span>
<span role="columnheader" aria-colspan="3">1</span>
<span role="columnheader" aria-colspan="3">2</span>
<span role="columnheader" aria-colspan="3">3</span>
<span role="columnheader" aria-colspan="3">4</span>
<span role="columnheader" aria-colspan="3">5</span>
<span role="columnheader" aria-colspan="3">6</span>
<span role="columnheader" aria-colspan="3">7</span>
<span role="columnheader" aria-colspan="3">8</span>
<span role="columnheader" aria-colspan="3">9</span>
<span role="columnheader" aria-colspan="4">10</span>
</div>
</div>
<div role="rowgroup">
<div role="row" aria-rowindex="10">
<span role="rowheader" aria-rowspan="3">The Mighty Quokkas</span>
<span role="cell">Henderson</span>
<span role="cell">Alice</span>
<span role="cell">7</span>
<span role="cell">/</span>
<span role="cell">20</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">39</span>
<span role="cell">9</span>
<span role="cell">-</span>
<span role="cell">48</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">76</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">96</span>
<span role="cell">8</span>
<span role="cell">/</span>
<span role="cell">113</span>
<span role="cell">7</span>
<span role="cell">-</span>
<span role="cell">120</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">146</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">166</span>
<span role="cell">6</span>
<span role="cell">/</span>
<span role="cell">X</span>
<span role="cell">186</span>
<span role="cell">7</span>
<span role="cell">2</span>
<span role="cell">9</span>
<span role="cell">6</span>
<span role="cell">-</span>
<span role="cell">15</span>
<span role="cell" aria-colspan="2">X</span>
<span role="cell">35</span>
<span role="cell">7</span>
<span role="cell">/</span>
…
</div>
<div role="row" aria-rowindex="11">
<span role="cell">McPherson</span>
<span role="cell">Leslie</span>
<span role="cell">9</span>
<span role="cell">-</span>
<span role="cell">9</span>
<span role="cell">8</span>
<span role="cell">1</span>
<span role="cell">18</span>
…
</div>
</div>
</div>
Wenn wir eine <table> und semantische Tabellenelemente verwendet hätten, wäre unser Markup weniger umfangreich und standardmäßig zugänglich gewesen.
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA)> # aria-colspan> |
Siehe auch
- Das Attribut
colspander Elemente<th>und<td> - Die Eigenschaft
aria-colindex - Die Eigenschaft
aria-rowspan - Die Rolle
cell - Die Rolle
columnheader - Die Rolle
rowheader