Skip to Content
ออกแบบ

คู่มือการออกแบบ Qokit

สัญญาการออกแบบสาธารณะสำหรับการผสานรวมแพลตฟอร์ม, การพัฒนาส่วนขยาย และการใช้งานคอมโพเนนต์

Qokit Design GuidePublic components, tokens & integrationQokit 设计指南公共组件、设计令牌与平台集成Qokit 設計指南公開元件、設計權杖與平台整合Guía de diseño de QokitComponentes públicos, tokens e integraciónQokit DesignleitfadenÖffentliche Komponenten, Tokens und IntegrationGuide de conception QokitComposants publics, jetons et intégrationGuia de design QokitComponentes públicos, tokens e integraçãoQokit デザインガイド公開コンポーネント、トークン、統合Qokit 디자인 가이드공개 컴포넌트, 토큰 및 통합Guida al design QokitComponenti pubblici, token e integrazioneQokit-ontwerpgidsPublieke componenten, tokens en integratiePanduan Desain QokitKomponen publik, token, dan integrasiHướng dẫn thiết kế QokitThành phần công khai, token và tích hợpQokit Tasarım RehberiHerkese açık bileşenler, tokenlar ve entegrasyonGuia de design QokitComponentes públicos, tokens e integraçãoГайд по дизайну QokitПубличные компоненты, токены и интеграцияدليل تصميم Qokitمكوّنات عامة ورموز تصميم وتكاملQokit डिज़ाइन गाइडसार्वजनिक कॉम्पोनेंट, टोकन और इंटीग्रेशनคู่มือการออกแบบ Qokitคอมโพเนนต์สาธารณะ โทเค็น และการผสานรวมPrzewodnik projektowy QokitPubliczne komponenty, tokeny i integracja

คู่มือการออกแบบ Qokit

คู่มือการออกแบบ Qokit มุ่งเป้าไปที่ผู้ผสานรวมแพลตฟอร์มในอนาคต นักพัฒนาส่วนขยาย และทีมหน้าบ้าน โดยเปิดเผยพื้นฐานของแบรนด์ อินเทอร์เฟซคอมโพเนเมนต์ ระดับภาพรวม การตอบสนองต่อขนาดหน้าจอ และกลยุทธ์ความเข้ากันได้ที่สามารถพึ่งพาได้อย่างยาวนาน

สิ่งนี้บรรยายว่า "นักพัฒนาสามารถพึ่งพาอะไรได้" ไม่รวมถึงเส้นทางการผลิตภายใน คำสั่ง AI กระบวนการตัดสินใจในคลังโค้ด หรือแผนการดำเนินงานที่ไม่เปิดเผย

การเริ่มต้นใช้งานอย่างรวดเร็ว

import { Button, Card } from '@qokit/components/ui';
import { platformButtonSkin, platformCardSkin } from '@qokit/components/skins/platform';

export function IntegrationAction() {
  return (
    <Card layer="shell" skin={platformCardSkin}>
      <Button skin={platformButtonSkin} type="button" variant="primary">
        连接 Qokit
      </Button>
    </Card>
  );
}

เมื่อผสานรวม ให้เลือกความสามารถตามลำดับต่อไปนี้:

  1. เลือกคอมโพเนนต์พื้นฐานเช่น Button, Card, Dialog จาก @qokit/components/ui;
  2. เลือกชุดผลิตภัณฑ์ที่เสถียรจาก @qokit/components/patterns;
  3. ใช้ @qokit/components/skins/platform, site หรือ admin เพื่อปรับให้เข้ากับอินเทอร์เฟซเป้าหมาย;
  4. ใช้ Shared CSS Token อย่าคัดลอกสไตล์พื้นฐานของคอมโพเนนต์;
  5. ตรวจสอบสถานะบนเดสก์ท็อป มือถือ คีย์บอร์ด และข้อความยาว

แผนที่คู่มือ

สิ่งที่จำเป็นต้องรู้เอกสาร
สีแบรนด์ ฟอนต์ ระยะห่าง และ Tokenfoundations.md
การตอบสนองต่อขนาดหน้าจอ คีย์บอร์ด และการเข้าถึงได้accessibility.md
การนำเข้าคอมโพเนนต์ สัญญาสาธารณะของ Skeleton/Skin และวิธีการอัปเกรดcomponent-integration.md
Button และ IconButtonbutton-component-rules.md
Card, Shell, Floating Layer และ Materialcard-surface-materials.md
มาตรฐานคุณภาพสาธารณะสำหรับไซต์ที่สร้างโดย AIgenerated-site-quality.md
การเปลี่ยนแปลงสัญญาและบันทึกการอัปเกรดchangelog.md

สัญญาสาธารณะ

  • โครงสร้างคอมโพเนนต์ คุณสมบัติ และพฤติกรรมการเข้าถึงได้ถูกดูแลโดยคอมโพเนนต์ร่วม;
  • Skin เปลี่ยนเฉพาะ slot ของ class และตัวแปร CSS ไม่เปลี่ยนพฤติกรรมทางธุรกิจ;
  • Semantic Token รักษาหน้าที่เดียวกันในธีมแสง ธีมมืด และธีมไซต์ที่สร้างโดย AI;
  • การเปลี่ยนแปลงที่ทำลายความเข้ากันได้ต้องบันทึกไว้ใน Changelog และให้คำแนะนำในการย้าย;
  • เมื่อเอกสารและโค้ดมีความขัดแย้ง ให้ยึดตาม API ของคอมโพเนนต์ที่เผยแพร่แล้ว และแก้ไขเอกสารในเวอร์ชันเดียวกัน

ในหน้านี้