aria-current
Ein nicht-leerer aria-current
-Zustand auf einem Element zeigt an, dass dieses Element das aktuelle Element innerhalb eines Containers oder einer Gruppe verwandter Elemente darstellt.
Beschreibung
Wenn Sie eine Gruppe verwandter Elemente haben, wie z.B. mehrere Links in einem Breadcrumb oder Schritte in einem mehrstufigen Ablauf, wobei ein Element in der Gruppe anders als die anderen gestaltet ist, um dem sehenden Benutzer zu signalisieren, dass dies das aktuelle Element innerhalb seiner Gruppe ist, sollte aria-current
verwendet werden, um dem Benutzer von unterstützender Technologie mitzuteilen, was durch die Gestaltung angezeigt wurde.
In einer Breadcrumb-Liste, wenn ein Link innerhalb eines Sets von Paginierungslinks so gestaltet ist, dass der Benutzer auf dieser Seite ist, sollte aria-current="page"
auf diesen Link gesetzt werden. In einem auf mehreren Schritten basierenden Prozess mit einem Schrittanzeiger, wie bei einer Umfrage über mehrere Seiten oder einem mehrstufigen Checkout- oder Registrierungsprozess, wenn das aktuelle Schritticon visuell anders ist, um zu zeigen, dass es sich um den aktuellen Schritt handelt, sollte der Container dieses Icons aria-current="step"
für Benutzer unterstützender Technologien haben, die den visuellen Unterschied möglicherweise nicht "sehen" können.
Das aria-current
-Attribut zeigt an, dass das Element, auf dem es gesetzt ist, mit einem Wert ungleich false
das aktuelle Element innerhalb eines Containers oder einer Gruppe verwandter Elemente darstellt. Markieren Sie nur ein Element in einer Gruppe von Elementen als aktuell mit aria-current
.
Das aria-current
-Attribut akzeptiert eine begrenzte Liste von Werten, einschließlich page
, step
, location
, date
, time
, true
und false
. Jeder nicht-leere Zeichenfolgenwert, der sich nicht in dieser Liste von aufgezählten Werten befindet, wird behandelt, als wäre aria-current="true"
gesetzt, und nicht als der Standardwert false
. Wenn das Attribut nicht vorhanden ist, eine leere Zeichenfolge ist, ohne Wert vorhanden ist oder auf aria-current="false"
gesetzt ist, wird es dem Benutzer nicht angezeigt.
Wenn etwas ausgewählt statt aktuell ist, wie z.B. ein tab
in einer tablist
, verwenden Sie aria-selected
, um das aktuell angezeigte Tabpanel zu kennzeichnen.
Hinweis:
Verwenden Sie aria-current
nicht als Ersatz für aria-selected
in gridcell
, option
, row
oder tab
.
Beispiel
Das Breadcrumb für die "aktuelle Seite" sollte aria-current="page"
darauf gesetzt haben.
<nav aria-label="Breadcrumb" class="breadcrumb">
<ol>
<li>
<a href="../../../../../">Web technology for developers</a>
</li>
<li>
<a href="../../../../">Accessibility</a>
</li>
<li>
<a href="../../../">ARIA</a>
</li>
<li>
<a href="../../">ARIA States and Properties</a>
</li>
<li>
<a href="./" aria-current="page">ARIA: `aria-current` attribute</a>
</li>
</ol>
</nav>
Wenn das Element, das die aktuelle Seite im Breadcrumb darstellt, kein Link wäre, ist aria-current
optional.
Werte
page
-
Stellt die aktuelle Seite innerhalb eines Satzes von Seiten dar, wie z.B. den Link zum aktuellen Dokument in einem Breadcrumb.
step
-
Stellt den aktuellen Schritt innerhalb eines Prozesses dar, wie z.B. den aktuellen Schritt in einem aufgezählten mehrstufigen Checkout-Ablauf.
location
-
Stellt den aktuellen Ort innerhalb einer Umgebung oder eines Kontexts dar, wie z.B. das Bild, das als aktueller Bestandteil eines Flussdiagramms visuell hervorgehoben ist.
date
-
Stellt das aktuelle Datum innerhalb einer Sammlung von Daten dar, wie z.B. das aktuelle Datum innerhalb eines Kalenders.
time
-
Stellt die aktuelle Zeit innerhalb eines Satzes von Zeiten dar, wie z.B. die aktuelle Zeit innerhalb eines Zeitplans.
true
-
Stellt das aktuelle Element innerhalb eines Satzes dar.
false
(Standard)-
Stellt nicht das aktuelle Element innerhalb eines Satzes dar.
Zugehörige Schnittstellen
Element.ariaCurrent
-
Die
ariaCurrent
-Eigenschaft, Teil derElement
-Schnittstelle, spiegelt den Wert desaria-current
-Attributs wider. ElementInternals.ariaCurrent
-
Die
ariaCurrent
-Eigenschaft derElementInternals
-Schnittstelle spiegelt den Wert desaria-current
-Attributs wider.
Zugehörige Rollen
Verwendbar in allen Rollen; außer für Elemente mit der Rolle gridcell
, option
, row
und tab
, wo aria-selected
verwendet werden sollte.
Spezifikationen
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-current |