Saltar al contenido

Campo de bloque

El tipo de campo block permite hacer referencia a otro bloque Blockstudio como atributo. Los campos del bloque al que se hace referencia se expanden en línea con el mismo sistema de idStructure y overrides que los campos personalizados. En las plantillas, el valor devuelve la salida renderizada del bloque.

Definición

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

Esto expande en línea los campos del bloque al que se hace referencia. Si mytheme/card tiene campos heading y content, el bloque contenedor obtiene los atributos card_heading y card_content.

Uso en plantillas

En las plantillas, el valor del campo devuelve el HTML renderizado del bloque al que se hace referencia:

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 devolución

Controle lo que devuelve el valor del campo mediante returnFormat:

Valor Descripción
rendered (predeterminado) La salida HTML renderizada del bloque al que se hace referencia
data Un array asociativo con los valores de los atributos del bloque al que se hace referencia
both Un objeto con rendered (HTML) y data (valores de atributos)
JSON
{
  "id": "card",
  "type": "block",
  "block": "mytheme/card",
  "idStructure": "card_{id}",
  "returnFormat": "data"
}

Anulaciones

Anule propiedades de campos individuales del bloque referenciado, igual que con los campos personalizados:

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

Compatible con

El campo de bloque funciona tanto con bloques normales como con bloques de componentes. Los bloques de componentes encajan de forma natural, ya que están diseñados para el renderizado programático.