Bases visuelles et Tokens
Contrat public d'utilisation des couleurs de marque Qokit, des polices, des espacements, des coins arrondis et des Tokens sémantiques.
Bases visuelles et Tokens
L'interface de la plateforme Qokit utilise un système bleu clair, professionnel et sobre. Les développeurs doivent adapter le thème via les Tokens sémantiques et ne pas dupliquer les valeurs de couleur, les ombres, les coins arrondis ou les polices dans les composants métier.
Rôles principaux
| Rôle | Token recommandé | Usage |
|---|---|---|
| Arrière-plan de page | --bg, --page-background | Couleur de fond de la page et espace global |
| Surface de contenu | --panel, --card-surface | Panneaux, cartes de contenu |
| Surface des contrôles | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Boutons, recherche, champs de saisie et états d'interaction |
| Surface des superpositions | --dropdown-surface, --dialog-surface | Menus, Popover, Dialog |
| Bordures | --panel-border, --control-border, --input-border | Séparateurs et bordures d'état |
| Texte | --text, --muted | Informations principales et secondaires |
| Interaction de marque | --accent, --link-color, --link-hover-color | Liens, sélection et mise en évidence légère |
| Focus clavier | --focus-ring | État focus-visible |
| Coins arrondis | --card-radius, --button-radius, --button-pill-radius | Forme des Cartes et des contrôles |
| Taille de police des boutons | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Typographie à taille partagée pour les boutons |
| Polices | --font-heading, --font-body | Titres et corps de texte/contrôles |
Typographie
- Space Grotesk est utilisé pour les titres de marque, les titres de page et les chiffres clés ;
- Manrope est utilisé pour le corps du texte, les boutons, les formulaires, les tableaux et l'espace de travail ;
- L'espace de travail reste compact, sans grands titres à l'échelle des pages marketing ;
- Le chinois n'ajoute pas de kerning large à l'anglaise, et les longues traductions ne compriment pas les actions adjacentes.
Espacement et dimensions
- Utilisez un rythme de 4px : 8, 12, 16, 20, 24, 32, 48, 64, 96 ;
- La hauteur de clic des contrôles compacts ne doit pas être inférieure à 40px ;
- La hauteur par défaut des actions est de 44px, et les actions principales sur mobile ne doivent pas être inférieures à 44px ;
- Les boutons partagés utilisent respectivement 14px, 15px et 16px de texte selon
sm,mdetlg, sans hériter de la taille de police du conteneur ; - La largeur du contenu de la plateforme ne dépasse généralement pas 1160px, et celle du contenu du site généré ne dépasse généralement pas 1120px.
Règles de thème
- Les thèmes clair et sombre doivent réutiliser les mêmes Tokens sémantiques ;
- Les Dialog ordinaires utilisent
--dialog-surfacepour fournir un léger dégradé vertical, avec des coins arrondis partagés avec les Cartes selon--card-radius; --accentest utilisé pour les liens, le focus, la sélection et la progression, et non pour remplir de grandes surfaces ;- Les contrôles ordinaires non sélectionnés utilisent la surface neutre
--control-surface-hoverau survol ; les états enfoncé, sélectionné, actuel et développé utilisent la surface de marque--control-surface-active.focus-visibleajoute--focus-ringsur la surface neutre ; les champs focalisés ou actifs conservent leurs Tokens d'état de saisie ; - Les couleurs d'état indiquent uniquement le succès, l'avertissement et le danger ;
- Les sites générés peuvent remplacer les variables de thème, mais doivent maintenir le contraste du corps de texte et une hiérarchie CTA claire.