Podstawy wizualne i Tokeny
Publiczna umowa dotycząca używania kolorów marki Qokit, czcionek, odstępów, zaokrągleń oraz semantycznych Tokenów.
Podstawy wizualne i Tokeny
Interfejs platformy Qokit wykorzystuje przejrzysty, profesjonalny i stonowany system kolorów niebieskich. Deweloperzy powinni dostosowywać motywy za pomocą semantycznych Tokenów, nie kopiując wartości kolorów, cieni, zaokrągleń ani czcionek w komponentach biznesowych.
Kluczowe role
| Rola | Zalecany Token | Przeznaczenie |
|---|---|---|
| Tło strony | --bg, --page-background | Kolor tła strony i przestrzeń ogólna |
| Powierzchnia treści | --panel, --card-surface | Panele, karty treści |
| Powierzchnia kontrolek | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Przyciski, wyszukiwanie, pola wprowadzania i stany interakcji |
| Powierzchnia warstw floating | --dropdown-surface, --dialog-surface | Menu, Popover, Dialog |
| Granice | --panel-border, --control-border, --input-border | Separatory i granice stanu |
| Tekst | --text, --muted | Informacje główne i poboczne |
| Interakcje brandowe | --accent, --link-color, --link-hover-color | Linki, zaznaczenie i lekkie wyróżnienia |
| Fokus klawiatury | --focus-ring | Stan focus-visible |
| Zaokrąglenia | --card-radius, --button-radius, --button-pill-radius | Kształt kart i kontrolek |
| Rozmiar czcionki przycisków | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Typografia o wymiarach wspólnych przycisków |
| Czcionka | --font-heading, --font-body | Nagłówki i tekst główny/kontrolki |
Typografia
- Space Grotesk służy do nagłówków marki, tytułów stron i kluczowych liczb;
- Manrope służy do tekstu głównego, przycisków, formularzy, tabel i obszarów roboczych;
- Obszar roboczy jest utrzymany w zwartej formie, bez stosowania dużych nagłówków w skali marketingowej;
- W języku chińskim nie zwiększa się odstępów między literami w stylu angielskim, długie tłumaczenia nie powinny ściskać sąsiadujących akcji.
Odstępy i wymiary
- Używaj rytmu 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- Wysokość kliknięcia zwartych kontrolek nie powinna być mniejsza niż 40px;
- Domyślna wysokość akcji to 44px, główne akcje na urządzeniach mobilnych nie powinny być mniejsze niż 44px;
- Wspólne przyciski używają tekstu o rozmiarach 14px, 15px i 16px odpowiednio dla
sm,mdilg, nie dziedzicząc rozmiaru czcionki z kontenera; - Szerokość treści platformy zwykle nie przekracza 1160px, a treści wygenerowanych stron zwykle nie przekraczają 1120px.
Zasady motywu
- Motyw jasny i ciemny muszą ponownie wykorzystywać te same semantyczne Tokeny;
- Zwykły Dialog używa
--dialog-surfacedla delikatnego pionowego gradientu, a zaokrąglenie jest wspólne z Kartą poprzez--card-radius; --accentsłuży do linków, fokusu, zaznaczenia i postępu, nie do dużych powierzchni tła;- Zwykłe niezaznaczone kontrolki używają neutralnej powierzchni
--control-surface-hoverprzy hover; stany wciśnięty, zaznaczony, bieżący i rozwinięty używają powierzchni marki--control-surface-active.focus-visibledodaje--focus-ringna neutralnej powierzchni; aktywne lub sfokusowane pola zachowują Tokeny stanu wejścia; - Kolory stanu oznaczają tylko sukces, ostrzeżenie i błąd;
- Wygenerowane strony mogą nadpisywać zmienne motywu, ale muszą zachować kontrast tekstu głównego i wyraźną hierarchię CTA.