Pāriet uz saturu

Bloka lauks

block lauka tips ļauj atsaukties uz citu Blockstudio bloku kā atribūtu. Atsauktā bloka lauki tiek iekļauti, izmantojot to pašu idStructure un overrides sistēmu, ko pielāgotie lauki. Veidnēs vērtība atgriež renderēto bloka izvadi.

Definīcija

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

Tādējādi atsauktā bloka lauki tiek iekļauti. Ja mytheme/card ir lauki heading un content, resursdatora bloks saņem atribūtus card_heading un card_content.

Izmantošana veidnēs

Veidnēs lauka vērtība atgriež atsauktā bloka renderēto HTML:

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>

Atgriežamais formāts

Nosakiet, ko lauka vērtība atgriež, izmantojot returnFormat:

Vērtība Apraksts
rendered (noklusējums) Atsauktā bloka renderētā HTML izvade
data Asociatīvs masīvs ar atsauktā bloka atribūtu vērtībām
both Objekts ar rendered (HTML) un data (atribūtu vērtībām)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Pārrakstīšana

Pārrakstiet atsevišķu lauku rekvizītus no atsauktā bloka tāpat kā pielāgotiem laukiem:

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

Darbojas ar

Bloka lauks darbojas gan ar parastajiem blokiem, gan ar komponentu blokiem. Komponentu bloki ir piemēroti šim nolūkam, jo tie ir paredzēti programmatiskai renderēšanai.