Aller au contenu

Blade

Blade est un moteur de modèles principalement utilisé avec le framework Laravel. Il permet aux développeurs de créer des modèles expressifs et clairs grâce à une syntaxe qui étend PHP de façon simple et intuitive. Les modèles Blade facilitent les tâches courantes comme l’affichage des données et la gestion de la mise en page, ce qui simplifie le développement de pages Web dynamiques.

Configuration

Pour utiliser les modèles Blade avec Blockstudio, installez le package illuminate/view de Laravel avec Composer. Les versions 8 à 12 sont compatibles.

Shell
composer require illuminate/view

Ensuite, ajoutez un filtre au fichier functions.php de votre thème pour indiquer à Blockstudio comment générer les modèles Blade. Blockstudio collecte automatiquement tous les modèles Blade et associe leurs chemins, ce qui vous permet d’utiliser la syntaxe avec points de Blade pour les inclusions et les mises en page. Blockstudio\Blade_Renderer assemble la fabrique de vues à partir de illuminate/view et met en cache les vues compilées dans le répertoire temporaire du système.

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

Le wrapper jenssegers/blade utilisé dans les versions précédentes de cette page ne fonctionne plus avec illuminate/view 10 et les versions ultérieures (« Target class [blade.compiler] does not exist »). S’il est installé, Blade_Renderer utilise plutôt le package illuminate/view qu’il a apporté.

Variables de modèle

Vos modèles Blade ont accès aux variables suivantes :

Variable Description
$a Alias de $attributes
$attributes Attributs du bloc
$b Alias de $block
$block Données liées au bloc lui-même
$c Alias de $context
$context Contexte du bloc (e.g., ID de l’article, type d’article dans une boucle)

Utilisation

Pour utiliser Blade comme modèle de votre bloc, créez un fichier index.blade.php dans le répertoire du bloc. Blockstudio utilisera alors automatiquement ce fichier pour générer le bloc.

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

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