Přejít k obsahu

Blade

Blade je šablonovací engine používaný především s frameworkem Laravel. Vývojářům umožňuje vytvářet přehledné a čisté šablony pomocí syntaxe, která jednoduchým a intuitivním způsobem rozšiřuje PHP. Šablony Blade usnadňují běžné úkoly, jako je zobrazování dat a správa rozvržení, a pomáhají zefektivnit vývoj dynamických webových stránek.

Nastavení

Chcete-li používat šablony Blade s Blockstudio, nainstalujte balíček illuminate/view od Laravel pomocí Composer. Fungují verze 8 až 12.

Shell
composer require illuminate/view

Poté přidejte filtr do souboru functions.php svého motivu, který nástroji Blockstudio určí, jak vykreslovat šablony Blade. Blockstudio automaticky shromáždí všechny šablony Blade a namapuje jejich cesty, takže můžete pro include a rozvržení používat tečkovou syntaxi Blade. Blockstudio\Blade_Renderer sestaví továrnu pohledů z illuminate/view a ukládá zkompilované pohledy do systémového dočasného adresáře.

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

Obalovací vrstva jenssegers/blade, kterou používaly dřívější verze této stránky, nefunguje s illuminate/view 10 a novějšími (“Target class [blade.compiler] does not exist”). Pokud je nainstalovaná, Blade_Renderer místo ní použije balíček illuminate/view, který přibalila.

Proměnné šablony

Šablony Blade budou mít přístup k následujícím proměnným:

Proměnná Popis
$a Alias pro $attributes
$attributes Atributy bloku
$b Alias pro $block
$block Data související se samotným blokem
$c Alias pro $context
$context Kontext bloku (např. e.g, ID příspěvku, typ příspěvku při použití ve smyčce)

Použití

Chcete-li pro šablonu bloku použít Blade, vytvořte v adresáři bloku soubor index.blade.php. Blockstudio pak tento soubor automaticky použije k vykreslení bloku.

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

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