Tema de bloques 06: variaciones y estilos por bloque con propósito

Define variaciones de bloques que aceleren edición y mantengan identidad visual sin obligar a CSS duplicado.

En un block theme, no necesitas crear un bloque custom para cada variante visual: muchas veces basta con variaciones y estilos bien definidos.

Cuando no existe esta capa, el editor termina improvisando combinaciones que rompen consistencia entre páginas.

La estrategia profesional es diseñar pocas variantes útiles, con nombre claro y caso de uso concreto dentro del proyecto.

Estas variantes deben vivir alineadas con theme.json para compartir tokens de color, tipografía y espaciado.

  • Una variación debe resolver un patrón editorial repetido, no un capricho puntual.
  • Si un bloque se usa siempre con la misma intención visual (por ejemplo CTA destacado), una variación reduce fricción al editar.
  • Si el cambio es demasiado específico para una sola página, conviene resolverlo localmente y no inflar el sistema global.
  • Antes de crear una nueva variante, revisa si ya puedes lograrlo con presets de theme.json y estilos existentes.
  • Variaciones para usos repetidos y estables.

Cuándo crear una variación y cuándo no

Una variación debe resolver un patrón editorial repetido, no un capricho puntual.

Si un bloque se usa siempre con la misma intención visual (por ejemplo CTA destacado), una variación reduce fricción al editar.

Si el cambio es demasiado específico para una sola página, conviene resolverlo localmente y no inflar el sistema global.

Antes de crear una nueva variante, revisa si ya puedes lograrlo con presets de theme.json y estilos existentes.

  • Variaciones para usos repetidos y estables.
  • Nombres funcionales, no ambiguos.
  • Evitar catálogo infinito de estilos parecidos.
  • Documentar cuándo usar cada variante.

Registrar estilo de bloque desde el tema

Con register_block_style puedes ofrecer opciones visuales rápidas sin crear bloques nuevos.

Aplicar estilos coherentes con theme.json

El estilo visual de la variante debe apoyarse en tokens del sistema, no en colores hardcodeados arbitrarios.

Define reglas CSS para la clase generada por el estilo del bloque y referencia presets del tema cuando sea posible.

Comprueba en editor y frontend que la variante mantiene contraste y spacing correctos con contenido real.

Si una variante necesita ajustes por bloque, usa styles.blocks en theme.json para centralizar comportamiento.

WordPress Themes Pro
26

Tema de bloques 06: variaciones y estilos por bloque con propósito

Define variaciones de bloques que aceleren edición y mantengan identidad visual sin obligar a CSS duplicado.

Código del tema: register_block_style

📘 Teoría

Cuándo crear una variación y cuándo no

Una variación debe resolver un patrón editorial repetido, no un capricho puntual.

Si un bloque se usa siempre con la misma intención visual (por ejemplo CTA destacado), una variación reduce fricción al editar.

Si el cambio es demasiado específico para una sola página, conviene resolverlo localmente y no inflar el sistema global.

Antes de crear una nueva variante, revisa si ya puedes lograrlo con presets de theme.json y estilos existentes.

  • Variaciones para usos repetidos y estables.
  • Nombres funcionales, no ambiguos.
  • Evitar catálogo infinito de estilos parecidos.
  • Documentar cuándo usar cada variante.

Registrar estilo de bloque desde el tema

Con register_block_style puedes ofrecer opciones visuales rápidas sin crear bloques nuevos.

Registrar estilo para core/group
<?php
add_action('init', function () {
  register_block_style('core/group', [
    'name'  => 'card-soft',
    'label' => __('Card Soft', 'mi-tema-bloques'),
  ]);
});

Aplicar estilos coherentes con theme.json

El estilo visual de la variante debe apoyarse en tokens del sistema, no en colores hardcodeados arbitrarios.

1

Define reglas CSS para la clase generada por el estilo del bloque y referencia presets del tema cuando sea posible.

2

Comprueba en editor y frontend que la variante mantiene contraste y spacing correctos con contenido real.

3

Si una variante necesita ajustes por bloque, usa styles.blocks en theme.json para centralizar comportamiento.

CSS para estilo is-style-card-soft
.wp-block-group.is-style-card-soft {
  border: 1px solid var(--wp--preset--color--ink, #0f172a33);
  background: var(--wp--preset--color--surface, #f8fafc);
  border-radius: 14px;
  padding: 1rem;
  box-shadow: 0 10px 25px rgba(2, 6, 23, 0.08);
}

🧪 Aprende probando

Ejemplo Ejemplo: grupo con estilo Card Soft Markup de bloque que activa la variación registrada en el tema.

🏁 Retos

Reto Reto: completar registro de estilo Completa el registro con nombre y etiqueta para un estilo de core/button.

🧰 Recursos

Test

Comprueba tus conocimientos con un test sobre WordPress Themes Pro.

Test de WordPress Themes Pro

¿Qué es esto?

Soy Cristian Eslava y a veces hago webs para procrastinar yo y vosotros 😉.

Esta la hice en febrero de 2026 para facilitar el aprendizaje de mis alumnxs. Aprender desarrollo web practicando. La idea es que crezca semanalmente con nuevos temas, tests y retos.

Inspirado en MDN, en W3Schools, en Codepen, en el crack de Manz y en mil sitios de documentación sobre desarrollo web. Quería aportar además de bloques teóricos con ejemplos, la gamificación de los retos y el sistema de test que ya tenía en culTest .

Si te gustó, si no te gustó, si quieres saludarme, o invitarme a 🍻 no dudes en escribirme en cristianeslava@gmail.com .