CKTIS / HTML
aria-selected — selezione in un componente composito
`aria-selected` descrive la selezione di un elemento, come scheda, opzione o cella interattiva, secondo il suo ruolo.
Versione: WAI-ARIA 1.2
Sintassi
<button role="tab" aria-selected="true">Preview</button>Usa true o false sui ruoli che supportano la selezione. L’assenza della proprietà può indicare che un elemento non è selezionabile. Non è la pagina corrente né il focus stesso: aria-current ha un altro significato.
Per la selezione multipla configura anche il modello di selezione del contenitore. Lo stato da solo non seleziona dati, non nasconde pannelli e non gestisce la tastiera. Aggiorna aspetto, focus e selezione secondo il modello scelto, senza identificarli automaticamente.
L’esempio di schede attiva Preview, aggiorna entrambi gli stati e cambia la visibilità dei pannelli. Una freccia sposta il focus senza cambiare selezione; l’attivazione è separata. Il test verifica albero di accessibilità, pannelli e distinzione tra focus e selezione.
Esempi
<!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>Risultato
selected=Preview; firstHidden=true; secondHidden=false
È un esempio di attivazione manuale delle schede. Le frecce spostano il focus; il clic o l’attivazione del pulsante cambia il pannello.