Skip to Content
Desain

Panduan Desain Qokit

Kontrak desain publik untuk integrasi platform, pengembangan ekstensi, dan penggunaan komponen.

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

Panduan Desain Qokit

Panduan Desain Qokit ditujukan untuk pihak integrasi platform masa depan, pengembang ekstensi, dan tim frontend, yang menjelaskan secara publik fondasi merek, antarmuka komponen, hierarki visual, persyaratan responsif, dan strategi kompatibilitas yang dapat diandalkan dalam jangka panjang.

Di sini dijelaskan "apa yang dapat diandalkan oleh pengembang", tidak termasuk rute produk internal, prompt AI, proses keputusan repositori, atau skema implementasi yang tidak dipublikasikan.

Akses Cepat

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>
  );
}

Saat mengakses, pilih kemampuan sesuai urutan berikut:

  1. Pilih komponen dasar seperti Button, Card, Dialog dari @qokit/components/ui;
  2. Pilih kombinasi produk yang stabil dari @qokit/components/patterns;
  3. Gunakan @qokit/components/skins/platform, site, atau admin untuk menyesuaikan antarmuka target;
  4. Gunakan Token CSS bersama, jangan menyalin gaya dasar komponen;
  5. Verifikasi status desktop, seluler, keyboard, dan teks panjang.

Peta Panduan

Apa yang perlu diketahuiDokumen
Warna merek, font, spasi, dan Tokenfoundations.md
Responsif, keyboard, dan aksesibilitasaccessibility.md
Impor komponen, kontrak umum Skeleton/Skin, dan cara upgradecomponent-integration.md
Button dan IconButtonbutton-component-rules.md
Card, Shell, overlay, dan materialcard-surface-materials.md
Standar kualitas publik untuk situs yang dihasilkangenerated-site-quality.md
Perubahan kontrak dan catatan upgradechangelog.md

Kontrak Publik

  • Struktur komponen, atribut, dan perilaku aksesibilitas dikelola oleh komponen bersama;
  • Skin hanya mengubah slot class dan variabel CSS, tidak mengubah perilaku bisnis;
  • Token semantik mempertahankan tanggung jawab yang sama di tema terang, gelap, dan situs yang dihasilkan;
  • Perubahan merusak harus dicatat di Changelog, dan menyediakan panduan migrasi;
  • Jika terdapat perbedaan antara dokumen dan kode, gunakan API komponen yang telah dirilis sebagai acuan, dan perbaiki dokumen pada versi yang sama.

Di halaman ini