Pole bloku
Typ pola block pozwala wskazać inny blok Blockstudio jako atrybut.
Pola wskazanego bloku są rozwijane w tekście za pomocą tego samego systemu
idStructure i overrides co pola niestandardowe.
W szablonach wartość zwraca wyrenderowany wynik bloku.
Definicja
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Pola wskazanego bloku są rozwijane w tekście. Jeśli mytheme/card zawiera
pola heading i content, blok nadrzędny otrzyma atrybuty card_heading i
card_content.
Użycie w szablonie
W szablonach wartość pola zwraca wyrenderowaną zawartość HTML wskazanego bloku:
<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 zwracanej wartości
Za pomocą returnFormat określ, co zwraca wartość pola:
| Wartość | Opis |
|---|---|
rendered |
(domyślnie) Wyrenderowany wynik HTML wskazanego bloku |
data |
Tablica asocjacyjna wartości atrybutów wskazanego bloku |
both |
Obiekt zawierający rendered (HTML) i data (wartości atrybutów) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Nadpisywanie
Nadpisuj pojedyncze właściwości pola wskazanego bloku, tak jak w przypadku pól niestandardowych:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Zgodność
Pole bloku działa zarówno ze zwykłymi blokami, jak i blokami komponentów. Bloki komponentów sprawdzają się tu naturalnie, ponieważ są przeznaczone do renderowania programowego.