Blade
Blade is een template-engine die voornamelijk wordt gebruikt met het framework Laravel. Hiermee kunnen ontwikkelaars expressieve, overzichtelijke templates maken met een syntaxis die PHP op een eenvoudige en intuïtieve manier uitbreidt. Blade-templates vereenvoudigen veelvoorkomende taken zoals gegevens weergeven en lay-outs beheren, zodat dynamische webpagina’s efficiënter kunnen worden ontwikkeld.
Instellen
Om Blade-templates te gebruiken met Blockstudio, installeert u het pakket illuminate/view van Laravel met Composer. Versies 8 tot en met 12 werken.
composer require illuminate/view
Voeg vervolgens een filter toe aan het bestand functions.php van uw thema om Blockstudio te vertellen hoe Blade-templates moeten worden gerenderd. Blockstudio verzamelt automatisch alle Blade-templates en koppelt hun paden, zodat u de puntnotatie van Blade kunt gebruiken voor includes en lay-outs. Blockstudio\Blade_Renderer bouwt de view factory op basis van illuminate/view en slaat gecompileerde views op in de tijdelijke systeemmap.
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
);
De jenssegers/blade-wrapper die in eerdere versies van deze pagina werd gebruikt, werkt niet met illuminate/view 10 en hoger (“Target class [blade.compiler] does not exist”). Als deze is geïnstalleerd, gebruikt Blade_Renderer in plaats daarvan het meegeleverde pakket illuminate/view.
Templatevariabelen
Uw Blade-templates hebben toegang tot de volgende variabelen:
| Variabele | Beschrijving |
|---|---|
$a |
Een alias voor $attributes |
$attributes |
De attributen van het blok |
$b |
Een alias voor $block |
$block |
Gegevens over het blok zelf |
$c |
Een alias voor $context |
$context |
De context van het blok (e.g, bericht-ID, berichttype binnen een lus) |
Gebruik
Als u Blade wilt gebruiken voor de template van uw blok, maakt u een bestand index.blade.php aan in de map van uw blok. Blockstudio gebruikt dit bestand vervolgens automatisch om het blok te renderen.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>