Ga naar de inhoud

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.

Shell
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.

PHP
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.

PHP
<div class="my-block">
  @if($a['title'])
    <h2>{{ $a['title'] }}</h2>
  @endif

  @if($a['content'])
    <p>{{ $a['content'] }}</p>
  @endif
</div>