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: 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 Attributs aria-colspan wider. 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.

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