Skip to Content
Ontwerp

Qokit Ontwerprichtlijnen

Open ontwerpcodes gericht op platformintegratie, extensieontwikkeling en componentgebruik.

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 Ontwerprichtlijnen

Deze Qokit Ontwerprichtlijnen zijn bedoeld voor toekomstige platformintegrators, extensieontwikkelaars en frontendteams. Ze maken de merkbasiselementen, componentinterfaces, visuele hiërarchie, responsieve vereisten en compatibiliteitsstrategieën openbaar die op lange termijn betrouwbaar zijn.

Hier wordt beschreven "waar ontwikkelaars op kunnen vertrouwen". Interne productroutes, AI-prompts, repositorybesluitvormingsprocessen en niet-openbare implementaties zijn hierin niet opgenomen.

Snelle integratie

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

Selecteer bij integratie de mogelijkheden in de volgende volgorde:

  1. Kies basiscomponenten zoals Button, Card en Dialog uit @qokit/components/ui;
  2. Kies stabiele productcombinaties uit @qokit/components/patterns;
  3. Pas de doelinterface aan met @qokit/components/skins/platform, site of admin;
  4. Gebruik gedeelde CSS Tokens; kopieer geen basisstijlen van componenten;
  5. Valideer desktop-, mobiel-, toetsenbord- en lange-tekststatussen.

Gidskaart

Wat u moet wetenDocument
Merkkleuren, lettertypes, spaties en Tokensfoundations.md
Responsiviteit, toetsenbord en toegankelijkheidaccessibility.md
Componentimport, publieke contracten voor Skeleton/Skin en upgradeprocessencomponent-integration.md
Button en IconButtonbutton-component-rules.md
Card, Shell, overlays en materialencard-surface-materials.md
Openbare kwaliteitsstandaarden gegenereerde sitesgenerated-site-quality.md
Contractwijzigingen en upgradehistoriechangelog.md

Openbaar contract

  • Componentstructuur, attributen en toegankelijkheidsgedrag worden beheerd door gedeelde componenten;
  • Skin wijzigt alleen class-slots en CSS-variabelen, niet het bedrijfs gedrag;
  • Semantische Tokens behouden dezelfde verantwoordelijkheid in lichte, donkere en gegenereerde thematische achtergronden;
  • Brekende wijzigingen moeten worden geregistreerd in de Changelog, vergezeld van migratie-instructies;
  • Bij verschillen tussen documentatie en code heeft de gepubliceerde component-API voorrang, en wordt de documentatie binnen dezelfde versie gecorrigeerd.

Op deze pagina