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

Blade

Blade هو محرك قوالب يُستخدم أساسًا مع إطار عمل Laravel. يتيح للمطورين إنشاء قوالب واضحة وأنيقة باستخدام صياغة توسّع PHP بطريقة بسيطة وبديهية. وتسهّل قوالب Blade المهام الشائعة مثل عرض البيانات وإدارة التخطيطات، ما يساعد على تبسيط تطوير صفحات ويب ديناميكية.

الإعداد

لاستخدام قوالب Blade مع Blockstudio، ثبّت حزمة Laravel المسماة illuminate/view باستخدام Composer. تعمل الإصدارات من 8 إلى 12.

سطر الأوامر
composer require illuminate/view

بعد ذلك، أضف عامل تصفية إلى ملف functions.php الخاص بالقالب لإعلام Blockstudio بكيفية عرض قوالب Blade. يجمع Blockstudio جميع قوالب Blade تلقائيًا ويربط مساراتها، ما يتيح لك استخدام صياغة النقاط في Blade للتضمينات والتخطيطات. وينشئ Blockstudio\Blade_Renderer مصنع العرض من illuminate/view ويخزّن العروض المُجمّعة مؤقتًا في الدليل المؤقت للنظام.

PHP
add_filter(
    "blockstudio/blocks/render",
    function ($value, $block) {
        $blockPath = $block->path;
        if (str_ends_with($blockPath, ".blade.php")) {
            if (!Blockstudio\Blade_Renderer::available()) {
                return 'Error: Blade is not installed. Please run "composer require illuminate/view".';
            }
            $data = $block->blockstudio["data"];
            $bladeData = $data["blade"];

            return Blockstudio\Blade_Renderer::render(
                $bladeData["path"],
                $bladeData["templates"][$block->name],
                [
                    "a" => $data["attributes"],
                    "attributes" => $data["attributes"],
                    "b" => $data["block"],
                    "block" => $data["block"],
                    "c" => $data["context"],
                    "context" => $data["context"],
                ]
            );
        }

        return $value;
    },
    10,
    2
);

لا يعمل غلاف jenssegers/blade الذي استخدمته الإصدارات السابقة من هذه الصفحة مع illuminate/view 10 وما بعده (“Target class [blade.compiler] does not exist”). وإذا كان مثبتًا، يستخدم Blade_Renderer حزمة illuminate/view التي أضافها معه.

متغيرات القالب

ستتمكن قوالب Blade من الوصول إلى المتغيرات التالية:

المتغير الوصف
$a اسم بديل لـ $attributes
$attributes سمات الكتلة
$b اسم بديل لـ $block
$block بيانات متعلقة بالكتلة نفسها
$c اسم بديل لـ $context
$context سياق الكتلة (e.g، ومعرّف المنشور ونوعه عند وجودها في حلقة)

الاستخدام

لاستخدام Blade لقالب الكتلة، أنشئ ملف index.blade.php في مجلد الكتلة. وسيستخدم Blockstudio هذا الملف تلقائيًا لعرض الكتلة.

PHP
<div class="my-block">
  @if($a['title'])
    <h2>{{ $a['title'] }}</h2>
  @endif

  @if($a['content'])
    <p>{{ $a['content'] }}</p>
  @endif
</div>