CKTIS / HTML
aria-selected — Auswahl in einem zusammengesetzten Widget
`aria-selected` beschreibt die Auswahl eines Elements wie Tab, Option oder interaktive Zelle entsprechend seiner Rolle.
Version: WAI-ARIA 1.2
Syntax
<button role="tab" aria-selected="true">Preview</button>Verwende true oder false auf Rollen, die Auswahl unterstützen. Das Fehlen der Eigenschaft kann bedeuten, dass ein Element nicht auswählbar ist. Dies ist weder die aktuelle Seite noch der Fokus selbst: aria-current hat eine andere Bedeutung.
Konfiguriere bei Mehrfachauswahl auch das Auswahlmodell des Containers. Der Zustand allein wählt keine Daten, verbirgt keine Bereiche und steuert keine Tastatur. Aktualisiere Darstellung, Fokus und Auswahl gemäß dem gewählten Muster, ohne sie automatisch gleichzusetzen.
Das Tab-Beispiel aktiviert Preview, aktualisiert beide Zustände und ändert die Sichtbarkeit der Bereiche. Eine Pfeiltaste verschiebt den Fokus ohne Auswahländerung; die Aktivierung erfolgt separat. Der Test prüft Barrierefreiheitsbaum, Bereiche und diese Trennung von Fokus und Auswahl.
Beispiele
<!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>Ergebnis
selected=Preview; firstHidden=true; secondHidden=false
Dies ist manuelle Tab-Aktivierung. Pfeiltasten verschieben den Fokus; Klicken oder Aktivieren des Buttons wechselt den Bereich.