Câmp de bloc
Tipul de câmp block vă permite să folosiți un alt bloc Blockstudio ca atribut. Câmpurile blocului referențiat sunt extinse inline folosind același sistem idStructure și overrides ca în câmpurile personalizate. În șabloane, valoarea returnează rezultatul redat al blocului.
Definiție
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Aceasta extinde inline câmpurile blocului referențiat. Dacă mytheme/card are câmpurile heading și content, blocul gazdă primește atributele card_heading și card_content.
Utilizarea în șabloane
În șabloane, valoarea câmpului returnează rezultatul redat al blocului HTML referențiat:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Formatul valorii returnate
Controlați ce returnează valoarea câmpului folosind returnFormat:
| Valoare | Descriere |
|---|---|
rendered |
(implicit) Rezultatul HTML redat al blocului referențiat |
data |
Un tablou asociativ cu valorile atributelor blocului referențiat |
both |
Un obiect cu rendered (HTML) și data (valorile atributelor) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Suprascrieri
Suprascrieți proprietățile individuale ale câmpurilor din blocul referențiat, la fel ca în cazul câmpurilor personalizate:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Compatibilitate
Câmpul blocului funcționează atât cu blocuri obișnuite, cât și cu blocuri componentă. Blocurile componentă se potrivesc în mod firesc, deoarece sunt proiectate pentru redare programatică.