Skip to Content
Design

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-visible e --focus-ring condivisi; non rimuovere il feedback del focus;
  • IconButton deve fornire un aria-label localizzato;
  • 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.

In questa pagina