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.
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.
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.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>