15
Comportamento responsivo
Nucleo comuneResponsive
Con Capacitor le app native sono la stessa applicazione: non c'è un design system per il telefono. Sotto i 768px si sostituiscono quattro componenti — sono questi, e sono tutti.
L'usoSul telefono si consulta e si approva nove volte su dieci, ma si inserisce anche. La proporzione cambia da prodotto a prodotto, e per questo si dichiara all'avvio: un applicativo in cui l'inserimento sul campo è il compito principale progetta prima quello, e le regole di questa sezione cambiano peso.
Le quattro trasformazioni
1 · La shell
La sidebar diventa un pannello sovrapposto che entra da sinistra; compare la barra in fondo; l'azione primaria di un dettaglio scende in una barra propria, dove arriva il pollice.
2 · La tabella
Diventa un elenco di card e non scorre in orizzontale. Ogni riga è una card con i quattro campi che contano.
3 · La barra dei filtri
La toolbar non entra: resta la ricerca, il resto si apre dal basso in un bottom sheet e si applica in blocco.
4 · Organizzazione e utente
Il selettore dell'organizzazione e il menu utente lasciano l'header e scendono in fondo al pannello di navigazione.
Elenco e filtri
Elenco
Commesse
Filtri 2In scadenzaMilano
C-4821Comune di Rho
128.450,00 €28/06/2026
In scadenza
C-4820Immobiliare Sesto
42.100,00 €14/06/2026
Completata
C-4817Tecnoimpianti
9.980,50 €—
Bloccata
CommesseAgendaDocumentiProfilo
Filtri · bottom sheet
Filtri
In scadenza
Completate
Bloccate
Sede: Milano
AzzeraApplica · 18
La card porta quattro dati: identificativo e descrizione, due valori, lo stato. Il bottom sheet applica in blocco e dichiara quanti risultati restano.
15.1Su telefono le tabelle non scorrono in orizzontale: diventano elenchi di card. Unica eccezione, una tabella di soli numeri già stretta.nucleo
15.2Nella card entrano quattro dati: identificativo e descrizione in cima, due valori sotto, lo stato su riga propria. Tutto il resto è nel dettaglio.struttura
15.3Niente si tronca a metà parola. Se un campo non entra, non entra nella card.struttura
15.4I filtri si applicano in blocco, con il conteggio dei risultati sul pulsante. Non si chiude e riapre il sheet per ogni filtro.struttura
15.5I filtri attivi restano visibili come chip anche a sheet chiuso: un filtro invisibile mostra dati parziali senza dirlo.nucleo
Navigazione
15.6La barra in fondo esiste solo nelle pagine di primo livello. In un dettaglio sparisce: lì si torna indietro, non si naviga.struttura
15.7Barra e pannello non sono alternative: la barra porta le tre-cinque destinazioni quotidiane, il pannello tutte le altre.struttura
15.8Da tre a cinque voci nella barra, sempre con etichetta. Un'icona senza parola su una destinazione è un indovinello.struttura
15.9Il breadcrumb sparisce e lo sostituisce la freccia indietro nella barra in alto.struttura
15.10Il titolo della pagina sale nella barra in alto a 17px, e il sottotitolo cade.struttura
Misure per il tocco
| Elemento | Misura | Nota |
| Target toccabile | 48 × 48px | Il più grande fra i 44pt di Apple e i 48dp di Android. Anche quando l'icona ne occupa 18 |
| Distanza fra target | 8px | Sotto, si preme quello sbagliato |
| Corpo del testo | 15px, pavimento 13px | La scala non cambia col dispositivo |
| Campi di testo | 16px | Sotto i 16px iOS ingrandisce la pagina al focus |
| Altezza dei campi | 48px | Target pieno, e lascia spazio all'errore sotto |
| Voce di menu | 48px | Nel pannello si scorre col pollice |
| Card di elenco | 99px · minimo 66px | Tre righe, niente troncato |
| Margine laterale | 12px | Più stretto della scrivania |
| Barra in fondo | 54px | Da tre a cinque voci |
NucleoIl target da 48px si ottiene col padding, non ingrandendo il segno. L'icona resta a 18-20px dentro un'area toccabile da 48.
Cosa non passa sul telefono
La selezione multipla
Agire su venti righe in blocco è un compito da scrivania. Su telefono si agisce su un record alla volta.
Il pannello delle colonne
Non ci sono colonne da nascondere: la card porta già i quattro campi che contano.
L'agenda settimanale
Cinque giorni per sei ore non stanno in 360px. Diventa vista giorno o elenco.
I form lunghi
Oltre dieci campi si passa a step. Un form da venticinque campi su telefono non si compila: si abbandona.
15.11Una funzione che non passa sul telefono non si mutila: si toglie, e la pagina dice dove si trova.nucleo
15.12Nessun contenuto è raggiungibile solo da scrivania senza che il telefono lo dichiari. Sparisce l'azione, non l'informazione.nucleo
Architettura
Non è mobile-first e non è mobile-only: è una sola base, orientata alla scrivania, che degrada. Il lavoro vero si fa seduti, e progettare prima per il caso minoritario costerebbe al caso principale.
| Strato | Cosa succede sul telefono |
| Rotte | Le stesse. Un collegamento aperto sul telefono porta dove porta sulla scrivania |
| Dati e logica | Gli stessi. Un hook, una interrogazione, un modello. Nessuna rotta o query duplicata |
| Permessi | Gli stessi. Non esiste un’azione che sul telefono si può fare e sulla scrivania no |
| Impaginazione | Si riadatta: le colonne si riducono di numero (6.7) |
| Componenti di presentazione | Quattro si sostituiscono, tutti gli altri si riadattano |
Cosa si riusa, cosa si rifà
Si riusa
Bottoni, campi, tag, alert, empty state, modali, tooltip, avanzamento, skeleton, formattatori. Cambiano le misure, non il componente.
Si sostituisce
I quattro delle trasformazioni qui sopra, e nessun altro: shell, tabella, barra dei filtri, organizzazione e utente.
Quattro componenti che sanno di essere su telefono. Non trenta pagine duplicate.
15.13Una sola base di codice, una sola rotta, un solo hook. Si biforca la resa, mai il dato né la navigazione.nucleo
15.14Sotto la soglia si cambia componente, non si nasconde con il CSS. display:none lascia nel DOM quello che lo screen reader legge e il browser calcola.nucleo
15.15I componenti che si sostituiscono sono i quattro delle trasformazioni, elencati in testa a questa sezione. Un quinto si aggiunge con una deroga, non perché una pagina sta stretta.struttura
15.16L’organizzazione e il menu utente scendono in fondo al pannello. Nell’header restano il titolo, le notifiche col badge numerico (13.7) e una sola azione: sono tre bersagli, ed è il massimo che entra accanto a un titolo.struttura
Inserimento sul telefono
È il dieci per cento dei casi, ma quando c’è va fatto bene: si scrive in piedi, con una mano, spesso con i guanti e con poca rete.
15.17Un campo per riga, sempre. Due campi affiancati su 360px non stanno, e il secondo diventa illeggibile.struttura
15.18La tastiera giusta al primo colpo: inputMode="numeric" su quantità e codici, decimal sugli importi, email, tel. Far cambiare tastiera a mano è un errore di specifica.nucleo
15.19Il campo attivo non finisce sotto la tastiera, e il footer di salvataggio si nasconde quando la tastiera è aperta.nucleo
15.20Oltre dieci campi si passa a step, con il salvataggio a ogni passo: un form lungo su telefono non si compila, si abbandona.struttura
15.21Il lavoro non si perde se la rete cade. Vale la 7.4: quello che l’utente ha scritto resta sul dispositivo finché non è salvato davvero, e l’esito si dichiara.nucleo
Da definire quando serviràFotocamera, firma, lettura di codici e posizione sono capacità native, non componenti di interfaccia: quando il primo prodotto le userà davvero si scriveranno qui, con l’uso vero sotto gli occhi. Scriverle adesso significherebbe inventarle.
Nell'implementazione
| Convenzione | Dove | Configurazione |
| Sidebar sovrapposta | AppShell | navbar={{ breakpoint: 'sm', collapsed: { mobile: true } }} |
| Bottom sheet | Drawer | position="bottom", radius="lg", size="auto" |
| Da tabella a card | useMediaQuery | Due rese dello stesso dato, non un CSS che nasconde colonne (15.14). Il dato arriva dallo stesso hook |
| La soglia in un posto solo | useIsMobile() | Involucro di useMediaQuery in shared/design/, spedito col pacchetto. Lo chiamano i quattro componenti, nessun altro: una soglia scritta a mano in una feature è un difetto |
| Tastiera | inputMode | Sul campo, non sul tipo: type="text" inputMode="decimal" evita gli spinner del browser |
| Barra in fondo | — | Componente condiviso, con env(safe-area-inset-bottom) |
| Tastiera che si apre | — | Capacitor Keyboard: la barra in fondo si nasconde, non copre il campo attivo |
| Hover | — | Non esiste sul tocco: nessuna informazione solo in hover, tooltip compreso |