Champ de bloc
Le type de champ block vous permet de référencer un autre bloc Blockstudio comme
attribut. Les champs du bloc référencé sont développés en ligne à l’aide du même
système idStructure et overrides que les champs personnalisés.
Dans les modèles, la valeur renvoie le rendu du bloc.
Définition
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Les champs du bloc référencé sont développés en ligne. Si mytheme/card possède des champs
heading et content, le bloc hôte reçoit les attributs card_heading et
card_content.
Utilisation dans un modèle
Dans les modèles, la valeur du champ renvoie le rendu HTML du bloc référencé :
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Format de retour
Définissez ce que renvoie la valeur du champ avec returnFormat :
| Valeur | Description |
|---|---|
rendered |
(par défaut) Rendu HTML du bloc référencé |
data |
Tableau associatif des valeurs des attributs du bloc référencé |
both |
Objet contenant rendered (HTML) et data (valeurs des attributs) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Remplacements
Remplacez les propriétés de champ individuellement à partir du bloc référencé, comme pour les champs personnalisés :
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Compatible avec
Le champ de bloc fonctionne avec les blocs classiques comme avec les blocs de composants. Les blocs de composants sont particulièrement adaptés, car ils sont conçus pour le rendu programmatique.