Pāriet uz saturu

Blade

Blade ir veidņu dzinis, ko galvenokārt izmanto kopā ar Laravel ietvaru. Tas ļauj izstrādātājiem veidot izteiksmīgas un tīras veidnes, izmantojot sintaksi, kas vienkāršā un intuitīvā veidā paplašina PHP. Blade veidnes atvieglo bieži veicamus uzdevumus, piemēram, datu attēlošanu un izkārtojuma pārvaldību, palīdzot vienkāršot dinamisku tīmekļa lapu izstrādi.

Iestatīšana

Lai izmantotu Blade veidnes ar Blockstudio, instalējiet Laravel nodrošināto illuminate/view pakotni, izmantojot Composer. Der versijas no 8 līdz 12.

Apvalks
composer require illuminate/view

Pēc tam pievienojiet filtru sava motīva failam functions.php, lai norādītu Blockstudio, kā renderēt Blade veidnes. Blockstudio automātiski apkopo visas Blade veidnes un sasaista to ceļus, ļaujot izmantot Blade punktu pierakstu iekļāvumiem un izkārtojumiem. Blockstudio\Blade_Renderer izveido skatu rūpnīcu no illuminate/view un saglabā kompilētos skatus sistēmas pagaidu direktorijā.

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

jenssegers/blade iesaiņotājs, kas tika izmantots šīs lapas iepriekšējās versijās, nedarbojas ar illuminate/view 10 un jaunākām versijām (“Mērķa klase [blade.compiler] neeksistē”). Ja tas ir instalēts, Blade_Renderer tā vietā izmanto komplektā iekļauto illuminate/view pakotni.

Veidņu mainīgie

Jūsu Blade veidnēm būs pieejami šādi mainīgie:

Mainīgais Apraksts
$a $attributes aizstājvārds
$attributes Bloka atribūti
$b $block aizstājvārds
$block Ar pašu bloku saistītie dati
$c $context aizstājvārds
$context Bloka konteksts (e.g, ieraksta ID un ieraksta tips, ja tas atrodas ciklā)

Lietošana

Lai izmantotu Blade bloka veidnei, izveidojiet failu index.blade.php bloka direktorijā. Pēc tam Blockstudio automātiski izmantos šo failu bloka renderēšanai.

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

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