Siirry sisältöön

Blade

Blade on mallinnuskoneisto, jota käytetään pääasiassa Laravel-kehyksen kanssa. Sen avulla kehittäjät voivat luoda ilmeikkäitä ja selkeitä malleja syntaksilla, joka laajentaa PHP-syntaksia yksinkertaisella ja intuitiivisella tavalla. Blade-mallit helpottavat yleisiä tehtäviä, kuten tietojen näyttämistä ja asettelun hallintaa, mikä sujuvoittaa dynaamisten verkkosivujen kehitystä.

Määritys

Jos haluat käyttää Blade-malleja Blockstudio-ympäristössä, asenna Laravel-paketti illuminate/view-paketin kautta komennolla Composer. Versiot 8–12 toimivat.

Shell
composer require illuminate/view

Lisää seuraavaksi teeman functions.php-tiedostoon suodatin, joka kertoo Blockstudio-järjestelmälle, miten Blade-mallit renderöidään. Blockstudio kerää automaattisesti kaikki Blade-mallit ja yhdistää niiden polut, joten voit käyttää Blade-järjestelmän piste-merkintätapaa sisällytyksissä ja asetteluissa. Blockstudio\Blade_Renderer kokoaa näkymätehtaan kohteesta illuminate/view ja tallentaa käännetyt näkymät järjestelmän väliaikaishakemistoon.

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

Tämän sivun aiemmissa versioissa käytetty jenssegers/blade-kääre ei toimi illuminate/view 10:n tai sitä uudempien versioiden kanssa (“Kohdeluokkaa [blade.compiler] ei ole olemassa”). Jos se on asennettu, Blade_Renderer käyttää sen sijaan mukana tullutta illuminate/view-pakettia.

Mallimuuttujat

Blade-mallit voivat käyttää seuraavia muuttujia:

Muuttuja Kuvaus
$a Kohteen $attributes alias
$attributes Lohkon määritteet
$b Kohteen $block alias
$block Itse lohkoon liittyvät tiedot
$c Kohteen $context alias
$context Lohkon konteksti (e.g, artikkelin tunnus ja artikkelityyppi silmukassa)

Käyttö

Jos haluat käyttää Blade-mallia lohkossasi, luo lohkon hakemistoon index.blade.php-tiedosto. Blockstudio käyttää sitten tätä tiedostoa automaattisesti lohkon renderöintiin.

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

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