Перейти к содержимому

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>