التخطّي إلى المحتوى
menumenu tanreiexpand_morecontrasttranslate
tanreiexpand_more
البدءWebReactSwiftUIJetpack ComposeFlutterReact Nativeالإعدادات الجاهزةنظام التصميم الخاص بكاستخدام Tanrei مع وكلاء الذكاء الاصطناعيالعلامة التجاريةرموز التصميمأنظمة التصميم والتخصيصTheme Studioاللونالطباعةالأيقوناتالشكلالارتفاعالحركةحالات التفاعلالسلوكالتخطيطإمكانية الوصولالكلماترموز الألوانرموز السلّم الطباعيرموز الشكلرموز الارتفاعرموز الحركةرموز الحالةرموز التباعد والقياسالمكوّناتالزرزر الإجراء الرئيسيالزر المقسَّممجموعة الأزرارزر مع قائمةشريط الأدواتزر النسخخانة الاختيارزر الاختيارمفتاح التبديلالرقاقةقائمة الخياراتشريط التمريرحقل شريط التمريرالتقويمDateTimePickerمجموعة الحقولمجموعة أزرار الاختيارمجموعة خانات الاختيارعنصر الاختيارحقل الاختيارشريط القوائمرفع الملفاتمنتقي الملفات متقدّمساحة الإفلاتحقل إدخال النص متقدّمحقل النصحقل الرقاقاتالحقلمربع التحرير والسرد متقدّمحقل التحرير والسردحقل إدخال العدد متقدّمحقل العددحقل إدخال اللون متقدّمحقل اللونحقل إدخال الرمز لمرة واحدة متقدّمحقل الرمز لمرة واحدةحقل إدخال النص المدمج متقدّممربع كتابة الرسائلالبطاقةالفاصلالطبقة النمطية متقدّممربع الحوارالقائمة (list)صف القائمةاللوحة السفليةاللوحة الجانبيةالعرض الدوّاركتلة الشيفرةالجدولاللوحة المنبثقةالخطواتالأكورديونقائمة الوصفالشكل التوضيحيهيكل التطبيقرأس الصفحةالعرض الشجريالخط الزمنيمعاينة الصورمقبض تغيير الحجمالإطار القابل لتغيير الحجممنطقة التمريرالشارةمؤشر التقدمالعدّادعارض الأرقام المتحرّكمؤشر التحميلشريط الإشعار (Snackbar)التلميحاختصار لوحة المفاتيحالوسمالشيفرة المضمَّنةالتنويهالصورة الرمزيةالحالة الفارغةمجموعة الوسومهيكل التحميلعنصر الملفمربع اللونالنص المتحركعلامات التبويبعرض التبويباتشريط التطبيقشريط التنقلدرج التنقلالبحثالرابطالتنقل بين الصفحاتروابط السابق والتاليمؤشر الخطواتمسار التنقلجدول المحتوياتبطاقة الرابطقائمة FABالحالةكيف يُبنى Tanreiالمساهمةالترخيص والإسناد
الرئيسيةالبدءالبدء

البدء

ما الذي يقدّمه Tanrei، وكيف تترابط أجزاؤه، ومن أين تبدأ على منصتك.

content_copyعرض بتنسيق Markdown

نظام التصميم Tanrei يُقدَّم في صورة مكتبات أصلية لكل منصة. لا تحتاج إلى بيئة تشغيل خاصة ولا إلى إطار عمل متعدد المنصات؛ يكفي أن تضيف الحزمة الخاصة بالمنصة التي تبني عليها أصلًا، فتحصل على الرموز (tokens) والمكوّنات وسلوك إمكانية الوصول نفسها الموجودة على سائر المنصات.

إصدار تمهيدي

نُشر 0.1.0-next.0 تحت وسم التوزيع (dist-tag) next في npm: وحتى 0.1.0، أضِف @next بعد اسم الحزمة عند تثبيتها (npm install @tanrei/web@next). لا يُحافَظ على التوافق مع الإصدارات السابقة طوال الإصدارات التمهيدية 0.x: قد يكسر أي إصدار تمهيدي أي شيء دون أن يُعلَن شيء مهمَلًا قبله، ويذكر الـ changeset الخاص به ما الذي انكسر.

لم يُنشر بعد: SwiftUI وJetpack Compose وFlutter وReact Native. تُنشر المنصة حين تلحق بالمواصفات الحالية، والتكامل المستمر (CI) الخاص بها متوقف حتى ذلك الحين؛ وفي الأثناء يبيّن دليلها كيف تُضاف من الشيفرة المصدرية.

اختر منصتك

الزر نفسه بست طرق

يُعرَّف كل مكوّن مرة واحدة في مواصفة محايدة تجاه المنصات، ثم يُنفَّذ بأسلوب كل منصة. يحتفظ الموقع بعلامة التبويب التي تختارها في جميع صفحاته.

<tanrei-button variant="tonal">حفظ المسودة</tanrei-button>
<Button variant="tonal" onClick={saveDraft}>حفظ المسودة</Button>
TanreiButton("حفظ المسودة", variant: .tonal) { saveDraft() }
TanreiButton(text = "حفظ المسودة", onClick = ::saveDraft, variant = TanreiButtonVariant.Tonal)
TanreiButton(variant: TanreiButtonVariant.tonal, onPressed: saveDraft, child: const Text('حفظ المسودة'))
<Button variant="tonal" onPress={saveDraft}>حفظ المسودة</Button>

ما تحصل عليه في كل منصة

  • الرموز. قيم أدوار الألوان والسلّم الطباعي والشكل والارتفاع والحركة والحالة والتباعد، مولَّدة من مصدر DTCG واحد إلى خصائص CSS مخصصة وثوابت بلغات Swift و Kotlin و Dart و TypeScript.
  • السمات. فاتحة وداكنة، ولكل منهما تباين قياسي ومتوسط وعالٍ. تتبع السمة نظام التشغيل افتراضيًّا، ويمكنك فرض أيٍّ من الإعدادين على التطبيق كله أو على شجرة فرعية منه.
  • المكوّنات. تنفيذات للمواصفات المشتركة، بالطُرُز (variants) والحالات وسلوك لوحة المفاتيح نفسها في كل مكان.
  • إعدادات إمكانية الوصول الافتراضية. الحد الأدنى لهدف اللمس، وحلقة تركيز مرئية، ونص يتحمّل التكبير حتى 200%، واحترام إعداد تقليل الحركة: كلها مبنية في النظام وليست متروكة لكل شاشة.

كيف تقرأ هذه الوثائق

  • الأسس تشرح الأفكار والقواعد.
  • مرجع الرموز يسرد كل قيمة، معروضة مباشرة من ملفات الرموز.
  • المكوّنات تتبع قالبًا واحدًا: نظرة عامة، ثم المواصفات، ثم الإرشادات، ثم إمكانية الوصول. الجداول في تلك الصفحات مصدرها مواصفة المكوّن، فلا يمكن أن تتقادم.
  • الحالة مولَّدة من المستودع.
  • استخدام Tanrei مع وكلاء الذكاء الاصطناعي تبيّن كيف تصل خادم MCP، وتعطي وكيل البرمجة قواعد كتابة واجهتك بمكوّنات Tanrei.