Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

aria-pressed — trwały stan przycisku przełączającego

`aria-pressed` odróżnia przycisk przełączający stan od zwykłego przycisku wykonującego jednorazowe polecenie.

Wersja: WAI-ARIA 1.2

Składnia

<button aria-pressed="false">Bold</button>

Na przycisku użyj true, false lub mixed. Brak stanu oznacza zwykły przycisk. Stan mieszany może opisywać niejednakowe ustawienie grupy, a nie chwilowe fizyczne przytrzymanie klawisza.

Zachowaj stałą nazwę, np. Bold, i osobno aktualizuj stan oraz widoczny efekt. Natywny przycisk zapewnia podstawową aktywację klawiaturą, lecz ARIA nie dodaje logiki przełączania ani stylu. Nie używaj tej właściwości zamiast zaznaczenia pola wyboru.

Przykład przełącza pogrubienie tekstu i stan przycisku jedną funkcją. Test potwierdza wciśnięty stan w drzewie dostępności oraz obliczoną grubość fontu 700. Dzięki temu pokazuje zarówno opis dla technologii wspomagających, jak i rzeczywistą zmianę wyglądu.

Przykłady

<!doctype html><meta charset="utf-8">
<style>.bold {font-weight:700} #sample:not(.bold) {font-weight:400}</style>
<button id="bold" aria-pressed="false">Bold</button><p id="sample">Selected text</p>
<output id="result"></output>
<script>
const button = document.querySelector('#bold'), sample = document.querySelector('#sample');
button.addEventListener('click', () => {
  const pressed = button.getAttribute('aria-pressed') !== 'true';
  button.setAttribute('aria-pressed', String(pressed)); sample.classList.toggle('bold', pressed);
});
button.click();
document.querySelector('#result').textContent = 'pressed=' + button.getAttribute('aria-pressed') + '; weight=' + getComputedStyle(sample).fontWeight;
</script>

Wynik

pressed=true; weight=700

Wynik dotyczy włączonego pogrubienia. Ponowna aktywacja odwraca stan, pozostawiając tę samą nazwę.

Źródła