Skip to Content
التصميم

دليل تصميم Qokit

عقد التصميم العام الموجه لدمج المنصة، وتطوير الإضافات، واستخدام المكونات.

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

يهدف دليل تصميم Qokit إلى دمج المنصة المستقبلي، ومطوري الإضافات وفريق الواجهة الأمامية، حيث يوضح بشكل علني الأساسيات التي يمكن الاعتماد عليها على المدى الطويل من العلامة التجارية، وواجهات المكونات، والتسلسل البصري، ومتطلبات الاستجابة، واستراتيجيات التوافق.

هنا نصف "ما يمكن للمطورين الاعتماد عليه"، ولا تشمل المسار الداخلي للمنتج، أو تعليمات الذكاء الاصطناعي، أو عملية قرار المستودع، أو خطط التنفيذ غير المعلنة.

الوصول السريع

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

عند الدمج، اختر القدرات بالترتيب التالي:

  1. اختر المكونات الأساسية مثل Button وCard وDialog من @qokit/components/ui؛
  2. اختر مجموعات المنتجات المستقرة من @qokit/components/patterns؛
  3. استخدم @qokit/components/skins/platform أو site أو admin لتكييف الواجهة المستهدفة؛
  4. استخدم رموز CSS المشتركة، ولا تنسخ الأنماط الأساسية للمكونات؛
  5. تحقق من حالات سطح المكتب والجوال ولوحة المفاتيح والنصوص الطويلة.

خريطة الدليل

ما تحتاج إلى معرفتهالوثائق
ألوان العلامة التجارية، والخطوط، والمسافات، والرموزfoundations.md
الاستجابة، ولوحة المفاتيح وإمكانية الوصولaccessibility.md
استيراد المكونات، والعقد العام لـ Skeleton/Skin وطرق الترقيةcomponent-integration.md
Button وIconButtonbutton-component-rules.md
Card وShell والطبقات العائمة والموادcard-surface-materials.md
معايير الجودة العلنية للمواقع المولدةgenerated-site-quality.md
سجل التغييرات في العقد والترقياتchangelog.md

العقد العلني

  • يتم الحفاظ على هيكل المكونات والخصائص وسلوك إمكانية الوصول بواسطة المكونات المشتركة؛
  • يغير Skin فقط فتحات class ومتغيرات CSS، ولا يغير سلوك الأعمال؛
  • تحافظ الرموز الدلالية على نفس المسؤولية في السمات الفاتحة والداكنة والمواقع المولدة؛
  • يجب توثيق التغييرات المعطلة في سجل التغييرات (Changelog)، وتوفير تعليمات الترحيل؛
  • عند وجود اختلاف بين الوثائق والكود، تعتمد على واجهة برمجة التطبيقات (API) للمكون المنشور، وتصحح الوثائق في الإصدار نفسه.

في هذه الصفحة