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

التحميل

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

يحول هذا دون إرسال طلب عرض منفصل لكل كتلة محفوظة عند تحميل المحرر لأول مرة. وتُضمّن الكتل Blockstudio المتداخلة داخل الأنماط المتزامنة ومراجع core/block القابلة لإعادة الاستخدام في بيانات التحميل المسبق.

عمليات العرض الاحتياطية

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

قد تتسبب طلبات العارض الاحتياطية الكثيرة في مهلات زمنية أو تأخير أصول المحرر الأخرى على المضيفات الأبطأ. ويمكن تعطيل التحميل للكتل التي لا تحتاج إلى معاينة فورية.

تهيئة الوسائط

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

عندما يخزّن الحقل قيمة بصيغة إرجاع URL، يتعامل معها Blockstudio بوصفها URL ولا يحاول حلّها عبر نقطة نهاية الوسائط WordPress. إذا لم تتوفر بيانات المرفق في بيانات التحميل المسبق، فقد يطلب المحرر /wp/v2/media كخيار احتياطي.

التعطيل

يمكن تعطيل تحميل قالب العرض بتعيين المفتاح disableLoading في block.json إلى true. سيُعرض عنصر نائب بدلًا من قالب الكتلة. وستظل جميع إعدادات الحقول متاحة عند فتح الشريط الجانبي.

JSON
{
  "name": "blockstudio/native",
  "title": "Native Block",
  "category": "text",
  "icon": "star-filled",
  "description": "Native Blockstudio block.",
  "blockstudio": {
    "blockEditor": {
      "disableLoading": true
    }
  }
}

بدلًا من ذلك، يمكن تعطيل تحميل الكتل عالميًا باستخدام الإعداد blockEditor/disableLoading:

PHP
add_filter('blockstudio/settings/block_editor/disable_loading', function() {
  return true;
});