Atributos de bloque
Las variables $attributes o $a solo dan acceso a los datos registrados en la propiedad blockstudio. Para acceder a datos estándar de bloque de WordPress, como la alineación o la tipografía, use las variables $block o $b.
Renderizado
PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>
Twig
<h1>The block is aligned: {{ block.align }}</h1>
<h1>The block is aligned: {{ b.align }}</h1>
Establecer valores predeterminados
IDs de campo reservados
Los atributos controlados por WordPress no deben declararse como campos Blockstudio con el mismo ID de nivel superior. anchor, className, style, lock y metadata están reservados, al igual que los atributos internos blockstudio, __BLOCKSTUDIO_KEY y blockEditingMode de Blockstudio.
Los módulos WordPress activados también reservan los nombres de sus atributos: align, backgroundColor, textColor, gradient, fontSize, fontFamily, layout, borderColor, shadow y ariaLabel, según corresponda. Una declaración nativa de uno de esos atributos también reserva ese nombre. Así se evita, por ejemplo, sustituir la cadena align de core por el objeto de opciones de un campo de selección.
Los campos en conflicto se omiten al registrarlos y se anotan en blockstudio/error/logged (y en el registro de depuración WordPress si está activado), indicando el bloque y el campo. No se registran sus controles del editor, manejadores de almacenamiento ni definiciones de renderizado. Cambie el nombre del campo a headingAlign o colóquelo dentro de un grupo con nombre, como presentation, para generar presentation_align. Los campos de las filas del repetidor permanecen dentro de su fila y no generan conflictos de nivel superior. Un campo align normal sigue siendo válido cuando se desactiva la compatibilidad con la alineación y no existe ningún atributo nativo align.
Al actualizar un bloque existente que tenga un conflicto, cambie el nombre de su campo y migre los valores guardados del campo al nuevo ID. Blockstudio no cambia silenciosamente el contenido almacenado ni elimina la compatibilidad con WordPress.
Valores predeterminados de atributos nativos
Para establecer un valor predeterminado para propiedades WordPress como align, añada una clave default dentro de la clave attributes:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/block",
"title": "Native Block",
"icon": "star-filled",
"description": "Native Block.",
"supports": {
"align": ["left", "center", "right"]
},
"attributes": {
"align": {
"type": "string",
"default": "center"
}
},
"blockstudio": true
}
Datos de bloque disponibles
La variable $block / $b contiene:
| Propiedad | Descripción |
|---|---|
name |
Nombre del bloque (e.g, my-theme/my-block) |
title |
Título del bloque |
dir |
Ruta del directorio del bloque |
url |
URL del directorio del bloque |
align |
Valor de alineación (si supports.align está activado) |
className |
Clase CSS personalizada (si supports.customClassName está activado) |
anchor |
Ancla/ID de HTML (si supports.anchor está activado) |
Compatibilidad con WordPress
Active las funciones de bloque de WordPress mediante la propiedad supports:
{
"supports": {
"align": true,
"anchor": true,
"customClassName": true,
"color": {
"background": true,
"text": true
},
"spacing": {
"margin": true,
"padding": true
},
"typography": {
"fontSize": true,
"lineHeight": true
}
}
}
Consulte la documentación sobre compatibilidad de bloques de WordPress para ver todas las opciones disponibles.