Blade
Blade er en skabelonmotor, der primært bruges sammen med Laravel-frameworket. Den gør det muligt for udviklere at oprette udtryksfulde, rene skabeloner med en syntaks, der udvider PHP på en enkel og intuitiv måde. Blade-skabeloner gør almindelige opgaver som visning af data og layoutstyring lettere og effektiviserer udviklingen af dynamiske websider.
Opsætning
Hvis du vil bruge Blade-skabeloner med Blockstudio, skal du installere Laravels illuminate/view-pakke med Composer. Version 8 til og med 12 virker.
composer require illuminate/view
Tilføj derefter et filter til din temas functions.php-fil, så Blockstudio ved, hvordan Blade-skabeloner skal gengives. Blockstudio indsamler automatisk alle Blade-skabeloner og tilknytter deres stier, så du kan bruge Blades punktnotation til includes og layouts. Blockstudio\Blade_Renderer sammensætter view-fabrikken fra illuminate/view og cacher kompilerede views i systemets midlertidige mappe.
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
);
Wrapperen jenssegers/blade, som tidligere versioner af denne side brugte, virker ikke med illuminate/view 10 og nyere (“Target class [blade.compiler] does not exist”). Hvis den er installeret, bruger Blade_Renderer i stedet den illuminate/view-pakke, den medbragte.
Skabelonvariabler
Dine Blade-skabeloner har adgang til følgende variabler:
| Variabel | Beskrivelse |
|---|---|
$a |
Et alias for $attributes |
$attributes |
Blokkens attributter |
$b |
Et alias for $block |
$block |
Data relateret til selve blokken |
$c |
Et alias for $context |
$context |
Blokkens kontekst (e.g, indlægs-id, indlægstype i en løkke) |
Brug
Hvis du vil bruge Blade til din blokskabelon, skal du oprette en index.blade.php-fil i blokkens mappe. Blockstudio bruger derefter automatisk denne fil til at gengive blokken.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>