Tutti i componenti visualizzatore supportano ruoli e attributi ARIA (Accessible Rich Internet Applications) per migliorare l’integrazione con tecnologie per l’accessibilità, come gli assistenti vocali.
Per impostazione predefinita, l’elemento visualizzatore di livello principale ha l’attributo ruolo region
e aria-label
impostato sul nome del visualizzatore. Puoi controllare l’etichetta con il simbolo di localizzazione Container.LABEL
.
I pulsanti hanno il ruolo button
e il testo descrittivo impostato con l'attributo aria-label
. Il valore dell'attributo aria-label
viene popolato dal valore del simbolo di localizzazione del pulsante. Quando un pulsante è disabilitato, l'attributo aria-disabled
viene impostato di conseguenza.
La vista principale ha il ruolo application
. Una breve descrizione della vista principale è fornita in aria-roledescription
, con il valore definito dal simbolo di localizzazione ROLE_DESCRIPTION
del componente di visualizzazione principale corrispondente. I suggerimenti per la navigazione degli utenti tramite tastiera vengono forniti utilizzando aria-describedby
, il testo per il suggerimento di utilizzo proviene dal simbolo di localizzazione USAGE_HINT
. Se una risorsa ha un’etichetta definita nel campo UserData , l’attributo aria-label
viene impostato con il valore di tale etichetta.
Le aree calde, le aree geografiche e le mappe immagine hanno il ruolo button
e il testo descrittivo impostato con l'attributo aria-label
, con il valore dell'etichetta di area sensibile o mappa immagine. Quando l'utente mette a fuoco punti o mappe immagine, i suggerimenti per la navigazione degli utenti tramite tastiera vengono forniti utilizzando aria-describedby
, con il testo per il suggerimento di utilizzo proveniente dal simbolo di localizzazione USAGE_HINT
.
Le miniature hanno il ruolo dialog
con l’attributo aria-label
controllato dal simbolo di localizzazione ThumbnailGridView.LABEL
. Le singole miniature hanno il ruolo button
. Se è selezionata una miniatura, l’attributo aria-selected
viene impostato su true
.
I componenti che visualizzano i campioni hanno il ruolo listbox
con l’attributo aria-label
impostato sul valore del simbolo di localizzazione LABEL
di quel componente. I singoli campioni hanno il ruolo option
con gli attributi aria-setsize
e aria-posinset
per descrivere la posizione del campione nel set. Se è selezionato un campione, l’attributo aria-selected
viene impostato su true
.
Gli elenchi a discesa sono attivati dai pulsanti con l’attributo aria-haspopup
aggiuntivo impostato su true
e l’attributo aria-controls
che fa riferimento all’elemento del pannello a discesa effettivo. Il pannello a discesa stesso ha il ruolo menu
con elementi secondari con il ruolo menuitem
. Per ogni voce di menu è specificato l'attributo aria-label
.
L’interfaccia utente di ricerca è raggruppata nell’elemento con il ruolo search
. Il campo di input della ricerca ha il ruolo searchbox
e fa riferimento all’etichetta informativa controllata dal simbolo di localizzazione SearchPanel.INFO_PROMPT
con l’attributo aria-describedby
.
Le finestre di dialogo modali hanno il ruolo dialog
. L'attributo aria-labelledby
fa riferimento all'elemento di intestazione della finestra di dialogo.