Blade
Bladeは主にLaravelフレームワークで使われるテンプレートエンジンです。PHPを拡張したシンプルで直感的な構文を使って、表現力豊かで読みやすいテンプレートを作成できます。Bladeテンプレートは、データ表示やレイアウト管理などの一般的な作業を容易にし、動的なウェブページの開発を効率化します。
セットアップ
BlockstudioでBladeテンプレートを使うには、ComposerでLaravelのilluminate/viewパッケージをインストールします。バージョン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以降では動作しません(「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は、このファイルを使ってブロックを自動的にレンダリングします。
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>