Blade
Blade je mehanizem za predloge, ki se uporablja predvsem z ogrodjem Laravel. Razvijalcem omogoča ustvarjanje izraznih in preglednih predlog s sintakso, ki na preprost in intuitiven način razširja PHP. Predloge Blade olajšajo pogosta opravila, kot sta prikaz podatkov in upravljanje postavitve, ter tako poenostavijo razvoj dinamičnih spletnih strani.
Nastavitev
Če želite uporabljati predloge Blade z Blockstudio, namestite paket illuminate/view za Laravel z Composer. Delujejo različice od 8 do 12.
composer require illuminate/view
Nato v datoteko functions.php svoje teme dodajte filter, ki bo Blockstudio povedal, kako izrisati predloge Blade. Blockstudio samodejno zbere vse predloge Blade in preslika njihove poti, zato lahko za vključitve in postavitve uporabite zapis s pikami, značilen za Blade. Blockstudio\Blade_Renderer sestavi tovarno pogledov iz illuminate/view in predpomni prevedene poglede v začasnem sistemskem imeniku.
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
);
Ovoj jenssegers/blade, ki so ga uporabljale starejše različice te strani, ne deluje z illuminate/view 10 in novejšimi (»Ciljni razred [blade.compiler] ne obstaja«). Če je nameščen, Blade_Renderer namesto njega uporabi paket illuminate/view, ki ga je ta prinesel s seboj.
Spremenljivke predlog
Predloge Blade imajo dostop do naslednjih spremenljivk:
| Spremenljivka | Opis |
|---|---|
$a |
Vzdevek za $attributes |
$attributes |
Atributi bloka |
$b |
Vzdevek za $block |
$block |
Podatki, povezani s samim blokom |
$c |
Vzdevek za $context |
$context |
Kontekst bloka (e.g, ID objave in vrsta objave znotraj zanke) |
Uporaba
Če želite za predlogo bloka uporabiti Blade, ustvarite datoteko index.blade.php v imeniku bloka. Blockstudio bo to datoteko nato samodejno uporabil za izris bloka.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>