aria-current
Ein nicht-null 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 beispielsweise mehrere Links in einem Breadcrumb oder Schritte in einem mehrstufigen Ablauf, bei dem ein Element in der Gruppe anders gestaltet ist als die anderen, um dem sehenden Benutzer anzuzeigen, dass dies das aktuelle Element innerhalb seiner Gruppe ist, sollte aria-current
verwendet werden, um dem Nutzer von unterstützender Technologie mitzuteilen, was über das Styling angezeigt wurde.
In einer Breadcrumb-Liste, wenn ein Link innerhalb eines Satzes von Paginierungslinks gestaltet ist, um anzuzeigen, dass der Benutzer sich derzeit auf dieser Seite befindet, sollte aria-current="page"
auf diesem Link gesetzt werden. In einem mehrstufigen Prozess mit einem Schrittindikator wie einem mehrseitigen Fragebogen oder einem mehrstufigen Checkout- oder Registrierungsprozess, wenn das aktuelle Schritt-Symbol visuell anders dargestellt wird, um zu zeigen, dass es der aktuelle Schritt ist, sollte der Container dieses Symbols aria-current="step"
für Nutzer von unterstützender Technologie 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 immer nur ein Element in einem Satz 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-null-String-Wert, der nicht in dieser Liste der aufgezählten Werte enthalten ist, wird behandelt, als wäre aria-current="true"
gesetzt, nicht der Standardwert false
. Wenn das Attribut nicht vorhanden ist, ein leerer String 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 beispielsweise ein tab
in einer tablist
, verwenden Sie aria-selected
, um das derzeit angezeigte Tabpanel anzuzeigen.
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"
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 war, ist aria-current
optional.
Werte
page
-
Repräsentiert die aktuelle Seite innerhalb eines Satzes von Seiten, wie der Link zum aktuellen Dokument in einem Breadcrumb.
step
-
Repräsentiert den aktuellen Schritt innerhalb eines Prozesses, wie den aktuellen Schritt in einem aufgezählten mehrstufigen Checkout-Ablauf.
location
-
Repräsentiert den aktuellen Standort innerhalb einer Umgebung oder eines Kontextes, wie das Bild, das visuell hervorgehoben ist als das aktuelle Element eines Flussdiagramms.
date
-
Repräsentiert das aktuelle Datum innerhalb einer Sammlung von Daten, wie das aktuelle Datum innerhalb eines Kalenders.
time
-
Repräsentiert die aktuelle Zeit innerhalb eines Satzes von Zeiten, wie die aktuelle Zeit innerhalb eines Zeitplans.
true
-
Repräsentiert das aktuelle Element innerhalb eines Satzes.
false
(Standard)-
Repräsentiert nicht das aktuelle Element innerhalb eines Satzes.
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
, bei denen aria-selected
verwendet werden sollte.
Spezifikationen
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-current |