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

الوسائط

توجد صور القالب خارج مكتبة الوسائط، لذا لا يعرف WordPress أبعادها، وتتغير تخطيطات الصفحات مع تحميل كل صورة غير منسقة. يعالج Blockstudio هذه المشكلة بإنشاء بيان لبيانات التعريف، ومساعد للقوالب يدرج الأبعاد الفعلية دائمًا، ومحمل كسول اختياري.

تصيير الصور

يصيّر bs_media_image() أصول القالب مع عرض وارتفاع فعليين ونسبة أبعاد محجوزة:

PHP
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
    'class' => 'hero-media',
    'sources' => [
        ['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
    ],
]);
?>

يكون الإخراج figure.blockstudio-media مع aspect-ratio مضمن حول img يتضمن قيم width وheight وloading وdecoding فعلية.

يقبل src مسارًا نسبيًا إلى القالب، أو مسارًا مطلقًا، أو URL كاملًا؛ ويتولى attachmentId صور مكتبة الوسائط. ويعطّل eager التحميل الكسول لما يظهر أعلى الجزء المرئي، بينما يُدرج sources عنصر <picture> بالبدائل المحددة.

يُدرج المساعد دائمًا قيم العرض والارتفاع ونسبة الأبعاد المعروفة عند توفر بيانات التعريف. ولا يستخدم الوضع الكسول إلا الفئات والسمات والمعرّفات العامة الخاصة بـblockstudio-*.

بيان بيانات التعريف

تأتي الأبعاد من assets/media.json، الذي ينشئه Blockstudio\Media_Metadata_Builder في خطوة بناء أو يدويًا:

PHP
use Blockstudio\Media_Metadata_Builder;

(new Media_Metadata_Builder())->write(
    get_stylesheet_directory(),
    true
);

ينشئ هذا بيانات تعريف حتمية لأصول القالب، ويضيف اختياريًا مرفقات WordPress عند تمرير الوسيط الثاني. أعد إنشاءها كلما تغيرت الملفات ضمن assets/.

يعيد Media_Metadata_Builder::build( string $root ) البيان دون كتابته؛ أما write() فيحفظه. ويمسح Blockstudio\Media_Metadata::reset() ذاكرة العمليات بعد إعادة البناء، وهو ما تحتاج إليه عمليات البناء طويلة الأمد قبل التصيير باستخدام بيانات التعريف الجديدة.

التحميل الكسول

تتحكم إعدادات performance.media في محمل الواجهة الأمامية:

JSON
{
  "performance": {
    "media": {
      "lazy": true,
      "skeleton": true,
      "metadata": true,
      "rootMargin": "300px"
    }
  }
}

عند تفعيل lazy، ينتقل URL الفعلي إلى data-src خلف عنصر نائب بأبعاد صحيحة، ويحمّله محمل Blockstudio القائم على التقاطع عند اقتراب الصورة من إطار العرض، مع تحميل rootMargin مسبقًا. ويعرض skeleton العنصر النائب المدمج أثناء التحميل، ويُعلن metadata عن استخدام assets/media.json.

يُفعّل ملفا الأداء speed وstrict محمل البيانات افتراضيًا؛ ويُبقيه compat معطّلًا. يمكن لكل قيمة فرعية تجاوز الإعداد الافتراضي لملفها.

الإعدادات

جدول الخيارات الكامل لـperformance.media.

التصيير المسبق الثابت

بيانات تعريف الوسائط هي الخطوة الثانية ضمن ترتيب اعتماد الإنتاج.