Gå til indhold

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

JSON
{
  "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:

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>

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)
JSON
{
  "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:

JSON
{
  "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.