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
{
"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:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<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) |
{
"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:
{
"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.