Preskočiť na obsah

Blade

Blade je šablónovací nástroj používaný predovšetkým s frameworkom Laravel. Umožňuje vývojárom vytvárať prehľadné a čisté šablóny pomocou syntaxe, ktorá jednoduchým a intuitívnym spôsobom rozširuje PHP. Šablóny Blade uľahčujú bežné úlohy, ako je zobrazovanie údajov a správa rozloženia, a pomáhajú tak zefektívniť vývoj dynamických webových stránok.

Nastavenie

Ak chcete používať šablóny Blade s Blockstudio, nainštalujte balík illuminate/view od Laravel pomocou Composer. Fungujú verzie 8 až 12.

Shell
composer require illuminate/view

Potom do súboru functions.php svojej témy pridajte filter, ktorý určí, ako má Blockstudio vykresľovať šablóny Blade. Blockstudio automaticky zhromaždí všetky šablóny Blade a namapuje ich cesty, takže pri vkladaní a rozložení môžete používať bodkovú syntax Blade. Blockstudio\Blade_Renderer zostaví továreň pohľadov z illuminate/view a skompilované pohľady ukladá do dočasného systémového adresára.

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

Obal jenssegers/blade, ktorý používali staršie verzie tejto stránky, nefunguje v illuminate/view 10 a novších (“Cieľová trieda [blade.compiler] neexistuje”). Ak je nainštalovaný, Blade_Renderer namiesto neho používa balík illuminate/view, ktorý priniesol.

Premenné šablóny

Vaše šablóny Blade budú mať prístup k nasledujúcim premenným:

Premenná Opis
$a Alias pre $attributes
$attributes Atribúty bloku
$b Alias pre $block
$block Údaje súvisiace so samotným blokom
$c Alias pre $context
$context Kontext bloku (e.g, ID príspevku, typ príspevku v cykle)

Použitie

Ak chcete použiť Blade pre šablónu bloku, vytvorte v adresári bloku súbor index.blade.php. Blockstudio potom tento súbor automaticky použije na vykreslenie bloku.

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

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