Görsel Temeller ve Token'lar
Qokit marka renkleri, yazı tipleri, boşluklar, yuvarlatılmış köşeler ve anlamsal Token'ların açık kullanım sözleşmesi.
Görsel Temeller ve Token'lar
Qokit platform arayüzü, şeffaf, profesyonel ve ölçülü bir mavi tonu sistemi kullanır. Geliştiriciler temayı anlamsal Token'lar aracılığıyla uyarlamalıdır; iş bileşenlerinde renk değerlerini, gölgeleri, yuvarlatılmış köşeleri veya yazı tiplerini kopyalamamalıdır.
Temel Roller
| Rol | Önerilen Token | Kullanım |
|---|---|---|
| Sayfa Arka Planı | --bg, --page-background | Sayfa zemin rengi ve genel alan |
| İçerik Yüzeyi | --panel, --card-surface | Paneller, içerik kartları |
| Kontrol Yüzeyi | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Düğmeler, arama, giriş alanları ve etkileşim durumları |
| Katman Yüzeyi | --dropdown-surface, --dialog-surface | Menü, Popover, Dialog |
| Sınırlar | --panel-border, --control-border, --input-border | Ayırıcılar ve durum sınırları |
| Metin | --text, --muted | Birincil ve ikincil bilgiler |
| Marka Etkileşimi | --accent, --link-color, --link-hover-color | Bağlantılar, seçimler ve hafif vurgular |
| Klavye Odak | --focus-ring | focus-visible durumu |
| Yuvarlatılmış Köşeler | --card-radius, --button-radius, --button-pill-radius | Kart ve kontrol şekilleri |
| Düğme Yazı Boyutu | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Paylaşılan düğmeler için boyut seviyesinde tipografi |
| Yazı Tipi | --font-heading, --font-body | Başlıklar ve gövde/metin/kontroller |
Tipografi
- Space Grotesk marka başlıkları, sayfa başlıkları ve kritik sayılar için kullanılır;
- Manrope gövde metni, düğmeler, formlar, tablolar ve çalışma alanları için kullanılır;
- Çalışma alanı kompakt tutulur, pazarlama sayfalarındaki gibi büyük başlıklar kullanılmaz;
- Çince'de İngilizce tarzı geniş harf aralığı eklenmez, uzun çeviriler bitişik eylemleri sıkıştırmaz.
Boşluklar ve Boyutlar
- 4px ritmi kullanın: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- Kompakt kontrollerin tıklama yüksekliği en az 40px olmalıdır;
- Varsayılan eylem yüksekliği 44px'tir, mobildeki ana eylemler en az 44px olmalıdır;
- Paylaşılan düğmeler
sm,md,lgiçin sırasıyla 14px, 15px, 16px yazı boyutu kullanır, bulundukları kapsayıcının yazı boyutunu miras almaz; - Platform içeriği genellikle 1160px'i aşmaz, oluşturulan site içeriği genellikle 1120px'i aşmaz.
Tema Kuralları
- Açık ve koyu tema aynı anlamsal Token'ları paylaşmalıdır;
- Standart Dialog, hafif dikey gradyan sağlamak için
--dialog-surfacekullanır; yuvarlatılmış köşeler Kart ile--card-radius'ı paylaşır; --accentbağlantılar, odak, seçim ve ilerleme için kullanılır, geniş alan kaplaması için değil;- Sıradan seçilmemiş kontroller hover sırasında nötr
--control-surface-hoveryüzeyini kullanır; basılı, seçili, geçerli ve genişletilmiş durumlar marka yüzeyi--control-surface-activekullanır.focus-visible, nötr yüzeye--focus-ringekler; odaklanmış veya etkin girişler giriş durumu Token'larını korur; - Durum renkleri yalnızca başarı, uyarı ve tehlikeyi ifade eder;
- Oluşturulan siteler tema değişkenlerini geçersiz kılabilir ancak gövde metni kontrastını ve net CTA hiyerarşisini korumalıdır.