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

الأصول

يوفر Blockstudio مسارًا لمعالجة الأصول في كتلِك دون أي إعداد. ضع ملفات CSS أو SCSS أو JavaScript بجوار كتلتك، وسيتم تجميعها وتصغيرها وإضافتها تلقائيًا.

فحص أصول الكتلة

يعيد bs_block_assets('theme/card') أصول الواجهة الأمامية ولوحة المحرر المكتشفة لكتلة Blockstudio مسجّلة. استدعِه بعد تسجيل الكتلة، عند init أو بعده. تُعيد الكتل غير المعروفة، والكتل غير التابعة إلى Blockstudio، والكتل التي لا تحتوي على أصول القيمة []. لا تعرض الدالة المساعدة الكتلة، ولا تضيف أي شيء إلى قائمة التحميل، ولا تبدأ عملية التجميع.

PHP
$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() لفحص تعريفات الحقول المسجّلة.