Preskoči na vsebino

Polje bloka

Vrsta polja block vam omogoča, da se kot atribut sklicujete na drug blok Blockstudio. Polja bloka, na katerega se sklicujete, so razširjena v vrstici z istim sistemom idStructure in overrides kot polja po meri. V predlogah vrednost vrne izrisani izhod bloka.

Opredelitev

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}

S tem se polja bloka, na katerega se sklicujete, razširijo v vrstici. Če ima mytheme/card polji heading in content, gostiteljski blok dobi atributa card_heading in card_content.

Uporaba v predlogah

V predlogah vrednost polja vrne izrisani HTML bloka, na katerega se sklicujete:

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>

Oblika vrnjene vrednosti

Z nastavitvijo returnFormat določite, kaj vrne vrednost polja:

Vrednost Opis
rendered (privzeto) Izrisani izhod bloka HTML, na katerega se sklicujete
data Asociativno polje vrednosti atributov bloka, na katerega se sklicujete
both Objekt z vrednostjo rendered (HTML) in data (vrednosti atributov)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Preglasitve

Preglasite posamezne lastnosti polja iz bloka, na katerega se sklicujete, enako kot pri poljih po meri:

JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "overrides": {
    "heading": { "default": "Welcome", "label": "Card Title" },
    "content": { "label": "Card Body" }
  }
}

Združljivost

Polje bloka deluje z navadnimi bloki in bloki komponent. Bloki komponent so naravna izbira, saj so zasnovani za programsko izrisovanje.