Dasar Visual dan Token
Kontrak penggunaan publik untuk warna merek, font, spasi, radius sudut, dan Token semantik Qokit.
Dasar Visual dan Token
Antarmuka platform Qokit menggunakan sistem biru yang jernih, profesional, dan terkendali. Pengembang harus menyesuaikan tema melalui Token semantik, dan tidak menyalin nilai warna, bayangan, radius sudut, atau font di komponen bisnis.
Peran Inti
| Peran | Token yang Direkomendasikan | Kegunaan |
|---|---|---|
| Latar Belakang Halaman | --bg, --page-background | Warna dasar halaman dan ruang keseluruhan |
| Permukaan Konten | --panel, --card-surface | Panel, kartu konten |
| Permukaan Kontrol | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Tombol, pencarian, bidang input, dan status interaksi |
| Permukaan Overlay | --dropdown-surface, --dialog-surface | Menu, Popover, Dialog |
| Batas | --panel-border, --control-border, --input-border | Pemisah dan batas status |
| Teks | --text, --muted | Informasi utama dan sekunder |
| Interaksi Merek | --accent, --link-color, --link-hover-color | Tautan, seleksi, dan penekanan ringan |
| Fokus Keyboard | --focus-ring | Status focus-visible |
| Radius Sudut | --card-radius, --button-radius, --button-pill-radius | Bentuk Card dan kontrol |
| Ukuran Font Tombol | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Tipografi tingkat ukuran tombol bersama |
| Font | --font-heading, --font-body | Judul dan teks utama/kontrol |
Tipografi
- Space Grotesk digunakan untuk judul merek, judul halaman, dan angka kunci;
- Manrope digunakan untuk teks utama, tombol, formulir, tabel, dan workspace;
- Workspace tetap padat, tidak menggunakan judul besar skala halaman pemasaran;
- Bahasa Tionghoa tidak menambah tracking lebar gaya Inggris, terjemahan panjang tidak boleh menekan operasi yang bersebelahan.
Spasi dan Dimensi
- Gunakan ritme 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- Tinggi klik kontrol padat tidak kurang dari 40px;
- Tinggi operasi default adalah 44px, operasi utama seluler tidak kurang dari 44px;
- Tombol bersama menggunakan teks 14px, 15px, dan 16px secara berturut-turut untuk
sm,md, danlg, tidak mewarisi ukuran font wadah tempatnya berada; - Lebar konten platform biasanya tidak melebihi 1160px, konten situs hasil generate biasanya tidak melebihi 1120px.
Aturan Tema
- Tema terang dan gelap harus menggunakan kembali Token semantik yang sama;
- Dialog biasa menggunakan
--dialog-surfaceuntuk memberikan gradien vertikal ringan, radius sudut berbagi--card-radiusdengan Card; --accentdigunakan untuk tautan, fokus, seleksi, dan progres, tidak digunakan untuk latar belakang area luas;- Kontrol biasa yang belum dipilih memakai permukaan netral
--control-surface-hoversaat hover; status ditekan, dipilih, saat ini, dan diperluas memakai permukaan merek--control-surface-active.focus-visiblemenambahkan--focus-ringdi atas permukaan netral; input yang fokus atau aktif tetap memakai Token status input; - Warna status hanya mengekspresikan sukses, peringatan, dan bahaya;
- Situs hasil generate dapat menimpa variabel tema, tetapi harus mempertahankan kontras teks utama dan hierarki CTA yang jelas.