انتقل إلى المحتوى

إضافة

سطر الأوامر
npx blockstudio add <blocks...> [options]

ينزّل المكوّنات من سجل ويكتبها في مجلد المكوّنات بمشروعك.

الوسائط

الوسيط الوصف
blocks مكوّن واحد أو أكثر لإضافته. التنسيق: namespace/block أو block فقط.

الخيارات

الخيار الوصف
-y, --yes تخطَّ جميع المطالبات (الاستبدال وحل التعارضات).
--dry-run اعرض معاينة لما سيُثبّت دون كتابة ملفات.

تحديد مساحة الاسم

عند تحديد مساحة اسم، يبحث CLI في السجل المحدد:

سطر الأوامر
npx blockstudio add ui/tabs

عند عدم تحديد مساحة اسم، يبحث CLI في جميع السجلات المُعدّة:

سطر الأوامر
npx blockstudio add tabs

إذا عُثر على المكوّن في سجل واحد فقط، فسيُستخدم تلقائيًا. وإذا عُثر عليه في عدة سجلات، يعرض CLI مطالبة اختيار تفاعلية لتحديد السجل.

مع --yes، يُستخدم أول سجل مطابق حسب ترتيب blocks.json. من دون طرفية، ومع --dry-run، يؤدي الاسم الملتبس إلى إيقاف الأمر مع عرض خطأ يسرد السجلات:

الكود
Block "hero" found in multiple registries: acme, starter. Specify one: blockstudio add acme/hero

قبل حل أي كتلة، يجلب add كل السجلات المُعدّة. إذا تعذّر الوصول إلى أحدها أو كان غير صالح، يفشل الأمر حتى عند تحديد مساحة اسم صريحة للكتلة.

التبعيات

يمكن للكتل إعلان اعتمادها على كتل أخرى في السجل نفسه. عند إضافة كتلة، تُحلّ اعتماداتها وتُثبّت تلقائيًا.

سطر الأوامر
npx blockstudio add ui/tabs

إذا كانت tabs تعتمد على tab-item، فسيتم تنزيل الكتلتين وتثبيتهما. تُثبّت الاعتمادات دائمًا قبل الكتل التي تعتمد عليها.

يُكتشف الاعتماد الدائري ويُرفض مع عرض خطأ.

سلوك الاستبدال

إذا كان مجلد كتلة موجودًا بالفعل في الدليل المستهدف:

  • الوضع التفاعلي: يطلب منك تأكيد الاستبدال
  • العلامة --yes: يستبدل دون سؤال
  • العلامة --dry-run: يعرض ما سيُستبدل
  • الوضع غير التفاعلي من دون --yes: يتوقف قبل التنزيل، مع عرض Block "<name>" already exists at <path>. Use --yes to overwrite.

يشمل الفحص الاعتمادات أيضًا، لذا فإن إضافة tabs عندما تكون tab-item مثبتة بالفعل تتطلب --yes.

كتل متعددة

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

أمثلة

إضافة كتلة واحدة:

سطر الأوامر
npx blockstudio add ui/hero

إضافة كتل متعددة:

سطر الأوامر
npx blockstudio add ui/tabs ui/hero ui/accordion

معاينة دون كتابة:

سطر الأوامر
npx blockstudio add ui/tabs --dry-run

تخطي جميع المطالبات:

سطر الأوامر
npx blockstudio add ui/tabs --yes