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