الأصول
يوفر Blockstudio مسارًا لمعالجة الأصول في كتلِك دون أي إعداد. ضع ملفات CSS أو SCSS أو JavaScript بجوار كتلتك، وسيتم تجميعها وتصغيرها وإضافتها تلقائيًا.
- تسجيل الأصول: اصطلاحات تسمية الملفات وسلوك الإضافة
- المعالجة: تجميع SCSS واستيراد وحدات ES والتصغير
- حقل الكود: تحرير الكود مباشرةً عبر نوع حقل الكود
فحص أصول الكتلة
يعيد bs_block_assets('theme/card') أصول الواجهة الأمامية ولوحة المحرر المكتشفة لكتلة Blockstudio مسجّلة. استدعِه بعد تسجيل الكتلة، عند init أو بعده. تُعيد الكتل غير المعروفة، والكتل غير التابعة إلى Blockstudio، والكتل التي لا تحتوي على أصول القيمة []. لا تعرض الدالة المساعدة الكتلة، ولا تضيف أي شيء إلى قائمة التحميل، ولا تبدأ عملية التجميع.
$assets = bs_block_assets('theme/card');
// Each entry has this shape:
[
'type' => 'style',
'handle' => 'blockstudio-theme-card-style-css',
'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
'inline' => false,
'scope' => ['frontend', 'editor'],
'html' => '<link ...>',
];
- تكون
typeهيstyleلـ CSS وmoduleلـ JavaScript. تستخدم أصول JavaScript القائمة على الملفات في Blockstudio وحدات ES، بما في ذلك النصوص البرمجية المضمّنة. - يكون
handleمعرّف الأصل الثابت الذي يستخدمه عارض Blockstudio وعامل التصفيةblockstudio/assets/disable. لا يلزم إضافته إلى قائمة التحميل في WordPress. - تكون
urlقيمة URL المحسومة للأصل المجمّع الحالي، بما في ذلك إصداره، أو URL المصدر عند عدم وجود ملف مجمّع. وتكونnullللأصول المضمّنة. - يميّز
inlineبين مخرجات<style>/<script>المضمّنة والملفات الخارجية. - يسرد
scopeالسياقات التي ينطبق عليها الأصل:frontendوeditorللملفات المشتركة، وسياقًا واحدًا فقط لملفات العرض أو المحرر. - يحتوي
htmlعلى الوسم الجاهز للاستخدام من عارض الأصول المعتاد. ويُتعامل بالطريقة نفسها مع المحتوى المضمّن وCSS المحدد النطاق وطبقات الأنماط UI وعوامل التصفية التي تعطل العرض وقت التنفيذ، كما يحدث مع مخرجات الكتل العادية.
يتم استبعاد الملفات SCSS المفقودة أو الفارغة أو المعطّلة أو غير المجمّعة. كما تُستبعد الأصول التي جرى إدراجها في قائمة الانتظار باستخدام WordPress والمخصّصة للمسؤول والمستند الأصل في محرر الكتل. تقتصر القائمة على الملفات المكتشفة الخاصة بالكتلة نفسها. وهي لا تشمل سلسلة التبعيات كاملة: فقد تعتمد الكتل المتداخلة وقيم حقول الشيفرة والمقابض المدرجة باستخدام WordPress وعمليات الاستيراد CSS وTailwind وأوقات التشغيل المشتركة لـ UI/Interactivity على المحتوى المعروض. استخدم Render::document()معاينة مستقلة مكتملة. استخدم bs_block_fields() لفحص تعريفات الحقول المسجّلة.