Treci la conținut

Blade

Blade este un motor de șabloane folosit în principal cu cadrul Laravel. Acesta le permite dezvoltatorilor să creeze șabloane expresive și clare, folosind o sintaxă care extinde PHP într-un mod simplu și intuitiv. Șabloanele Blade facilitează sarcini obișnuite precum afișarea datelor și gestionarea aspectului, contribuind la simplificarea dezvoltării paginilor web dinamice.

Configurare

Pentru a folosi șabloane Blade cu Blockstudio, instalați pachetul Laravel’s illuminate/view cu Composer. Sunt compatibile versiunile 8–12.

Shell
composer require illuminate/view

Apoi, adăugați un filtru în fișierul functions.php al temei pentru a-i indica lui Blockstudio cum să randeze șabloanele Blade. Blockstudio colectează automat toate șabloanele Blade și le asociază căile, permițându-vă să folosiți sintaxa cu puncte a Blade pentru includeri și aspecte. Blockstudio\Blade_Renderer asamblează fabrica de vizualizări din illuminate/view și memorează vizualizările compilate în directorul temporar al sistemului.

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

Învelișul jenssegers/blade folosit în versiunile anterioare ale acestei pagini nu funcționează cu illuminate/view 10 și versiunile ulterioare („Target class [blade.compiler] does not exist”). Dacă este instalat, Blade_Renderer folosește în schimb pachetul illuminate/view inclus de acesta.

Variabilele șablonului

Șabloanele Blade au acces la următoarele variabile:

Variabilă Descriere
$a Alias pentru $attributes
$attributes Atributele blocului
$b Alias pentru $block
$block Date despre blocul propriu-zis
$c Alias pentru $context
$context Contextul blocului (e.g, ID-ul articolului, tipul articolului când se află într-o buclă)

Utilizare

Pentru a folosi Blade în șablonul blocului, creați un fișier index.blade.php în directorul blocului. Blockstudio va folosi apoi automat acest fișier pentru a randa blocul.

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

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