Attributi obbligatori del ruolo ARIA

Ogni ruolo ha un contratto fisso: alcuni stati e proprietà sono obbligatori, altri sono consigliati per un supporto reale delle tecnologie assistive, e molti ruoli richiedono anche un nome accessibile. Indovinare tali attributi a memoria è una causa frequente di fallimenti in audit — manca aria-checked su un ruolo checkbox, si dimentica aria-controls su un combobox, oppure si pubblica un landmark region senza etichetta. Questa capacità accetta un solo nome di ruolo ARIA, normalizza maiuscole e prefissi comuni e restituisce un pacchetto deterministico: attributi obbligatori, attributi consigliati, categoria, superclasse, requisiti di nome e una breve descrizione basata su WAI-ARIA 1.2.

Perché indovinare gli attributi ARIA fa fallire gli audit

ARIA definisce decine di ruoli perché i controlli personalizzati possano esprimere lo stesso significato degli elementi HTML nativi. Ogni ruolo ha un contratto fisso: alcuni stati e proprietà sono obbligatori, altri sono consigliati per un supporto reale delle tecnologie assistive e molti ruoli richiedono anche un nome accessibile. Ricordare tutto a memoria è una causa frequente di audit falliti: un ruolo checkbox senza aria-checked, un combobox senza aria-controls e aria-expanded, uno slider senza aria-valuenow o un landmark region pubblicato senza etichetta. Ognuno di questi casi non supera i controlli automatici e lascia a chi usa un lettore di schermo un controllo che non dice cosa sia né in che stato si trovi.

Cosa le dice una sola consultazione

Scriva il nome di un ruolo, con maiuscole o minuscole e con o senza prefisso; perfino «column header» e «columnheader» portano allo stesso ruolo. Riceve gli attributi obbligatori e consigliati, la categoria, il ruolo più generale da cui deriva, se serve un nome accessibile e come può essere calcolato, più una breve descrizione basata su WAI-ARIA 1.2. Per checkbox significa aria-checked come unico obbligo, 8 attributi consigliati e la descrizione di un controllo con tre valori possibili: vero, falso o misto. Uno scrollbar torna con quattro proprietà obbligatorie: aria-controls, aria-valuenow, aria-valuemin e aria-valuemax. Compaiono note quando un requisito dipende dal contesto, come per un separatore che riceve il focus e ha bisogno dei valori, mentre uno decorativo no.

Cosa significano attributi ARIA obbligatori e consigliati

Nella specifica WAI-ARIA ogni ruolo concreto elenca Required States and Properties — attributi che l'autore deve fornire affinché il ruolo sia valido — e Supported States and Properties che le tecnologie assistive si aspettano quando il pattern richiede uno stato più ricco. Gli attributi obbligatori non sono negoziabili: un ruolo checkbox senza aria-checked, uno slider senza aria-valuenow o un combobox senza aria-controls e aria-expanded falliscono i controlli automatici e confondono i lettori di schermo.

La risposta indica anche se il ruolo richiede un nome accessibile e come tale nome può essere calcolato (attributi dell'autore, contenuto dell'elemento o vietato). Ruoli concreti deprecati come directory restano interrogabili ma sono segnalati affinché gli strumenti di migrazione avvisino senza bloccare la ricerca.