Visuelle Grundlagen und Token
Öffentliche Nutzungsvereinbarung für Qokit Markenfarben, Schriftarten, Abstände, Eckenradien und semantische Token.
Visuelle Grundlagen und Token
Die Benutzeroberfläche der Qokit-Plattform verwendet ein klares, professionelles und zurückhaltendes Blauspektrum. Entwickler sollten Themen über semantische Token anpassen und keine Farbwerte, Schatten, Eckenradien oder Schriftarten in geschäftlichen Komponenten kopieren.
Kernrollen
| Rolle | Empfohlenes Token | Verwendung |
|---|---|---|
| Seitenhintergrund | --bg, --page-background | Seitenbasisfarbe und Gesamtraum |
| Inhaltsoberfläche | --panel, --card-surface | Panels, Inhaltskarten |
| Steuerelementoberfläche | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Schaltflächen, Suche, Eingabefelder und Interaktionszustände |
| Overlay-Oberfläche | --dropdown-surface, --dialog-surface | Menü, Popover, Dialog |
| Grenzen | --panel-border, --control-border, --input-border | Trennung und Statusgrenzen |
| Text | --text, --muted | Primäre und sekundäre Informationen |
| Markeninteraktion | --accent, --link-color, --link-hover-color | Links, Auswahl und leichte Hervorhebung |
| Tastaturfokus | --focus-ring | focus-visible-Status |
| Eckenradius | --card-radius, --button-radius, --button-pill-radius | Form von Karten und Steuerelementen |
| Schaltflächenschriftgröße | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Typografie auf Größenstufe für freigegebene Schaltflächen |
| Schriftart | --font-heading, --font-body | Überschriften und Fließtext/Steuerelemente |
Typografie
- Space Grotesk wird für Markentitel, Seitentitel und wichtige Zahlen verwendet;
- Manrope wird für Fließtext, Schaltflächen, Formulare, Tabellen und Arbeitsbereiche verwendet;
- Der Arbeitsbereich bleibt kompakt, es werden keine großen Titel im Marketingseitenmaßstab verwendet;
- Chinesischer Text erhält keinen englischen Weitraum, lange Übersetzungen dürfen benachbarte Aktionen nicht zusammendrücken.
Abstände und Größen
- Verwenden Sie einen 4px-Rhythmus: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- Die Klickhöhe kompakter Steuerelemente beträgt mindestens 40px;
- Die Standardaktionshöhe beträgt 44px, primäre mobile Aktionen sind mindestens 44px hoch;
- Freigegebene Schaltflächen verwenden je nach
sm,md,lgdie Schriftgrößen 14px, 15px, 16px und erben nicht die Schriftgröße des übergeordneten Containers; - Die Plattforminhaltsbreite überschreitet normalerweise 1160px nicht, generierte Seiteninhalte überschreiten normalerweise 1120px nicht.
Themenregeln
- Helle und dunkle Themen müssen dieselben semantischen Token wiederverwenden;
- Normale Dialoge verwenden
--dialog-surfacefür einen leichten vertikalen Farbverlauf, der Eckenradius ist mit Karten identisch zu--card-radius; --accentwird für Links, Fokus, Auswahl und Fortschritt verwendet, nicht für große Hintergrundflächen;- Normale, nicht ausgewählte Steuerelemente verwenden bei hover die neutrale Fläche
--control-surface-hover; gedrückte, ausgewählte, aktuelle und aufgeklappte Zustände verwenden die Markenfläche--control-surface-active.focus-visibleergänzt--focus-ringauf der neutralen Fläche; fokussierte oder aktive Eingaben behalten ihre Eingabezustands-Token; - Statusfarben drücken nur Erfolg, Warnung und Gefahr aus;
- Generierte Seiten können Themenvariablen überschreiben, müssen jedoch den Kontrast des Fließtexts und eine klare CTA-Hierarchie beibehalten.