Vai al contenuto

Campo del blocco

Il tipo di campo block consente di usare un altro blocco Blockstudio come attributo. I campi del blocco usato come riferimento vengono espansi in linea con lo stesso sistema idStructure e overrides dei campi personalizzati. Nei template, il valore restituisce l’output del blocco renderizzato.

Definizione

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}

Questo espande in linea i campi del blocco usato come riferimento. Se mytheme/card ha campi heading e content, il blocco ospitante ottiene gli attributi card_heading e card_content.

Uso nei template

Nei template, il valore del campo restituisce HTML renderizzato del blocco usato come riferimento:

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>

Formato restituito

Controllate cosa restituisce il valore del campo usando returnFormat:

Valore Descrizione
rendered (predefinito) L’output HTML renderizzato del blocco usato come riferimento
data Un array associativo dei valori degli attributi del blocco usato come riferimento
both Un oggetto con rendered (HTML) e data (valori degli attributi)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Sovrascritture

Sovrascrivete le singole proprietà del campo del blocco usato come riferimento, proprio come per i campi personalizzati:

JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "overrides": {
    "heading": { "default": "Welcome", "label": "Card Title" },
    "content": { "label": "Card Body" }
  }
}

Compatibilità

Il campo del blocco funziona sia con i blocchi normali sia con i blocchi componente. I blocchi componente sono particolarmente adatti, poiché sono progettati per il rendering programmatico.