跳转到正文

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>