Pereiti prie turinio

Bloko laukas

block lauko tipas leidžia nurodyti kitą Blockstudio bloką kaip atributą. Nurodyto bloko laukai išplečiami tiesiogiai pagal tą pačią idStructure ir overrides sistemą kaip pasirinktiniai laukai. Šablonuose reikšmė grąžina atvaizduotą bloko išvestį.

Apibrėžimas

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

Taip nurodyto bloko laukai išplečiami tiesiogiai. Jei mytheme/card yra heading ir content laukai, pagrindinis blokas gauna atributus card_heading ir card_content.

Naudojimas šablonuose

Šablonuose lauko reikšmė grąžina atvaizduotą nurodyto bloko 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>

Grąžinamas formatas

Nustatykite, ką grąžina lauko reikšmė, naudodami returnFormat:

Reikšmė Aprašymas
rendered (numatytoji) Atvaizduota nurodyto bloko HTML išvestis
data Asociatyvusis masyvas su nurodyto bloko atributų reikšmėmis
both Objektas su rendered (HTML) ir data (atributų reikšmės)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Pakeitimai

Pakeiskite atskirų laukų savybes nurodytame bloke, kaip ir pasirinktiniuose laukuose:

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

Suderinamumas

Bloko laukas veikia ir su įprastais blokais, ir su komponentų blokais. Komponentų blokai yra tinkamas pasirinkimas, nes jie skirti programiniam atvaizdavimui.