Il catalogo non reinventa Mantine: dice quale componente si usa per cosa, con quale variante e quali misure. Dove Mantine offre cinque varianti, noi ne usiamo due.
9.1Si aggiunge qualcosa al sistema solo se Mantine non ce l'ha. Oggi sono cinque: tre componenti — empty state, intestazione di pagina, footer di salvataggio — e due hook, il preset della tabella e la soglia del telefono.nucleo
9.2Le varianti ammesse sono un sottoinsieme. Quelle non elencate qui non si usano, anche se la libreria le offre.nucleo
9.3Nessun componente dichiara un colore: cita ruoli. Vale anche per i componenti nostri.nucleo
9.4Le misure stanno nel tema, non ripetute sul componente. Se una misura ricorre, è un defaultProp.struttura
Bottoni
Quattro varianti, e una sola primaria per area
Primaria piena, secondaria a bordo, terziaria nuda, distruttiva a bordo rosso. Non esiste una distruttiva piena.
Stati e misure
Tre misure: 30 in toolbar e tabella, 36 predefinita, 42 sul telefono e nelle azioni isolate.
9.5Una sola azione primaria per area di decisione. Due pieni accanto non dicono quale premere.nucleo
9.6L'etichetta è un verbo all'imperativo e dice cosa fa, non cosa sta per fare.nucleo
9.7L'icona sta a sinistra del testo, sempre, tranne il chevron che apre qualcosa.struttura
9.8Un bottone che lavora resta della sua larghezza e cambia etichetta, non salta.struttura
9.9Nessuna pillola a raggio pieno, per nessuna misura.nucleo
Comandi a icona
Duplica commessa
34px in toolbar, 30px nelle azioni di riga, 48px sul telefono. Tooltip obbligatorio su ogni icona senza parola.
9.10Un'icona senza parola esiste solo nelle azioni di riga, in toolbar e nella shell. Altrove, icona più etichetta.nucleo
9.11Ogni comando a icona ha tooltip e aria-label. Senza, non è raggiungibile né comprensibile.nucleo
Tag, badge, chip
Tre oggetti che si somigliano e non sono la stessa cosa
TagIn scadenzaCompletataBozza
Badge18399+
ChipTutteIn scadenzaBloccate
Tag dice uno stato del dato e non si preme. Badge è una quantità. Chip è un filtro e si preme.
9.12Il tag è sempre a tratto con la parola scritta. Mai pieno, mai un pallino da solo.nucleo
9.13Il tag non si preme. Se è premibile è un chip, e allora ha l'altezza di un comando (32px).struttura
9.14Il badge porta un numero, non un punto. Rosso pieno solo per le notifiche non lette; altrove neutro.struttura
9.15Gli stati di dominio hanno un catalogo per prodotto — parola e colore dichiarati una volta, non scelti per schermata.nucleo
Card e pannelli
Commesse aperte
247
18 in scadenza
Valore in corso
1,28 M€
+4% sul mese
Bordo in tinta — variante
Il bordo può essere neutro o nella dominante molto diluita. Una scelta per prodotto, non per schermata.
Fondo bianco, bordo di 1px e --elev-card. Il bordo è --card-line: neutro oppure nella dominante molto diluita, a scelta del prodotto.
9.16La card ha bordo, ombra di appoggio e fondo bianco. Tre segni deboli che lavorano insieme: il bordo tiene la forma dove l'ombra non c'è — stampa, ombre ridotte, tema scuro.struttura
9.17Il bordo è --card-line: neutro o in tinta, e la scelta è una per prodotto. Non si alterna fra schermate.identità
9.18Il bordo in tinta è la dominante molto diluita, non satura: deve leggersi come un filetto, non come una cornice colorata.identità
Strati sovrapposti
Commessa C-4821
Modifica
Duplica
Esporta
Elimina
Elimini la commessa C-4821?
Le tre lavorazioni collegate restano, senza commessa. L'operazione non si annulla.
Dropdown, popover, modale, drawer, bottom sheet: ombra più bordo, sempre entrambi. Nella modale distruttiva il focus apre su Annulla.
Strato
Quando
Misure
Dropdown / Menu
Scelte e azioni secondarie
Voce 36px · raggio 10 · --elev-overlay
Popover
Pannello colonne, scelte multiple
Max 360px di larghezza
Modale
Conferme e form brevi che bloccano
480 / 640 / 840 · raggio 14 · --elev-modal
Drawer
Dettaglio o form senza lasciare l'elenco
420 / 640 · da destra
Bottom sheet
Solo telefono: filtri, scelte
Raggio 14 in alto, maniglia
Tooltip
Nome di un'icona, testo troncato
13px, fondo --ink-900, ritardo 400ms
9.19Ogni strato che galleggia ha ombra e bordo. Con le ombre ridotte dal sistema resta il bordo a dire dove finisce.nucleo
9.20Uno strato alla volta. Una modale non ne apre un'altra: se serve un secondo passo, è uno step dentro la stessa.nucleo
9.21Esc chiude sempre, e senza chiedere se non ci sono modifiche.nucleo
9.22Il tooltip non porta informazione che serve a decidere. Sul tocco non esiste.nucleo
9.23La voce distruttiva del menu sta in fondo, dopo un separatore.struttura
Navigazione e indicatori
PanoramicaAttivitàDocumentiStorico
123…14MB
Tab a filetto, paginazione a gruppo unito, avatar quadrato a raggio 6, barra di avanzamento 6px, skeleton nella forma del contenuto atteso.
9.24Le tab stanno nell'indirizzo e non superano le cinque. Oltre, è una sotto-navigazione.nucleo
9.25L'avatar è un quadrato a raggio 6 con le iniziali, non un cerchio. Immagine solo se c'è davvero.struttura
9.26La barra di avanzamento è per il determinato. Se non si sa quanto manca, si usa uno skeleton.struttura
9.27Nessuna barra colorata a sinistra, su un alert, su una card o su una riga. Il bordo sta su quattro lati e il colore lo porta solo l'icona di stato: una barra laterale sbilancia il blocco e mette il colore dove non porta informazione. Non si confonde col filetto della riga selezionata (11.9), che è sottile e non colora un contenitore.nucleo
9.28Il colore sul testo si ferma a due parole. Un tag si scorre: lì il colore sulle parole aiuta il riconoscimento. Un avviso si legge: lì il colore affatica e non aggiunge niente, perché il significato è già nella frase. Tag e contrassegni portano il colore sul testo; avvisi, messaggi d'errore e testi di aiuto lo tengono su bordo e icona, e le parole restano in inchiostro neutro.nucleo
Cosa non esiste nel sistema
Accordion nei form
Nascondere campi obbligatori li fa dimenticare. Nei contenuti lunghi va bene.
Carousel
Contenuto che si nasconde da solo e si naviga a tentoni.
Pillole a raggio pieno
Nessun elemento, nessuna misura.
Bottone distruttivo pieno
Il rosso pieno chiama il clic. La distruttiva è a bordo.
Varianti light e gradient
In Mantine 9 light è un fondo pieno: contraddice il tratto.