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>