Blokfelt
Felttypen block lader dig referere til en anden Blockstudio-blok som en attribut.
Felterne i den refererede blok udvides inline med samme
system for idStructure og overrides som brugerdefinerede felter.
I skabeloner returnerer værdien blokkens gengivne output.
Definition
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Dette udvider felterne i den refererede blok inline. Hvis mytheme/card har
felterne heading og content, får værtsblokken attributterne card_heading og
card_content.
Brug i skabeloner
I skabeloner returnerer feltværdien det gengivne HTML fra den refererede blok:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Returformat
Styr, hvad feltværdien returnerer, med returnFormat:
| Værdi | Beskrivelse |
|---|---|
rendered |
(standard) Den gengivne HTML-output fra den refererede blok |
data |
Et associativt array med den refererede bloks attributværdier |
both |
Et objekt med rendered (HTML) og data (attributværdier) |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Tilsidesættelser
Tilsidesæt enkelte feltegenskaber fra den refererede blok på samme måde som for brugerdefinerede felter:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Fungerer med
Blokfeltet fungerer med både almindelige blokke og komponentblokke. Komponentblokke passer naturligt, fordi de er designet til programmatisk gengivelse.