CKTIS / HTML
aria-modal — semantica delle finestre di dialogo modali
L’attributo aria-modal informa le tecnologie assistive se un elemento visualizzato è modale, cioè se l’interazione è limitata ai suoi contenuti. Da solo non blocca lo sfondo né gestisce il focus: la dichiarazione deve corrispondere al comportamento effettivo dell’interfaccia.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
aria-modal="true" | aria-modal="false"aria-modal è una proprietà WAI-ARIA usata in HTML per indicare se un elemento visualizzato è modale. Il valore true indica la modalità; false è il valore predefinito. Questa proprietà accetta i valori testuali true e false e non segue la sintassi degli attributi booleani HTML: non scrivere il nome dell’attributo senza un valore. È supportata sui ruoli dialog e alertdialog, non in modo globale su elementi arbitrari.
aria-modal="true" comunica la semantica alle tecnologie assistive, che possono limitare la navigazione ai contenuti della finestra di dialogo. Non apre una finestra, non blocca i clic sullo sfondo e non sposta né trattiene il focus. Imposta questo valore solo quando l’interfaccia impedisce davvero a tutti di interagire con i contenuti esterni alla finestra e lo sfondo è visivamente oscurato o coperto.
All’apertura, sposta il focus all’interno della finestra di dialogo e mantieni al suo interno la sequenza di Tab e Shift+Tab. Prevedi un pulsante di chiusura all’interno e supporta Escape; alla chiusura, in genere ripristina il focus sull’elemento che l’ha attivata. Assegna alla finestra un nome accessibile, per esempio tramite aria-labelledby che faccia riferimento all’intestazione visibile. Tutti i controlli necessari per usarla devono esserne discendenti.
L’esempio usa una finestra di dialogo nativa aperta con showModal(), invece di ricreare manualmente il comportamento modale. In questo caso aria-modal="true" è ridondante, perché la modalità nativa è già esposta alle tecnologie assistive; è mantenuto per mostrare la sintassi. Aggiungere il solo attributo a un normale contenitore non fornisce questo comportamento. Verifica separatamente il funzionamento da tastiera e la semantica nell’albero di accessibilità.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-modal example</title>
<style>
dialog::backdrop { background: rgb(0 0 0 / 50%); }
</style>
<button id="open" type="button">Open dialog</button>
<dialog id="notice" aria-modal="true" aria-labelledby="heading">
<h2 id="heading">Notice</h2>
<p>This dialog blocks interaction with the page.</p>
<button id="close" type="button" autofocus>Close</button>
</dialog>
<script>
const opener = document.getElementById('open');
const notice = document.getElementById('notice');
const closer = document.getElementById('close');
opener.addEventListener('click', () => notice.showModal());
closer.addEventListener('click', () => notice.close());
notice.addEventListener('close', () => opener.focus());
</script>
</html>Risultato
Initially, only Open dialog is visible. Activating it opens Notice, dims the background, and focuses Close. Background controls cannot be activated while the dialog is open. Close or Escape dismisses the dialog and returns focus to Open dialog.
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.