Skip to Content
Tasarım

Qokit Tasarım Rehberi

Platform entegrasyonu, genişletme geliştirme ve bileşen kullanımı için açık tasarım sözleşmesi.

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 Tasarım Rehberi

Qokit Tasarım Rehberi, gelecekteki platform entegratörleri, genişletme geliştiricileri ve ön uç ekipleri için uzun vadeli güvenilir marka temelleri, bileşen arayüzleri, görsel hiyerarşi, duyarlılık gereksinimleri ve uyumluluk stratejilerini açıkça belirtir.

Burada "geliştiricilerin neye güvenebileceği" açıklanmaktadır; iç ürün rotaları, AI ipuçları, depo karar süreçleri veya gizli uygulama yöntemleri dahil değildir.

Hızlı Başlangıç

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

Entegrasyon sırasında yetenekleri aşağıdaki sırayla seçin:

  1. Temel bileşenler olan Button, Card, Dialog vb. için @qokit/components/ui'den seçim yapın;
  2. Kararlı ürün kombinasyonları için @qokit/components/patterns'den seçim yapın;
  3. Hedef arayüzü uyarlamak için @qokit/components/skins/platform, site veya admin'i kullanın;
  4. Bileşen temel stillerini kopyalamadan paylaşılan CSS Token'larını kullanın;
  5. Masaüstü, mobil, klavye ve uzun metin durumlarını doğrulayın.

Rehber Haritası

Bilinmesi GerekenlerDoküman
Marka renkleri, yazı tipleri, boşluklar ve Token'larfoundations.md
Duyarlılık, klavye ve erişilebilirlikaccessibility.md
Bileşen içe aktarma, Skeleton/Skin ortak sözleşmesi ve yükseltme yollarıcomponent-integration.md
Button ve IconButtonbutton-component-rules.md
Card, Shell, katmanlar ve malzemelercard-surface-materials.md
Oluşturulan sitelerin herkese açık kalite standartlarıgenerated-site-quality.md
Sözleşme değişiklikleri ve yükseltme kayıtlarıchangelog.md

Herkese Açık Sözleşme

  • Bileşen yapısı, özellikleri ve erişilebilirlik davranışları paylaşılan bileşenler tarafından korunur;
  • Skin yalnızca class yuvalarını ve CSS değişkenlerini değiştirir, işlevsel davranışı değiştirmez;
  • Anlamsal Token'lar açık, koyu ve oluşturulan site temalarında aynı sorumluluğu taşır;
  • Kırıcı değişiklikler Changelog'da kaydedilmeli ve geçiş talimatları sağlanmalıdır;
  • Doküman ile kod arasında fark olduğunda, yayınlanmış bileşen API'si esas alınmalı ve doküman aynı sürümde düzeltilmelidir.

Bu Sayfada