WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

aria-current — aktuelles Element einer Gruppe

`aria-current` kennzeichnet die aktuelle Seite, den aktuellen Schritt oder ein anderes aktuelles Element innerhalb einer zusammengehörenden Gruppe.

Version: WAI-ARIA 1.2

Syntax

<a href="/courses" aria-current="page">Courses</a>

Zulässige Tokens sind page, step, location, date, time, true und false. Fehlender oder leerer Wert sowie undefined bedeuten nicht aktuell; ein unbekanntes nicht leeres Token wird als wahr behandelt. Verwende trotzdem ein passendes gültiges Token.

Kennzeichne innerhalb einer Gruppe ein Element als aktuell. Das ist weder ein ausgewählter Tab noch der Tastaturfokus: Es ersetzt aria-selected nicht und führt keine Navigation aus. Sorge auch für eine sichtbare Kennzeichnung, die nicht allein auf Farbe beruht.

Das Beispiel verschiebt die Kennzeichnung von Home zu Courses und entfernt die alte. Die Navigation wird absichtlich unterbunden, um die Aktualisierung zu zeigen; in einer Anwendung muss die Kennzeichnung zur tatsächlich angezeigten Seite passen. Der Test bestätigt genau einen aktuellen Link.

Beispiele

<!doctype html><meta charset="utf-8">
<nav aria-label="Sections"><a href="/" aria-current="page">Home</a> <a id="courses" href="/courses">Courses</a></nav>
<output id="result"></output>
<script>
const links = [...document.querySelectorAll('nav a')];
links.forEach(link => link.addEventListener('click', event => {
  event.preventDefault();
  links.forEach(other => other.removeAttribute('aria-current'));
  link.setAttribute('aria-current', 'page');
}));
document.querySelector('#courses').click();
const current = document.querySelectorAll('[aria-current="page"]');
document.querySelector('#result').textContent = 'current=' + current[0].textContent + '; count=' + current.length;
</script>

Ergebnis

current=Courses; count=1

Die lokale Demonstration öffnet keine andere Seite. Geprüft wird der Wechsel der Kennzeichnung, kein vollständiger Router.

Quellen