Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

aria-current — bieżąca pozycja w zbiorze

`aria-current` oznacza bieżącą stronę, krok lub inną aktualną pozycję w grupie powiązanych elementów.

Wersja: WAI-ARIA 1.2

Składnia

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

Dozwolone tokeny to page, step, location, date, time, true i false. Brak, pusta wartość lub undefined oznacza brak bieżącego elementu; nieznany niepusty token jest traktowany jak prawda. Używaj jednak konkretnego poprawnego tokenu.

W jednym zbiorze oznaczaj jedną pozycję jako bieżącą. To nie zaznaczenie zakładki ani fokus: nie zastępuje aria-selected i nie wykonuje nawigacji. Zapewnij również widoczne wyróżnienie, niezależne od samego koloru.

Przykład przenosi znacznik z Home do Courses, usuwając poprzedni. Celowo zatrzymuje nawigację, aby pokazać samą aktualizację; w aplikacji znacznik musi odpowiadać faktycznie wyświetlonej stronie. Test potwierdza dokładnie jeden bieżący odnośnik.

Przykłady

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

Wynik

current=Courses; count=1

Lokalna demonstracja nie otwiera nowej strony. Sprawdzono zmianę wskazania, nie gotowy router.

Źródła