Blade
A Blade egy sablonmotor, amelyet elsősorban a Laravel keretrendszerrel használnak. Lehetővé teszi a fejlesztők számára, hogy kifejező, letisztult sablonokat készítsenek, olyan szintaxissal, amely egyszerűen és intuitívan bővíti a PHP működését. A Blade sablonok megkönnyítik a gyakori feladatokat, például az adatok megjelenítését és az elrendezés kezelését, így gördülékenyebbé teszik dinamikus weboldalak fejlesztését.
Beállítás
A Blockstudio-hez használt Blade sablonokhoz telepítse a Laravel illuminate/view csomagját a Composer használatával. A 8–12. verziók működnek.
composer require illuminate/view
Ezután adjon hozzá egy szűrőt a sablonja functions.php fájljához, hogy megadja a Blockstudio számára, hogyan jelenítse meg a Blade sablonokat. A Blockstudio automatikusan összegyűjti az összes Blade sablont, és hozzárendeli az útvonalukat, így az include-okhoz és elrendezésekhez használhatja a Blade pontozásos szintaxisát. A Blockstudio\Blade_Renderer a illuminate/view alapján állítja össze a nézetgyárat, a lefordított nézeteket pedig a rendszer ideiglenes könyvtárában gyorsítótárazza.
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
);
Az oldal korábbi verziói által használt jenssegers/blade burkoló nem működik a illuminate/view 10-es és újabb verzióival (“Target class [blade.compiler] does not exist”). Ha telepítve van, a Blade_Renderer helyette az általa magával hozott illuminate/view csomagot használja.
Sablonváltozók
A Blade sablonokban a következő változók érhetők el:
| Változó | Leírás |
|---|---|
$a |
A $attributes elnevezése |
$attributes |
A blokk attribútumai |
$b |
A $block elnevezése |
$block |
Magára a blokkra vonatkozó adatok |
$c |
A $context elnevezése |
$context |
A blokk kontextusa (e.g, bejegyzésazonosító, bejegyzéstípus cikluson belül) |
Használat
Ha a Blade-t szeretné használni a blokk sablonjához, hozzon létre egy index.blade.php fájlt a blokk könyvtárában. A Blockstudio ezután automatikusan ezt a fájlt használja a blokk megjelenítéséhez.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>