Pular para o conteúdo

Campo de bloco

O tipo de campo block permite referenciar outro bloco Blockstudio como atributo. Os campos do bloco referenciado são expandidos em linha usando o mesmo sistema idStructure e overrides dos campos personalizados. Nos modelos, o valor retorna a saída renderizada do bloco.

Definição

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

Isso expande em linha os campos do bloco referenciado. Se mytheme/card tiver campos heading e content, o bloco anfitrião receberá os atributos card_heading e card_content.

Uso em modelos

Nos modelos, o valor do campo retorna o HTML renderizado do bloco referenciado:

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>

Formato de retorno

Controle o que o valor do campo retorna usando returnFormat:

Valor Descrição
rendered (padrão) A saída HTML renderizada do bloco referenciado
data Um array associativo dos valores dos atributos do bloco referenciado
both Um objeto com rendered (HTML) e data (valores dos atributos)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Substituições

Substitua propriedades individuais do campo do bloco referenciado, assim como nos campos personalizados:

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

Compatibilidade

O campo de bloco funciona tanto com blocos comuns quanto com blocos de componentes. Os blocos de componentes são uma escolha natural, pois foram projetados para renderização programática.