Pereiti prie turinio

Blade

Blade yra šablonų variklis, daugiausia naudojamas su Laravel karkasu. Jis leidžia kūrėjams kurti išraiškingus, aiškius šablonus naudojant sintaksę, kuri paprastai ir intuityviai išplečia PHP. Blade šablonai palengvina įprastas užduotis, pavyzdžiui, duomenų rodymą ir išdėstymo valdymą, todėl dinamiškų tinklalapių kūrimas tampa sklandesnis.

Nustatymas

Norėdami naudoti Blade šablonus su Blockstudio, įdiekite Laravel illuminate/view paketą naudodami Composer. Tinka 8–12 versijos.

Shell
composer require illuminate/view

Tada pridėkite filtrą prie temos failo functions.php, kad nurodytumėte Blockstudio, kaip atvaizduoti Blade šablonus. Blockstudio automatiškai surenka visus Blade šablonus ir susieja jų kelius, todėl įtraukoms ir maketams galite naudoti Blade taškų sintaksę. Blockstudio\Blade_Renderer surenka rodinių gamyklą iš illuminate/view ir talpina sukompiliuotus rodinius sistemos laikinajame kataloge.

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

Ankstesnėse šio puslapio versijose naudota jenssegers/blade apvalkalo klasė neveikia su illuminate/view 10 ir naujesnėmis versijomis („Target class [blade.compiler] does not exist“). Jei ji įdiegta, Blade_Renderer vietoj jos naudoja kartu pateiktą illuminate/view paketą.

Šablonų kintamieji

Jūsų Blade šablonuose bus pasiekiami šie kintamieji:

Kintamasis Aprašymas
$a $attributes pseudonimas
$attributes Bloko atributai
$b $block pseudonimas
$block Su pačiu bloku susiję duomenys
$c $context pseudonimas
$context Bloko kontekstas (e.g., įrašo ID, įrašo tipas ciklo metu)

Naudojimas

Norėdami naudoti Blade bloko šablonui, sukurkite index.blade.php failą bloko kataloge. Tada Blockstudio automatiškai naudos šį failą blokui atvaizduoti.

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

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