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 і кешує скомпільовані подання у системному тимчасовому каталозі.
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 і новішими (“Цільовий клас [blade.compiler] не існує”). Якщо його встановлено, Blade_Renderer натомість використовує пакет illuminate/view, який він додав.
Змінні шаблонів
У ваших шаблонах Blade будуть доступні такі змінні:
| Змінна | Опис |
|---|---|
$a |
Псевдонім для $attributes |
$attributes |
Атрибути блоку |
$b |
Псевдонім для $block |
$block |
Дані, пов’язані з самим блоком |
$c |
Псевдонім для $context |
$context |
Контекст блоку (e.g, ID запису, тип запису під час циклу) |
Використання
Щоб використовувати Blade для шаблону блоку, створіть файл index.blade.php у каталозі блоку. Після цього Blockstudio автоматично використовуватиме цей файл для рендерингу блоку.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>