Blade
Blade är en mallmotor som främst används med ramverket Laravel. Den gör det möjligt för utvecklare att skapa uttrycksfulla, rena mallar med en syntax som utökar PHP på ett enkelt och intuitivt sätt. Blade-mallar förenklar vanliga uppgifter som datapresentation och layout hantering, vilket effektiviserar utvecklingen av dynamiska webbsidor.
Konfiguration
Om du vill använda Blade-mallar med Blockstudio installerar du paketet illuminate/view från Laravel med Composer. Versionerna 8 till 12 fungerar.
composer require illuminate/view
Lägg sedan till ett filter i temats functions.php-fil för att tala om för Blockstudio hur Blade-mallar ska renderas. Blockstudio samlar automatiskt in alla Blade-mallar och mappar deras sökvägar, så att du kan använda Blades punktsyntax för inkluderingar och layouter. Blockstudio\Blade_Renderer bygger vyfabriken från illuminate/view och cachelagrar kompilerade vyer i systemets temporära katalog.
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
);
Omslaget jenssegers/blade som tidigare versioner av den här sidan använde fungerar inte med illuminate/view 10 och senare (”Målklassen [blade.compiler] finns inte”). Om det är installerat använder Blade_Renderer i stället paketet illuminate/view som följde med det.
Mallvariabler
Dina Blade-mallar har tillgång till följande variabler:
| Variabel | Beskrivning |
|---|---|
$a |
Ett alias för $attributes |
$attributes |
Blockets attribut |
$b |
Ett alias för $block |
$block |
Data som rör själva blocket |
$c |
Ett alias för $context |
$context |
Blockets kontext (e.g, inläggs-ID, inläggstyp i en loop) |
Användning
Om du vill använda Blade för blockmallen skapar du en index.blade.php-fil i blockets katalog. Blockstudio använder sedan automatiskt den här filen för att rendera blocket.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>