useBlockProps
De forma predeterminada, Gutenberg debe crear un contenedor alrededor de los bloques para hacerlos interactivos dentro del editor. Esto puede resultar problemático para algunos tipos de bloque, como los contenedores o las columnas, ya que el marcado será distinto en el editor y en el frontend. El hook useBlockProps permite marcar un elemento de la plantilla del bloque como elemento raíz, lo que garantiza la paridad del marcado entre el editor y el frontend.
Uso
Añade simplemente el atributo useBlockProps al elemento raíz de tu bloque.
<div useBlockProps class="my-class">
<!--
This element will be rendered
as the root element of your block
in Gutenberg.
-->
</div>
Blockstudio combinará automáticamente las clases y los atributos del editor (clases de alineación, etc.) con lo que esté definido en las plantillas de bloque. Para ello, utiliza internamente get_block_wrapper_attributes.
El filtro blockstudio/blocks/components/use_block_props/render se aplica al contenedor tanto en la ruta de renderización del frontend como en la del editor. Por tanto, las clases añadidas por un tema o una integración por instancia también aparecen en el lienzo del editor y en el marcado guardado del frontend.
Salida:
<div class="my-class wp-block-your-block-name alignright">
</div>
Consideraciones
Enlaces en el editor
Blockstudio impide la navegación mediante enlaces dentro del editor de bloques, incluidos
target="_blank", los clics con modificadores, los clics con el botón central y la activación mediante el teclado.
Los eventos de clic siguen llegando a Gutenberg, por lo que los clics normales seleccionan el bloque.
RichText sigue siendo editable. Esto se aplica con o sin useBlockProps,
incluso si un ancla se usa como elemento raíz del bloque.
Los enlaces de la interfaz pública y los comandos del menú contextual del navegador no cambian. No es necesario quitar los enlaces de las plantillas ni comprobar $isEditor.
Elemento raíz
Como solo puede haber un elemento raíz en una plantilla de bloque, al usar useBlockProps, la plantilla debe tener un único elemento raíz. Por ejemplo, lo siguiente no funcionará y Gutenberg creará un contenedor alrededor de la plantilla.
<div useBlockProps>
First root element.
</div>
<span>
Second root element.
</span>
Del mismo modo, useBlockProps solo se puede usar una vez por plantilla de bloque.
Signo @
Blockstudio convierte la plantilla del bloque en código React válido dentro de Gutenberg mediante html-react-parser. Esto conlleva una limitación: no se puede usar el carácter @ dentro del nombre de un atributo HTML.
Librerías como Alpine.js usan los caracteres @ para definir directivas en elementos HTML.
<button useBlockProps @click="console.log('hi')">
Click me
</button>
Dentro de Gutenberg, este atributo @click se eliminará del elemento. (Por supuesto, seguirá funcionando en el frontend).
Para solucionar este problema, puedes usar la sintaxis alternativa que ofrece Alpine.js.
<button useBlockProps x-on:click="console.log('hi')">
Click me
</button>
Lo anterior funcionará dentro de Gutenberg y en el frontend.
Clases del cuerpo del lienzo
Cuando assets.reset.enabled está activo, Blockstudio también copia al lienzo del editor las clases saneadas que devuelve el filtro body_class de WordPress. Así, los selectores del tema como .brand-a .site-card funcionan en ambos lugares.
Filtra la lista final de clases cuando el editor necesita un conjunto más reducido:
add_filter('blockstudio/editor/canvas/body_class', function(array $classes) {
return array_values(array_diff($classes, ['logged-in']));
});
Este filtro solo controla las clases que se copian al lienzo del editor. No modifica las clases del cuerpo del frontend.