Aller au contenu

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

JSON
{
  "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é :

Twig
<div class="hero">
  <h1>{{ a.title }}</h1>
  {{ a.card }}
</div>
PHP
<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)
JSON
{
  "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 :

JSON
{
  "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.