Foglietto di riferimento dei valori dei ruoli ARIA: ruoli landmark, di documento, widget e live region con scopo e casi d'uso.
I ruoli ARIA dichiarano cosa fa un elemento. I ruoli landmark mappano le regioni della pagina. I ruoli di documento strutturano i contenuti. I ruoli widget segnalano i controlli interattivi. I ruoli live region annunciano gli aggiornamenti dinamici.
Tabella di riferimento · 77 voci
Ruoli ARIAExplained
77 of 77 rows
Landmark
Identifica l'intestazione del sito in cima alla pagina.
Logo del brand, claim principale, testata in cima alla pagina.
Raggruppa una raccolta di collegamenti di navigazione.
Menu principali, breadcrumb, navigazione interna alla pagina.
Contrassegna il contenuto dominante del documento.
Il corpo principale unico della pagina.
Contrassegna contenuto di supporto separato dal main.
Barre laterali, collegamenti correlati, callout.
Raggruppa i metadati del piè di pagina sul documento padre.
Righe di copyright, collegamenti sulla privacy, piè di pagina legale.
Contrassegna una regione che contiene un modulo di ricerca.
Ricerca nel sito, moduli di filtro, caselle di ricerca.
Contrassegna una sezione della pagina con un nome, percepibile.
Sezioni personalizzate con un nome accessibile.
Contrassegna una regione che contiene un insieme di campi.
Moduli di ricerca con nome, pannelli di filtro, sezioni di sondaggi.
Contrassegna una regione che si comporta come un'applicazione.
Editor a pagina intera, mappe, superfici di gioco.
Documento
Contrassegna una composizione autonoma.
Articoli di blog, notizie, schede prodotto.
Contrassegna un titolo per una sezione di contenuto.
Titoli di sezione quando gli h1-h6 nativi non si applicano.
Raggruppa un elenco di elementi correlati.
Elenchi puntati o numerati personalizzati.
Contrassegna un singolo elemento dentro un elenco.
Una riga di un elenco personalizzato.
Raggruppa un insieme di controlli di modulo correlati.
Fieldset di moduli, gruppi di radio, input correlati.
Contrassegna contenuto grafico abbinato a una didascalia.
Immagini, diagrammi, grafici con un'etichetta.
Contrassegna dati disposti in righe e colonne.
Dati tabellari costruiti con elementi personalizzati.
Contrassegna un'etichetta visibile per tabella, griglia o figura.
Titoli sopra le tabelle dati, etichette delle figure.
Raggruppa un insieme di righe correlate in una tabella.
Le fasce di intestazione, corpo e piè di tabella.
Contrassegna una riga di celle in una tabella o griglia.
La riga di un record di una tabella personalizzata.
Contrassegna una cella di intestazione per una colonna.
Le etichette in cima a una tabella dati.
Contrassegna una cella di intestazione per una riga.
L'etichetta iniziale di ogni riga della tabella.
Contrassegna una cella di dati dentro una riga.
I singoli valori di una riga di tabella personalizzata.
Contrassegna una parola o frase in via di definizione.
Voci di dizionario, termini di liste di definizione.
Contrassegna il significato del termine precedente.
La descrizione sotto un termine definito.
Contrassegna una nota posta accanto al contenuto principale.
Suggerimenti, aside, note in stile nota a piè di pagina.
Contrassegna un elenco di riferimenti ai membri del gruppo.
Sommari e indici di collegamenti (deprecato in ARIA 1.2).
Contrassegna un elenco scorrevole di sezioni di articoli.
Flussi a scorrimento infinito che caricano altro contenuto.
Contrassegna contenuto scritto in notazione matematica.
Formule renderizzate da LaTeX o MathML.
Contrassegna un valore scalare in un intervallo noto.
Barre di uso del disco, punteggi, indicatori di intensità.
Contrassegna un momento specifico o una durata.
Timestamp, date di eventi, tempi trascorsi.
Contrassegna un blocco di testo in prosa.
Blocchi di testo non scritti come elementi p nativi.
Contrassegna una citazione presa da un'altra fonte.
Citazioni in evidenza e stralci citati.
Contrassegna un frammento di codice informatico.
Snippet inline e nomi di comandi nella prosa.
Contrassegna testo che porta enfasi.
Parole enfatizzate dentro una frase.
Contrassegna testo con forte importanza.
Avvisi, frasi chiave, etichette da leggere assolutamente.
Contrassegna testo reso sotto la linea di base.
Formule chimiche come H2O.
Contrassegna testo reso sopra la linea di base.
Riferimenti a note ed esponenti.
Contrassegna un contenitore semplice senza significato speciale.
Wrapper di layout e agganci di stile.
Rimuove la semantica da un elemento.
Immagini decorative, tabelle di layout, elementi divisori.
Contrassegna un elemento come singola immagine.
Sprite di icone, gruppi SVG, grafica disegnata con CSS.
Widget
Contrassegna un controllo cliccabile che attiva un'azione.
Pulsanti personalizzati, pulsanti icona, trigger di azione.
Contrassegna un collegamento a un'altra risorsa o posizione.
Ancore personalizzate e collegamenti di rotta nell'app.
Contrassegna un interruttore per una singola opzione.
Checkbox personalizzate, interruttori di accettazione dei termini.
Contrassegna una scelta in un gruppo a esclusione reciproca.
Radio personalizzate dentro un radiogroup.
Contrassegna un interruttore binario on/off.
Interruttori di tema, muto e impostazioni.
Raggruppa le etichette di un insieme di schede.
La striscia di schede di un pannello a schede.
Contrassegna una singola etichetta dentro una tablist.
Una singola scheda che mostra un pannello.
Contrassegna il pannello dei contenuti di una scheda.
Il corpo mostrato quando la sua scheda è attiva.
Contrassegna una finestra in overlay sopra la pagina.
Modali, drawer, popover che catturano il focus.
Contrassegna una finestra di dialogo che richiede una risposta.
Conferme di eliminazione, avvisi di modifiche non salvate.
Contrassegna un input con un popup di scelte.
Autocompletamento, ricerca-selezione, liste typeahead.
Contrassegna un controllo che imposta un valore in un intervallo.
Volume, prezzo, opacità, input di intervallo.
Contrassegna un elenco di scelte offerte all'utente.
Menu a discesa, menu contestuali, tavolozze di strumenti.
Contrassegna una singola opzione dentro un menu.
Una riga o una voce di un menu a discesa.
Contrassegna un campo per input di testo libero.
Input personalizzati, campi di ricerca, caselle di commento.
Contrassegna un elenco gerarchico di elementi.
Esplora file, menu annidati, organigrammi.
Contrassegna un elenco di opzioni selezionabili.
Selettori personalizzati per una o molte scelte.
Contrassegna una singola scelta dentro una listbox.
Una voce selezionabile di una listbox personalizzata.
Raggruppa un insieme di scelte a esclusione reciproca.
Set di radio personalizzati, selettori di piani, risposte a scala.
Contrassegna un widget di righe e colonne di celle.
Layout tipo foglio di calcolo, viste mensili del calendario.
Contrassegna una griglia le cui righe si espandono e comprimono.
Tabelle dati annidate, tabelle di thread di posta.
Contrassegna un'opzione espandibile dentro un albero.
Un nodo file o cartella in un esplora file.
Contrassegna un popup che suggerisce un controllo.
Suggerimenti al passaggio, consigli al focus per pulsanti icona.
Contrassegna un elemento che mostra l'avanzamento di un'attività.
Barre di caricamento e indicatori di caricamento.
Contrassegna un controllo che scorre una vista di contenuto.
Maniglie di scorrimento personalizzate per pannelli e caroselli.
Contrassegna un controllo che cambia un valore a passi.
Selettori di quantità, stepper numerici.
Contrassegna un campo di testo per inserire termini di ricerca.
Barre di ricerca personalizzate e campi di filtro.
Contrassegna un gruppo di controlli usati di frequente.
Barre di formattazione, righe di azione sopra gli editor.
Contrassegna una riga di trigger di menu persistenti.
Strisce di menu File e Modifica in stile app.
Contrassegna un'opzione di menu che si attiva e disattiva.
Interruttori di opzioni di vista dentro un menu a discesa.
Contrassegna una scelta esclusiva dentro un menu.
Scelte di ordinamento e tema in un menu.
Contrassegna un divisore tra gruppi di contenuto.
Divisori di menu, separatori di pannelli trascinabili.
Live region
Annuncia un messaggio importante e urgente.
Errori di modulo, avvisi urgenti che richiedono attenzione.
Annuncia un aggiornamento informativo senza interrompere.
Conferma di salvataggio, avanzamento, risultati soft.
Annuncia nuove voci in un flusso cronologico.
Trascrizioni di chat, log di eventi, feed di attività.
Annuncia contenuto testuale scorrevole o in movimento.
Ticker, barre di notizie scorrevoli, banner rotanti.
Annuncia un timer o un conto alla rovescia in diretta.
Scadenze di sessione, conti alla rovescia, cronometri.