Skip to Content
Design

Qokit Design-Leitfaden

Öffentlicher Designvertrag für Plattformintegration, Erweiterungsentwicklung und Komponentennutzung.

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 Design-Richtlinien

Die Qokit Design-Richtlinien richten sich an zukünftige Plattformintegratoren, Erweiterungsentwickler und Frontend-Teams. Sie machen die Markenbasis, Komponenten-Schnittstellen, visuelle Hierarchien, responsiven Anforderungen und Kompatibilitätsstrategien öffentlich, auf die langfristig vertraut werden kann.

Hier wird beschrieben, „worauf Entwickler vertrauen können“. Interne Produktroadmaps, KI-Prompts, Entscheidungsprozesse in den Repositories oder nicht veröffentlichte Implementierungen sind nicht enthalten.

Schnelle Integration

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

Wählen Sie bei der Integration folgende Fähigkeiten in dieser Reihenfolge aus:

  1. Wählen Sie Basis-Komponenten wie Button, Card und Dialog aus @qokit/components/ui;
  2. Wählen Sie stabile Produktkombinationen aus @qokit/components/patterns;
  3. Passen Sie die Zieloberfläche mit @qokit/components/skins/platform, site oder admin an;
  4. Verwenden Sie gemeinsame CSS-Token, kopieren Sie jedoch nicht die Basis-Stile der Komponenten;
  5. Überprüfen Sie Desktop-, Mobile-, Tastatur- und Langtext-Zustände.

Richtlinien-Karte

Zu wissen istDokumentation
Markenfarben, Schriftarten, Abstände und Tokenfoundations.md
Responsivität, Tastatur und Barrierefreiheitaccessibility.md
Komponenten-Import, gemeinsamer Vertrag für Skeleton/Skin und Upgrade-Methodecomponent-integration.md
Button und IconButtonbutton-component-rules.md
Card, Shell, Overlays und Materialiencard-surface-materials.md
Öffentliche Qualitätsstandards für generierte Sitesgenerated-site-quality.md
Änderungen am Vertrag und Upgrades-Protokollchangelog.md

Öffentlicher Vertrag

  • Die Struktur, Attribute und das barrierefreie Verhalten von Komponenten werden von gemeinsamen Komponenten verwaltet;
  • Skin ändert nur die Class-Slots und CSS-Variablen, nicht das Geschäftsverhalten;
  • Semantische Token behalten ihre gleiche Aufgabe in hellen, dunklen und generierten Site-Themen bei;
  • Breaking Changes müssen im Changelog dokumentiert und Migrationshinweise bereitgestellt werden;
  • Bei Unterschieden zwischen Dokumentation und Code gilt die veröffentlichte Komponenten-API; die Dokumentation wird in derselben Version korrigiert.

Auf dieser Seite