CKTIS / HTML
aria-selected — wybór pozycji w kontrolce złożonej
`aria-selected` opisuje wybór elementu, takiego jak zakładka, opcja albo interaktywna komórka, zgodnie z jego rolą.
Wersja: WAI-ARIA 1.2
Składnia
<button role="tab" aria-selected="true">Preview</button>Stosuj true lub false na rolach obsługujących wybór. Brak właściwości może oznaczać, że pozycja nie jest wybieralna. To nie bieżąca strona i nie sam fokus: aria-current odpowiada innemu znaczeniu.
W interfejsie wielokrotnego wyboru ustaw też właściwy model kontenera. Sam stan nie wybiera danych, nie ukrywa paneli i nie zarządza klawiaturą. Aktualizuj wygląd, fokus i wybór zgodnie z przyjętym wzorcem, nie utożsamiając ich automatycznie.
Przykład zakładek aktywuje Preview, aktualizuje oba stany i widoczność paneli. Strzałka przenosi fokus bez zmiany wyboru; aktywacja następuje osobno. Test sprawdza drzewo dostępności, panele i to rozdzielenie fokusu od wyboru.
Przykłady
<!doctype html><meta charset="utf-8">
<div role="tablist" aria-label="Editor views">
<button id="edit" role="tab" aria-selected="true" aria-controls="editor">Edit</button>
<button id="view" role="tab" aria-selected="false" aria-controls="preview" tabindex="-1">Preview</button></div>
<section id="editor" role="tabpanel" aria-labelledby="edit">Editor content</section>
<section id="preview" role="tabpanel" aria-labelledby="view" hidden>Preview content</section>
<output id="result"></output>
<script>
const tabs = [...document.querySelectorAll('[role=tab]')];
tabs.forEach((tab, i) => {
tab.addEventListener('click', () => tabs.forEach(other => {
const selected = other === tab;
other.setAttribute('aria-selected', String(selected)); other.tabIndex = selected ? 0 : -1;
document.getElementById(other.getAttribute('aria-controls')).hidden = !selected;
}));
tab.addEventListener('keydown', event => {
if (event.key === 'ArrowRight' || event.key === 'ArrowLeft') {
event.preventDefault(); tabs[1 - i].focus();
}
});
});
document.querySelector('#view').click();
document.querySelector('#result').textContent = 'selected=' + document.querySelector('[aria-selected=true]').textContent + '; firstHidden=' + document.querySelector('#editor').hidden + '; secondHidden=' + document.querySelector('#preview').hidden;
</script>Wynik
selected=Preview; firstHidden=true; secondHidden=false
To przykład ręcznej aktywacji zakładek. Strzałki wybierają cel fokusu, a kliknięcie lub aktywacja przycisku zmienia panel.