Fondamenti visivi e Token
Contratto pubblico per l'uso dei colori del brand Qokit, dei font, degli spazi, degli angoli arrotondati e dei token semantici.
Fondamenti visivi e Token
L'interfaccia della piattaforma Qokit utilizza un sistema di blu trasparente, professionale e sobrio. Gli sviluppatori dovrebbero adattare il tema tramite i token semantici, senza copiare valori di colore, ombre, angoli arrotondati o font nei componenti aziendali.
Ruoli principali
| Ruolo | Token consigliato | Uso |
|---|---|---|
| Sfondo pagina | --bg, --page-background | Colore di base della pagina e spazio complessivo |
| Superficie contenuto | --panel, --card-surface | Pannello, schede di contenuto |
| Superficie controllo | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Pulsanti, ricerca, campi di input e stati di interazione |
| Superficie overlay | --dropdown-surface, --dialog-surface | Menu, Popover, Dialog |
| Bordi | --panel-border, --control-border, --input-border | Separazione e bordi di stato |
| Testo | --text, --muted | Informazioni primarie e secondarie |
| Interazione brand | --accent, --link-color, --link-hover-color | Link, selezione ed enfasi leggera |
| Focus tastiera | --focus-ring | Stato focus-visible |
| Angoli arrotondati | --card-radius, --button-radius, --button-pill-radius | Forma delle Card e dei controlli |
| Dimensione font pulsanti | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Tipografia dimensionale condivisa per i pulsanti |
| Font | --font-heading, --font-body | Titoli e corpo/testo/controlli |
Tipografia
- Space Grotesk è utilizzato per i titoli del brand, i titoli di pagina e i numeri chiave;
- Manrope è utilizzato per il corpo del testo, i pulsanti, i moduli, le tabelle e l'area di lavoro;
- L'area di lavoro mantiene un layout compatto, senza titoli grandi come nelle pagine marketing;
- Il cinese non aumenta la spaziatura delle lettere in stile inglese, e le traduzioni lunghe non comprimono le azioni adiacenti.
Spaziature e dimensioni
- Utilizzare un ritmo di 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- L'altezza minima di clic per i controlli compatti non deve essere inferiore a 40px;
- L'altezza predefinita delle azioni è 44px, e le azioni principali su mobile non devono essere inferiori a 44px;
- I pulsanti condivisi utilizzano rispettivamente 14px, 15px, 16px di testo per
sm,md,lg, senza ereditare la dimensione del font del contenitore; - La larghezza del contenuto della piattaforma solitamente non supera 1160px, mentre quella dei siti generati solitamente non supera 1120px.
Regole del tema
- I temi chiaro e scuro devono riutilizzare gli stessi token semantici;
- I Dialog ordinari utilizzano
--dialog-surfaceper fornire una leggera sfumatura verticale, con angoli arrotondati condivisi con le Card--card-radius; --accentè utilizzato per link, focus, selezione e avanzamento, non per riempire ampie aree;- I controlli ordinari non selezionati usano la superficie neutra
--control-surface-hoveral passaggio del mouse; gli stati premuto, selezionato, corrente ed espanso usano la superficie di marca--control-surface-active.focus-visibleaggiunge--focus-ringsulla superficie neutra; gli input focalizzati o attivi mantengono i propri Token di stato; - I colori di stato esprimono solo successo, avvertimento e pericolo;
- I siti generati possono sovrascrivere le variabili del tema, ma devono mantenere il contrasto del corpo del testo e una gerarchia CTA chiara.