Treci la conținut

Câmp de bloc

Tipul de câmp block vă permite să folosiți un alt bloc Blockstudio ca atribut. Câmpurile blocului referențiat sunt extinse inline folosind același sistem idStructure și overrides ca în câmpurile personalizate. În șabloane, valoarea returnează rezultatul redat al blocului.

Definiție

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

Aceasta extinde inline câmpurile blocului referențiat. Dacă mytheme/card are câmpurile heading și content, blocul gazdă primește atributele card_heading și card_content.

Utilizarea în șabloane

În șabloane, valoarea câmpului returnează rezultatul redat al blocului HTML referențiat:

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>

Formatul valorii returnate

Controlați ce returnează valoarea câmpului folosind returnFormat:

Valoare Descriere
rendered (implicit) Rezultatul HTML redat al blocului referențiat
data Un tablou asociativ cu valorile atributelor blocului referențiat
both Un obiect cu rendered (HTML) și data (valorile atributelor)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Suprascrieri

Suprascrieți proprietățile individuale ale câmpurilor din blocul referențiat, la fel ca în cazul câmpurilor personalizate:

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

Compatibilitate

Câmpul blocului funcționează atât cu blocuri obișnuite, cât și cu blocuri componentă. Blocurile componentă se potrivesc în mod firesc, deoarece sunt proiectate pentru redare programatică.