พื้นฐานภาพและ Token
สัญญาการใช้งานสาธารณะสำหรับสีแบรนด์, ฟอนต์, ระยะห่าง, มุมโค้ง และ Semantic Token ของ Qokit
พื้นฐานภาพและ Token
อินเทอร์เฟซแพลตฟอร์มของ Qokit ใช้ระบบสีฟ้าที่โปร่งใส เป็นมืออาชีพ และระมัดระวัง นักพัฒนาควรปรับธีมผ่าน Semantic Token โดยไม่คัดลอกค่าสี เงา มุมโค้ง หรือฟอนต์ลงในคอมโพเนนต์ธุรกิจ
บทบาทหลัก
| บทบาท | Token ที่แนะนำ | การใช้งาน |
|---|---|---|
| พื้นหลังหน้า | --bg, --page-background | สีพื้นหลังของหน้าและพื้นที่โดยรวม |
| พื้นผิวเนื้อหา | --panel, --card-surface | แผง, การ์ดเนื้อหา |
| พื้นผิวคอนโทรล | --control-surface, --control-surface-hover, --control-surface-active, --input-surface | ปุ่ม, ค้นหา, ช่องกรอกข้อมูล และสถานะการโต้ตอบ |
| พื้นผิว Floating Layer | --dropdown-surface, --dialog-surface | เมนู, Popover, Dialog |
| ขอบเขต | --panel-border, --control-border, --input-border | ตัวคั่นและขอบสถานะ |
| ข้อความ | --text, --muted | ข้อมูลหลักและรอง |
| ปฏิสัมพันธ์แบรนด์ | --accent, --link-color, --link-hover-color | ลิงก์, การเลือก และเน้นแบบเบา |
| โฟกัสคีย์บอร์ด | --focus-ring | สถานะ focus-visible |
| มุมโค้ง | --card-radius, --button-radius, --button-pill-radius | รูปทรง Card และคอนโทรล |
| ขนาดตัวอักษรปุ่ม | --button-font-size-sm, --button-font-size-md, --button-font-size-lg | การจัดวางขนาดระดับร่วมสำหรับปุ่ม |
| ฟอนต์ | --font-heading, --font-body | หัวข้อและข้อความหลัก/คอนโทรล |
การจัดวางข้อความ
- Space Grotesk ใช้สำหรับหัวข้อแบรนด์, หัวข้อหน้า และตัวเลขสำคัญ;
- Manrope ใช้สำหรับข้อความปกติ, ปุ่ม, ฟอร์ม, ตาราง และพื้นที่ทำงาน;
- พื้นที่ทำงานรักษาความกระชับ ไม่ใช้หัวข้อมากขนาดที่ใช้ในหน้าการตลาด;
- ภาษาจีนไม่เพิ่มระยะห่างตัวอักษรแบบภาษาอังกฤษ และการแปลที่ยาวไม่ควรบีบอัดการดำเนินการข้างเคียง
ระยะห่างและขนาด
- ใช้จังหวะ 4px: 8, 12, 16, 20, 24, 32, 48, 64, 96;
- ความสูงในการคลิกของคอนโทรลแบบกระชับต้องไม่น้อยกว่า 40px;
- ความสูงของการดำเนินการเริ่มต้นคือ 44px และการดำเนินการหลักบนมือถือต้องไม่น้อยกว่า 44px;
- ปุ่มร่วมใช้ขนาดตัวอักษร 14px, 15px, 16px ตามลำดับสำหรับ
sm,md,lgโดยไม่สืบทอดขนาดตัวอักษรจากคอนเทนเนอร์; - ความกว้างเนื้อหาแพลตฟอร์มโดยทั่วไปไม่เกิน 1160px และเนื้อหาไซต์ที่สร้างโดย AI โดยทั่วไปไม่เกิน 1120px
กฎธีม
- ธีมสว่างและมืดต้องนำ Semantic Token เดียวกันมาใช้ซ้ำ;
- Dialog ปกติใช้
--dialog-surfaceเพื่อสร้างไล่เฉดแนวตั้งเล็กน้อย และมุมโค้งใช้ร่วมกับ Card ผ่าน--card-radius; --accentใช้สำหรับลิงก์, โฟกัส, การเลือก และความคืบหน้า ไม่ใช้สำหรับปูพื้นขนาดใหญ่;- คอนโทรลทั่วไปที่ยังไม่ถูกเลือกใช้พื้นผิวกลาง
--control-surface-hoverเมื่อ hover; สถานะกด เลือก ปัจจุบัน และขยายใช้พื้นผิวแบรนด์--control-surface-activeส่วนfocus-visibleจะเพิ่ม--focus-ringบนพื้นผิวกลาง และช่องกรอกข้อมูลที่ focus หรือ active ยังคงใช้ Token ของสถานะอินพุต; - สีสถานะสื่อถึงเฉพาะสำเร็จ, เตือน และอันตราย;
- ไซต์ที่สร้างโดย AI สามารถทับซ้อนตัวแปรธีมได้ แต่ต้องรักษาความคมชัดของข้อความหลักและระดับ CTA ที่ชัดเจน