Blockstudio مقابل create-block
الشيء نفسه block.json، من دون محرر React أو عملية البناء.
أداة @wordpress/create-block مدعومة رسميًا لبدء إنشاء كتلة: إضافة، وblock.json، ومكوّن تحرير React، وبناء webpack. يحافظ Blockstudio على block.json وWordPress للكتلة API، ويستبدل مكوّن التحرير بحقول يعرضها لك وقالب يعرضه الخادم، من دون أي شيء يحتاج إلى بناء.
ما الذي يتغير عند الاستغناء عن البناء
كتلة Blockstudio هي مجلد: block.json للحقول، وقالب للترميز، وأصول اختيارية بجانبها.
الحقول، لا عناصر التحكم
عرّف حقلًا في block.json وسيظهر عنصر التحكم الخاص به. 27 أنواع مدمجة، من النصوص إلى الحقول المتكررة.
قالب واحد
يعرض القالب نفسه PHP أو Twig أو Blade معاينة المحرر والصفحة.
مكونات المحرر كوسوم
اكتب وسوم RichText أو InnerBlocks في القالب؛ وسيستبدل المحرر React.
الأصول بحسب اسم الملف
يُجمّع style.scss على الخادم، وتُنزّل استيرادات npm في script.js إلى الكتلة.
متى يكون create-block الخيار الأفضل
عندما تكون تجربة التحرير هي المنتج: أشرطة أدوات مخصصة، وتفاعلات السحب، ولوحات الرسم، أو أي شيء يحتاج إلى حالة React في المحرر. وعندما يجب أن تحفظ الكتلة ترميزًا ثابتًا يعمل من دون PHP. وكذلك عندما يكتب فريقك بالفعل React ويريد مكتبة @wordpress/components كاملة.
اتجهت النواة أيضًا نحو PHP. منذ WordPress 7.0، تُنشئ الكتلة المسجلة باستخدام autoRegister ودالة ردّ العرض عناصر تحكم للسمات النصية والرقمية وذات الأعداد الصحيحة والمنطقية، من دون JavaScript. وتظل النصوص المنسقة والكتل الداخلية والوسائط بحاجة إلى مكوّن تحرير هناك.
يعملان جنبًا إلى جنب
يسجل Blockstudio أي block.json لا يتضمن مفتاح blockstudio عبر register_block_type(). ابنِ كتلة create-block باستخدام wp-scripts، وضع مجلد المخرجات في دليل Blockstudio، وستُحمّل بجانب كتل Blockstudio.
ينسخ سجل Blockstudio مجلدات الكتل بين المشاريع، لذا يسري الأمر نفسه على المشاركة: ينتقل مجلد create-block مثل أي كتلة أخرى.
جنبًا إلى جنب
الكتلة نفسها API، وطريقتان لإنشاء جانب المحرر.
أسئلة عن create-block
ما الذي يسأل عنه مطورو الكتل قبل الاستغناء عن البناء.
هل ما زلت بحاجة إلى Node؟
ليس لكتل Blockstudio: تُعالج القوالب وSCSS واستيرادات وحدات ES في PHP. يحتاج مشروع create-block إلى Node لتشغيل wp-scripts، ويتطلب @wordpress/scripts 36.1.0 إصدار Node 22.22.2 أو إصدارًا أحدث ضمن سلسلة 22.x، أو 24.15.0 أو أحدث ضمن سلسلة 24.x، أو Node 26 وما بعده.
هل هو block.json نفسه؟
نعم. يقرأ Blockstudio ملف block.json قياسيًا ويضيف مفتاح blockstudio للحقول والإعدادات. ويظل معنى الاسم والعنوان والفئة والدعم وما إلى ذلك كما يحدده WordPress.
هل يمكنني الاحتفاظ بكتل create-block؟
نعم. ضع مخرجات البناء في دليل Blockstudio، وسيسجلها Blockstudio باستخدام register_block_type()، أو احتفظ بها في إضافتها الخاصة. أعد كتابة الكتلة فقط عندما تكون الحقول المُنشأة أنسب لها.
متى يكون create-block الخيار الأفضل؟
عندما تحتاج إلى سلوك في المحرر لا تستطيع الحقول والقوالب التعبير عنه، أو إلى مخرجات حفظ ثابتة، أو عندما يعمل فريقك بالفعل في React. أما Blockstudio فهو مناسب للكتل الكثيرة التي تتكون من حقول وترميز، حيث يكون مكوّن التحرير في معظمه مجرد تعليمات نمطية.
ماذا عن API التفاعلية؟
يدعمها كلاهما. يهيئ القالب التفاعلي في create-block إعداد supports.interactivity وviewScriptModule وعلامة البناء التجريبية للوحدات. في Blockstudio، تضبط التفاعلية ضمن مفتاح blockstudio، ويُحمّل script.js كوحدة مع خريطة الاستيراد المُنشأة تلقائيًا.
اكتب الكتلة، وتجاوز البناء
حقول في block.json، وقالب في PHP أو Twig أو Blade، وكتلة تظهر في المحرر بمجرد وجود المجلد.
المصادر، محدد
- دليل محرر الكتل: @wordpress/create-block
- دليل محرر الكتل: البدء باستخدام create-block
- دليل محرر الكتل: بنية ملفات الكتلة
- دليل محرر الكتل: التحرير والحفظ
- دليل محرر الكتل: الإهمال
- دليل محرر الكتل: العرض الثابت أو الديناميكي
- دليل محرر الكتل: التفاعلية API
- دليل محرر الكتل: @wordpress/scripts
- دليل محرر الكتل: @wordpress/create-block-interactive-template
- @wordpress/create-block على npm
- @wordpress/scripts على npm
- المصدر البرمجي لـ Gutenberg: create-block-interactive-template
- اجعل WordPress Core: تسجيل الكتل التي تعتمد على PHP فقط
حزمة الإضافات الرسمية
قوالب مواقع مميزة، وتعليمات نظام للذكاء الاصطناعي، ومجتمع Discord خاص. شراء لمرة واحدة وتحديثات مدى الحياة.
- أكثر من 500+ قالب موقع
- تعليمات نظام الذكاء الاصطناعي
- تحديثات مدى الحياة
- مجتمع Discord خاص