Към съдържанието

Blade

Blade е шаблонен енджин, използван основно с рамката Laravel. Той позволява на разработчиците да създават изразителни и изчистени шаблони със синтаксис, който разширява PHP по прост и интуитивен начин. Шаблоните на Blade улесняват обичайни задачи като показване на данни и управление на оформленията, което опростява разработката на динамични уебстраници.

Настройка

За да използвате шаблони Blade с Blockstudio, инсталирайте пакета illuminate/view на Laravel с 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, ID на публикацията и тип на публикацията в цикъл)

Употреба

За да използвате 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>