Skip to Content
Design

Guida al design di Qokit

Contratto di design pubblico per integrazioni di piattaforma, sviluppo di estensioni e utilizzo dei componenti.

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

Linee guida di design di Qokit

Le linee guida di design di Qokit sono rivolte ai futuri partner di integrazione della piattaforma, agli sviluppatori di estensioni e ai team frontend, spiegando pubblicamente le basi del brand, gli interfacce dei componenti, la gerarchia visiva, i requisiti di responsive design e le strategie di compatibilità su cui si può fare affidamento a lungo termine.

Qui viene descritto "su cosa può fare affidamento uno sviluppatore"; non includono la roadmap interna del prodotto, i prompt dell'IA, il processo decisionale del repository o soluzioni implementative non pubbliche.

Integrazione rapida

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

Durante l'integrazione, selezionare le funzionalità nell'ordine seguente:

  1. Selezionare componenti di base come Button, Card, Dialog da @qokit/components/ui;
  2. Selezionare combinazioni di prodotti stabili da @qokit/components/patterns;
  3. Utilizzare @qokit/components/skins/platform, site o admin per adattare l'interfaccia target;
  4. Utilizzare i CSS Token condivisi, senza copiare gli stili di base dei componenti;
  5. Verificare gli stati desktop, mobile, tastiera e testi lunghi.

Mappa delle guide

Cosa è necessario sapereDocumento
Colori del brand, font, spaziatura e Tokenfoundations.md
Responsive, tastiera e accessibilitàaccessibility.md
Importazione dei componenti, contratto pubblico Skeleton/Skin e modalità di aggiornamentocomponent-integration.md
Button e IconButtonbutton-component-rules.md
Card, Shell, overlay e materialicard-surface-materials.md
Standard di qualità pubblici per i siti generatigenerated-site-quality.md
Modifiche al contratto e registro degli aggiornamentichangelog.md

Contratto pubblico

  • La struttura dei componenti, le proprietà e il comportamento di accessibilità sono gestiti dai componenti condivisi;
  • Skin modifica solo gli slot delle class e le variabili CSS, senza alterare il comportamento aziendale;
  • I Token semantici mantengono lo stesso ruolo nei temi light, dark e nei siti generati;
  • Le modifiche breaking devono essere registrate nel Changelog e accompagnate da istruzioni di migrazione;
  • In caso di discrepanza tra documentazione e codice, prevale l'API del componente pubblicato, e la documentazione viene corretta nella stessa versione.

In questa pagina