Saltar al contenido

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

PHP
<h1>The block is aligned: <?php echo $block['align']; ?></h1>
<h1>The block is aligned: <?php echo $b['align']; ?></h1>

Twig

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:

JSON
{
  "$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:

JSON
{
  "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.