دليل تصميم Qokit
عقد التصميم العام الموجه لدمج المنصة، وتطوير الإضافات، واستخدام المكونات.
دليل تصميم 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>
);
}عند الدمج، اختر القدرات بالترتيب التالي:
- اختر المكونات الأساسية مثل Button وCard وDialog من
@qokit/components/ui؛ - اختر مجموعات المنتجات المستقرة من
@qokit/components/patterns؛ - استخدم
@qokit/components/skins/platformأوsiteأوadminلتكييف الواجهة المستهدفة؛ - استخدم رموز CSS المشتركة، ولا تنسخ الأنماط الأساسية للمكونات؛
- تحقق من حالات سطح المكتب والجوال ولوحة المفاتيح والنصوص الطويلة.
خريطة الدليل
| ما تحتاج إلى معرفته | الوثائق |
|---|---|
| ألوان العلامة التجارية، والخطوط، والمسافات، والرموز | foundations.md |
| الاستجابة، ولوحة المفاتيح وإمكانية الوصول | accessibility.md |
| استيراد المكونات، والعقد العام لـ Skeleton/Skin وطرق الترقية | component-integration.md |
| Button وIconButton | button-component-rules.md |
| Card وShell والطبقات العائمة والمواد | card-surface-materials.md |
| معايير الجودة العلنية للمواقع المولدة | generated-site-quality.md |
| سجل التغييرات في العقد والترقيات | changelog.md |
العقد العلني
- يتم الحفاظ على هيكل المكونات والخصائص وسلوك إمكانية الوصول بواسطة المكونات المشتركة؛
- يغير Skin فقط فتحات class ومتغيرات CSS، ولا يغير سلوك الأعمال؛
- تحافظ الرموز الدلالية على نفس المسؤولية في السمات الفاتحة والداكنة والمواقع المولدة؛
- يجب توثيق التغييرات المعطلة في سجل التغييرات (Changelog)، وتوفير تعليمات الترحيل؛
- عند وجود اختلاف بين الوثائق والكود، تعتمد على واجهة برمجة التطبيقات (API) للمكون المنشور، وتصحح الوثائق في الإصدار نفسه.
