Gå til indhold

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.

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

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
);

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.

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

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