9

Componenti

Nucleo comuneUI Components

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.
StratoQuandoMisure
Dropdown / MenuScelte e azioni secondarieVoce 36px · raggio 10 · --elev-overlay
PopoverPannello colonne, scelte multipleMax 360px di larghezza
ModaleConferme e form brevi che bloccano480 / 640 / 840 · raggio 14 · --elev-modal
DrawerDettaglio o form senza lasciare l'elenco420 / 640 · da destra
Bottom sheetSolo telefono: filtri, scelteRaggio 14 in alto, maniglia
TooltipNome di un'icona, testo troncato13px, 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…14 MB
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.
Tabs verticali
Per quello c'è la sotto-navigazione di sezione.

La mappa completa

ServeComponenteVariante e misure
AzioneButtonfilled · default · subtle · outline color="danger". size xs/sm/md
Azione a iconaActionIconvariant="subtle", con Tooltip e aria-label
Stato del datoBadgevariant="outline", radius="sm"
QuantitàIndicatorCon label, mai processing senza numero
Filtro premibileChip / Chip.Groupvariant="outline", altezza 32
ContenitoreCard / Paperradius="md", withBorder solo se galleggia
MenuMenushadow="md", withBorder, distruttiva in fondo
ModaleModalradius="lg", centered, trapFocus sempre attivo
Confermamodals.openConfirmModallabels sempre riscritte, mai i predefiniti
Pannello lateraleDrawerposition="right"; "bottom" su telefono
SuggerimentoTooltipopenDelay={400}, withArrow no
SchedeTabsvariant="outline", value dall'indirizzo
AvanzamentoProgressAltezza 6, radius="xl" sulla sola barra
AttesaSkeletonNella forma del contenuto. Loader solo dentro un bottone
PaginazionePaginationradius="sm", accanto al conteggio
UtenteAvatarradius="sm", 30px, iniziali
Elenco in eccessoOverflowListNuovo in v9: raccoglie in “+N” invece di andare a capo
Soglia del telefononostrouseIsMobile() — la chiamano i quattro componenti della sezione 15
Empty statenostroQuattro varianti (14)
Intestazione di paginanostroBreadcrumb, titolo, sottotitolo, azioni (6)
Footer di salvataggionostroTre stati (7)
TabellauseMaeTablePreset di mantine-datatable (11)
RimandiCampi e form in 12 · tabella in 11 · alert, notifiche ed empty state in 14 · sidebar, header e tab in 13.
Da fareManca la resa dei componenti in tema scuro: le regole ci sono in 5, gli specimen no.