Nền tảng Thị giác và Token
Hợp đồng sử dụng công khai cho màu sắc thương hiệu, phông chữ, khoảng cách, bo góc và Token ngữ nghĩa của Qokit.
Nền tảng Thị giác và Token
Giao diện nền tảng của Qokit sử dụng hệ thống màu xanh trong trẻo, chuyên nghiệp và tiết chế. Nhà phát triển nên thích ứng chủ đề thông qua Token ngữ nghĩa, không sao chép giá trị màu, đổ bóng, bo góc hoặc phông chữ vào các thành phần nghiệp vụ.
Vai trò cốt lõi
| Vai trò | Token khuyến nghị | Mục đích sử dụng |
|---|---|---|
| Nền trang | --bg, --page-background | Màu nền trang và không gian tổng thể |
| Bề mặt nội dung | --panel, --card-surface | Bảng điều khiển, thẻ nội dung |
| Bề mặt điều khiển | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | Nút, tìm kiếm, ô nhập liệu và trạng thái tương tác |
| Bề mặt lớp nổi | --dropdown-surface, --dialog-surface | Menu, Popover, Dialog |
| Ranh giới | --panel-border, --control-border, --input-border | Phân tách và ranh giới trạng thái |
| Văn bản | --text, --muted | Thông tin chính và phụ |
| Tương tác thương hiệu | --accent, --link-color, --link-hover-color | Liên kết, đã chọn và nhấn mạnh nhẹ |
| Tiêu điểm bàn phím | --focus-ring | Trạng thái focus-visible |
| Bo góc | --card-radius, --button-radius, --button-pill-radius | Hình dạng Card và điều khiển |
| Kích thước chữ nút | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | Bố cục kích thước chia sẻ cho nút |
| Phông chữ | --font-heading, --font-body | Tiêu đề và văn bản/thành phần điều khiển |
Bố cục văn bản
- Space Grotesk dùng cho tiêu đề thương hiệu, tiêu đề trang và số liệu quan trọng;
- Manrope dùng cho văn bản chính, nút, biểu mẫu, bảng và không gian làm việc;
- Không gian làm việc giữ sự gọn gàng, không sử dụng tiêu đề lớn như trên trang marketing;
- Tiếng Trung không tăng khoảng cách chữ kiểu tiếng Anh, bản dịch dài không được ép chặt các thao tác liền kề.
Khoảng cách và Kích thước
- Sử dụng nhịp 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- Chiều cao nhấp của điều khiển gọn gàng không dưới 40px;
- Chiều cao thao tác mặc định là 44px, thao tác chính trên thiết bị di động không dưới 44px;
- Nút chia sẻ sử dụng văn bản 14px, 15px, 16px tương ứng với
sm,md,lg, không thừa kế kích thước chữ của container chứa; - Chiều rộng nội dung nền tảng thường không quá 1160px, nội dung trang được tạo ra thường không quá 1120px.
Quy tắc chủ đề
- Chủ đề sáng và tối phải tái sử dụng cùng Token ngữ nghĩa;
- Dialog thông thường sử dụng
--dialog-surfaceđể cung cấp chuyển vị dọc nhẹ, bo góc chung với Card là--card-radius; --accentdùng cho liên kết, tiêu điểm, đã chọn và tiến trình, không dùng để trải nền diện rộng;- Điều khiển thông thường chưa được chọn dùng bề mặt trung tính
--control-surface-hoverkhi hover; trạng thái nhấn, chọn, hiện tại và mở rộng dùng bề mặt thương hiệu--control-surface-active.focus-visiblethêm--focus-ringtrên bề mặt trung tính; ô nhập đang focus hoặc active vẫn dùng Token trạng thái nhập liệu; - Màu trạng thái chỉ biểu thị thành công, cảnh báo và nguy hiểm;
- Trang được tạo ra có thể ghi đè biến chủ đề, nhưng phải duy trì độ tương phản văn bản chính và cấp bậc CTA rõ ràng.