Ugrás a tartalomhoz

Blade

A Blade egy sablonmotor, amelyet elsősorban a Laravel keretrendszerrel használnak. Lehetővé teszi a fejlesztők számára, hogy kifejező, letisztult sablonokat készítsenek, olyan szintaxissal, amely egyszerűen és intuitívan bővíti a PHP működését. A Blade sablonok megkönnyítik a gyakori feladatokat, például az adatok megjelenítését és az elrendezés kezelését, így gördülékenyebbé teszik dinamikus weboldalak fejlesztését.

Beállítás

A Blockstudio-hez használt Blade sablonokhoz telepítse a Laravel illuminate/view csomagját a Composer használatával. A 8–12. verziók működnek.

Shell
composer require illuminate/view

Ezután adjon hozzá egy szűrőt a sablonja functions.php fájljához, hogy megadja a Blockstudio számára, hogyan jelenítse meg a Blade sablonokat. A Blockstudio automatikusan összegyűjti az összes Blade sablont, és hozzárendeli az útvonalukat, így az include-okhoz és elrendezésekhez használhatja a Blade pontozásos szintaxisát. A Blockstudio\Blade_Renderer a illuminate/view alapján állítja össze a nézetgyárat, a lefordított nézeteket pedig a rendszer ideiglenes könyvtárában gyorsítótárazza.

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

Az oldal korábbi verziói által használt jenssegers/blade burkoló nem működik a illuminate/view 10-es és újabb verzióival (“Target class [blade.compiler] does not exist”). Ha telepítve van, a Blade_Renderer helyette az általa magával hozott illuminate/view csomagot használja.

Sablonváltozók

A Blade sablonokban a következő változók érhetők el:

Változó Leírás
$a A $attributes elnevezése
$attributes A blokk attribútumai
$b A $block elnevezése
$block Magára a blokkra vonatkozó adatok
$c A $context elnevezése
$context A blokk kontextusa (e.g, bejegyzésazonosító, bejegyzéstípus cikluson belül)

Használat

Ha a Blade-t szeretné használni a blokk sablonjához, hozzon létre egy index.blade.php fájlt a blokk könyvtárában. A Blockstudio ezután automatikusan ezt a fájlt használja a blokk megjelenítéséhez.

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

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