Skip to Content
Conception

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ôleToken recommandéUsage
Arrière-plan de page--bg, --page-backgroundCouleur de fond de la page et espace global
Surface de contenu--panel, --card-surfacePanneaux, cartes de contenu
Surface des contrôles--control-surface, --control-surface-hover, --control-surface-active, --input-surfaceBoutons, recherche, champs de saisie et états d'interaction
Surface des superpositions--dropdown-surface, --dialog-surfaceMenus, Popover, Dialog
Bordures--panel-border, --control-border, --input-borderSéparateurs et bordures d'état
Texte--text, --mutedInformations principales et secondaires
Interaction de marque--accent, --link-color, --link-hover-colorLiens, sélection et mise en évidence légère
Focus clavier--focus-ringÉtat focus-visible
Coins arrondis--card-radius, --button-radius, --button-pill-radiusForme des Cartes et des contrôles
Taille de police des boutons--button-font-size-sm, --button-font-size-md, --button-font-size-lgTypographie à taille partagée pour les boutons
Polices--font-heading, --font-bodyTitres 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, md et lg, 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-surface pour fournir un léger dégradé vertical, avec des coins arrondis partagés avec les Cartes selon --card-radius ;
  • --accent est 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-hover au survol ; les états enfoncé, sélectionné, actuel et développé utilisent la surface de marque --control-surface-active. focus-visible ajoute --focus-ring sur 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.

Sur cette page