Responsive e Accessibilità
Requisiti di tastiera, focus, touch e mobile per i componenti Qokit e le estensioni della piattaforma.
Responsive e Accessibilità
Tutti i componenti pubblici e le interfacce di integrazione devono supportare contemporaneamente tastiera, touch e lingue con lunghezze diverse. Su mobile, il layout deve essere riorganizzato in base alle attività, non semplicemente rimpicciolito rispetto all'interfaccia desktop.
Tastiera e Focus
- Utilizzare Button, Link, Label, Heading, Table e List semantici;
- Tutte le interazioni devono essere raggiungibili e operabili tramite tastiera;
- Utilizzare
focus-visiblee--focus-ringcondivisi; non rimuovere il feedback del focus; - IconButton deve fornire un
aria-labellocalizzato; - Tooltip può solo fornire informazioni supplementari, non sostituire il nome accessibile.
Touch e Stati
- L'area di clic dei controlli compatti non deve essere inferiore a 40px, e le operazioni principali su mobile non devono essere inferiori a 44px;
- Hover non deve essere l'unico indicatore;
- Gli stati Disabled, Loading, Empty ed Error devono avere un feedback comprensibile;
- Le operazioni pericolose utilizzano testo esplicito e un flusso di conferma, non fanno affidamento esclusivamente sul rosso.
Layout Responsive
- Le interfacce a più colonne sotto la dimensione tablet passano a colonna singola, collassate o a cassetto in base alla priorità delle attività;
- Header, Toolbar, tabelle, riquadri di anteprima e gruppi di azioni mantengono dimensioni stabili;
- Etichette lunghe, testi tradotti e contenuti utente non devono sovrapporsi alle azioni adiacenti;
- Sia su desktop che su mobile, verificare i contenuti reali, l'ordine del focus e l'overflow orizzontale.
Contenuti e Contrasto
- Testo principale, descrizioni e CTA devono rimanere leggibili su sfondi light, dark e tematici;
- Le immagini forniscono testo alternativo coerente con il contenuto;
- Gli stati non devono essere espressi solo attraverso il colore;
- Le animazioni rispettano
prefers-reduced-motion; i flussi critici non dipendono dalle animazioni per il completamento.