Skip to Content
Conception

Guide de conception Qokit

Contrat de conception public destiné à l'intégration de la plateforme, au développement d'extensions et à l'utilisation des composants.

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

Guide de conception Qokit

Le guide de conception Qokit s'adresse aux futurs intégrateurs de plateforme, aux développeurs d'extensions et aux équipes front-end. Il expose publiquement les fondamentaux de la marque, les interfaces des composants, la hiérarchie visuelle, les exigences de réactivité et les stratégies de compatibilité sur lesquels on peut compter à long terme.

Ce document décrit « ce sur quoi les développeurs peuvent compter » ; il n'inclut pas la roadmap produit interne, les invites IA, les processus décisionnels du dépôt ou les solutions d'implémentation non publiques.

Prise en main rapide

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

Lors de l'intégration, sélectionnez les capacités dans l'ordre suivant :

  1. Sélectionnez les composants de base tels que Button, Card et Dialog depuis @qokit/components/ui ;
  2. Choisissez des combinaisons produits stables depuis @qokit/components/patterns ;
  3. Adaptez l'interface cible en utilisant @qokit/components/skins/platform, site ou admin ;
  4. Utilisez les jetons CSS partagés et ne copiez pas les styles de base des composants ;
  5. Vérifiez les états bureau, mobile, clavier et textes longs.

Carte du guide

Ce qu'il faut savoirDocumentation
Couleurs de marque, polices, espacements et Jetonsfoundations.md
Réactivité, clavier et accessibilitéaccessibility.md
Importation des composants, contrat public Skeleton/Skin et méthodes de mise à niveaucomponent-integration.md
Button et IconButtonbutton-component-rules.md
Card, Shell, superpositions et matériauxcard-surface-materials.md
Normes de qualité publiques pour les sites générésgenerated-site-quality.md
Évolutions du contrat et historique des mises à niveauchangelog.md

Contrat public

  • La structure des composants, leurs attributs et leur comportement d'accessibilité sont gérés par les composants partagés ;
  • Skin modifie uniquement les emplacements de classe et les variables CSS, sans changer le comportement métier ;
  • Les Jetons sémantiques conservent la même responsabilité dans les thèmes clair, sombre et générés ;
  • Les modifications incompatibles doivent être consignées dans le Changelog et inclure des instructions de migration ;
  • En cas d'écart entre la documentation et le code, l'API des composants publiés fait foi, et la documentation est corrigée dans la même version.

Sur cette page