Interfacce utente di qualità: componenti, stato, accessibilità e stati vuoti curati

Come costruire una interfaccia che non sembra generata: architettura dei componenti, gestione dello stato, coerenza con il design system, accessibilità, responsività, caricamenti e stati di errore.

Metodologiametodologiafrontendaccessibilitàingegneria del software19 novembre 2026 · 3 min di lettura

Un'interfaccia "generata" si riconosce da lontano: spaziature incoerenti, colori scelti a caso, un pulsante che non si raggiunge con la tastiera, una lista vuota che mostra una pagina bianca. Costruire una interfaccia di qualità non richiede più tempo, richiede di decidere in anticipo poche regole e di rispettarle.

Architettura dei componenti

Ogni componente ha una responsabilità. I file che cambiano insieme stanno insieme (il componente, il suo stile, i suoi test). Componenti piccoli e componibili battono quelli giganteschi con decine di opzioni. Si separa ciò che mostra (presentazione) da ciò che decide e recupera dati (logica).

Gestione dello stato

Lo stato va dove serve, non più in alto. Prima lo stato locale al componente; se serve a due, il genitore comune; solo per ciò che serve a mezza applicazione, uno stato condiviso. Uno stato globale per tutto rende ogni modifica un rischio.

Coerenza con il design system

Se esiste un sistema di progettazione, lo si usa: componenti, spaziature, tipografia, colori. Se non esiste, si definiscono pochi valori e si riusano. Qui si vedono i segni dell'interfaccia "generata": margini diversi in ogni blocco, tre tonalità di grigio quasi uguali, effetti decorativi senza motivo. Spaziature su una scala fissa; tipografia con pochi livelli e gerarchia chiara; colore con un significato (azione, errore, stato) e contrasto sufficiente.

Accessibilità

Il riferimento è il livello AA delle linee guida WCAG 2.1. In pratica:

  • Tastiera. Tutto ciò che si può fare con il mouse si fa con la tastiera, con un ordine di tabulazione sensato e un focus visibile.
  • Etichette. Ogni elemento interattivo ha un nome comprensibile anche per un lettore di schermo (etichette e attributi ARIA dove l'HTML non basta).
  • Gestione del focus. Quando si apre una finestra di dialogo il focus entra, quando si chiude torna al punto di partenza.
  • Stati vuoti e di errore con significato. Una lista vuota spiega perché lo è e che cosa fare; un errore dice che cosa è andato storto e come rimediare, non solo "errore".

Responsività

Si parte dal formato più piccolo e si estende. Si prova a più larghezze reali, non solo ridimensionando la finestra. I tocchi hanno aree abbastanza grandi; il contenuto non esce dallo schermo.

Caricamenti e transizioni

Ogni operazione che richiede tempo ha uno stato visibile (caricamento, avanzamento) e uno di fallimento. Le transizioni aiutano a capire che cosa è cambiato; non decorano.

Le scuse più comuni

ScusaRealtà
"L'accessibilità la facciamo dopo"Rifare la struttura dopo costa molto più che farla bene.
"Funziona sul mio schermo"Su un telefono, o con la tastiera, forse no.
"Lo stato vuoto lo vedono in pochi"Lo vede chiunque al primo accesso.

Un esempio

Una tabella di ordini: senza dati mostra una tabella vuota con le sole intestazioni. Con cura: "Nessun ordine ancora. Quando un cliente ne effettua uno, lo vedrai qui" e un pulsante per creare un ordine di prova. In caricamento, righe scheletro; in errore, "Non riesco a caricare gli ordini. Riprova" con il pulsante. Tutto con la tastiera e un nome leggibile per ogni controllo.

Quando usarlo

Quando si costruiscono o si modificano interfacce rivolte agli utenti, componenti, layout o gestione dello stato, e quando il risultato deve avere la qualità di un prodotto, non quella di un prototipo.

Questo metodo deriva dalla famiglia di skill open source agent-skills di Addy Osmani (licenza MIT), riscritta e adattata.

Questo articolo è una skill di OIAR

Quello che hai letto è il contenuto di una skill del catalogo OIAR, scritto per le persone. Una conoscenza come questa ma più ricca e profonda, scritta per gli agenti, guida le interviste, l'analisi e il report dentro la piattaforma. Le skill si usano in OIAR: per provarla su un tuo progetto serve un account.

frontend-ui-engineeringMetodo per costruire interfacce utente di qualità: componenti piccoli, stato dove serve, coerenza con il design system, accessibilità AA, responsività, stati di caricamento, vuoto ed errore. Usarla quando si crea o modifica un'interfaccia, un componente o un layout.