コンテンツへスキップ

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からビュー・ファクトリーを構成し、コンパイル済みビューをシステムの一時ディレクトリにキャッシュします。

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>