WordPress 7.2: API de estilos según el estado del bloque - A laptop screen showing the WordPress block inspector with a style state dropdown set to Ho

WordPress 7.2: API de estilos según el estado del bloque

WordPress 7.2 expone una API pública en @wordpress/block-editor para que los controles de estilos de un bloque lean y escriban el atributo style según el estado que esté seleccionado en el editor. La nota de desarrollo publicada el 18 de noviembre de 2026 detalla cuatro puntos de entrada —dos selectores y dos funciones—, dos slots para alojar controles propios y un helper para obtener media queries de viewport. El alcance es acotado: es una herramienta para quienes desarrollan bloques, no un cambio de interfaz para quien edita contenido.

El problema que resuelve es concreto. Un bloque con controles de estilo propios —un panel de dimensiones, un selector de color, un campo de tipografía— necesita saber si el usuario está editando el estado predeterminado, el hover, el foco o la versión mobile, y guardar el valor en la rama correcta del atributo style. La API expone ambas operaciones de forma pública.

¿Qué es la API for style state-aware block styling controls?

Es un conjunto de selectores y funciones de @wordpress/block-editor que permite a un control de estilos conocer el estado activo del bloque y guardar valores en esa rama del atributo style, sea un pseudo estado como hover o un viewport como mobile. La nota oficial aclara que los cuatro puntos de entrada funcionan tanto con estados de viewport como con pseudo estados.

Punto de entradaQué resuelve
getSelectedBlockStyleStateSelector: devuelve el estado de estilo seleccionado para un bloque.
hasSelectedBlockStyleStateSelector: indica si hay un estado distinto del predeterminado activo.
getStyleForStateFunción: devuelve el objeto de estilo correspondiente a ese estado.
setStyleForStateFunción: devuelve el atributo style con el nuevo valor aplicado a ese estado.

Los dos primeros se consultan desde el store del editor con useSelect; los otros dos se importan y trabajan sobre objetos. La diferencia importa en la práctica: el resultado de setStyleForState se pasa a setAttributes para guardarlo en el bloque.

¿Cómo hago que mi control de bloque lea el estado hover o mobile seleccionado?

Hay que pedirle el estado al store con getSelectedBlockStyleState, pasando el clientId del bloque, y usar ese valor como clave para leer y escribir con getStyleForState y setStyleForState. El patrón que muestra la nota oficial combina useSelect para obtener el estado, lee el estilo actual de ese estado y lo reescribe con setAttributes, conservando el resto del objeto mediante spread.

import {
 getStyleForState,
 setStyleForState,
 store as blockEditorStore,
} from '@wordpress/block-editor';
import { useSelect } from '@wordpress/data';

const selectedState = useSelect(
 ( select ) =>
 select( blockEditorStore ).getSelectedBlockStyleState( clientId ),
 [ clientId ]
);
const stateStyle = getStyleForState( attributes.style, selectedState ) || {};
setAttributes( {
 style: setStyleForState( attributes.style, selectedState, {
 ...stateStyle,
 dimensions: {
 ...stateStyle.dimensions,
 minHeight: '50vh',
 },
 } ),
} );

El detalle que importa es el spread: el patrón de la nota oficial combina el objeto de estilo existente con el nuevo valor. En el atributo del bloque, los pseudo estados se guardan con prefijo : —:hover, :focus, :focus-visible, :active— y las ramas responsivas se anidan como claves de breakpoint, de modo que una combinación de mobile con hover queda en dos niveles. Para condicionar la interfaz —mostrar un aviso, cambiar el texto de ayuda—, hasSelectedBlockStyleState evita comparar cadenas a mano.

¿Cómo agrego controles propios al panel de estilos cuando hay un estado activo?

Con el slot style-state. Por defecto, los controles del inspector se ocultan cuando hay un estado de estilo seleccionado, así que un control propio tiene que declararse dentro de <InspectorControls group="style-state"> para aparecer en ese contexto. Para la barra de herramientas existe el mismo grupo en <BlockControls group="style-state">, aunque en ese caso solo aplica a estados de viewport.

<InspectorControls group="style-state">
 <MyStyleStateControl />
</InspectorControls>

<BlockControls group="style-state">
 <MyViewportControl />
</BlockControls>

Hay una asimetría que conviene tener presente: la nota aclara que los slots predeterminados de la barra de herramientas no se ocultan en pseudo estados. Es decir, durante hover los controles normales del bloque siguen visibles junto al control propio de viewport. Si eso molesta en la interfaz, la decisión de esconderlos queda del lado del bloque, no de la API.

¿Cómo obtengo las media queries de mobile y tablet en WordPress?

@wordpress/global-styles-engine exporta getViewportMediaQueries, que recibe un objeto con los cortes y devuelve las cadenas de media query listas para usar en una integración de viewport. Sin argumentos devuelve los valores del core, con 480px para mobile y 782px para tablet. En PHP existe el helper equivalente, wp_get_viewport_media_queries.

import { getViewportMediaQueries } from '@wordpress/global-styles-engine';

const mediaQueries = getViewportMediaQueries( {
 mobile: '480px',
 tablet: '782px',
} );
// {
// '@mobile': '@media (width <= 480px)',
// '@tablet': '@media (480px < width <= 782px)',
// }

Del lado del servidor, el helper acepta los mismos cortes y un segundo arreglo de opciones. include_desktop viene en false por defecto; si se activa, agrega el tramo superior:

<?php
$media_queries = wp_get_viewport_media_queries(
 array(
 'mobile' => '480px',
 'tablet' => '782px',
 ),
 array(
 'include_desktop' => true,
 )
);
// Incluye @mobile y @tablet, más:
// '@desktop' => '@media (width > 782px)'

¿Qué pasa del lado del front end con los estilos por estado?

La API del editor tiene una contraparte en PHP que genera el CSS. El commit en el repositorio de Gutenberg muestra el recorrido: lib/block-supports/states.php procesa los pseudo estados soportados por el bloque y ahora también las ramas responsivas, incluidas las combinaciones anidadas como mobile con hover. Cada regla se agrupa en la media query que corresponde, y las declaraciones de estado se emiten con !important porque necesitan ganarle a los estilos en línea y a las clases de preset del tipo has-accent-3-background-color.

WordPress 7.2 diagrama explicativo

El CSS se apoya en una clase única calculada con hash (wp-states- más ocho caracteres) que se agrega al elemento estilizado, no al contenedor. Además, el store deduplica reglas por selector: dos instancias del bloque con estilos de estado idénticos comparten la misma clase y emiten una sola regla. Ese commit figura como backport para 7.1 (PR #78384 de Gutenberg, con su equivalente en wordpress-develop), así que la generación de CSS responsivo por instancia ya venía de esa versión; lo que agrega 7.2 es la API del lado del editor. Tema relacionado: si al refactorizar rompés enlaces, te va a servir esta guía de redirecciones.

¿Qué límites tiene y de dónde viene?

La base llegó con WordPress 7.1, y la nota que la documenta se publicó el 5 de agosto de 2026. Esa nota presenta los pseudo estados hover, focus, focus-visible y active limitados a los bloques Botón y Navigation Link, definibles en theme.json dentro del objeto del bloque y anidables en estados responsivos. También describe los estados custom, por ahora restringidos a theme.json y al bloque de enlace de navegación, con el prefijo - —el caso de -current— y su selector declarado en selectors.states del block.json. Más sobre esto en sobre el bypass de autenticación de Shipo que cubrimos.

Dos ajustes de editor administran la interfaz. blockStatesEditingEnabled, que por defecto es true, oculta el selector de estados del inspector de bloque y las opciones de pseudo estados en Global Styles cuando se pone en false. Los viewports se controlan aparte, con responsiveEditingEnabled. La aclaración importante es que ambos ajustes gobiernan solo la edición: los estilos ya guardados en theme.json, en Global Styles o en el atributo style de un bloque se siguen aplicando igual en el editor y en el sitio. Ampliamos el tema en y en la falla de seguridad del plugin Motors.

De ahí se desprende una consecuencia para el desarrollo de bloques: la generación de CSS por instancia corre para bloques con soporte de pseudo estados configurado. Declarar controles con esta API no habilita estilos que el bloque no soporte.

¿Cuándo sale WordPress 7.2 y qué novedades trae?

La nota del 18 de noviembre de 2026 no anuncia fecha de lanzamiento ni cronograma: documenta el comportamiento de una API que llega con 7.2. Lo que sí queda confirmado en las fuentes es el alcance técnico —los cuatro puntos de entrada, los slots style-state y los helpers de media queries en JavaScript y PHP— y el antecedente de 7.1, donde se publicaron los estados de estilo y su generación de CSS por instancia.

Un criterio práctico para verificarlo

Como propuesta de verificación editorial, y sin atribuirla a la fuente, un recorrido razonable en un entorno de pruebas es este: tomar el bloque Botón, activar el estado hover en el inspector, agregar el control propio dentro del slot style-state y comprobar tres cosas. Primero, que getSelectedBlockStyleState devuelve el estado esperado al cambiar de pestaña. Segundo, que el atributo style del bloque guarda el valor en la rama del estado y no en la predeterminada. Tercero, que el front end emite la clase con hash y, cuando el valor se define en mobile, la regla aparece agrupada en la media query correspondiente.

Ese recorrido permite decidir con datos si conviene migrar controles existentes a la API, pero no alcanza para concluir nada sobre rendimiento: la nota no incluye mediciones y el mecanismo de deduplicación de reglas no viene con cifras comparativas.

Fuentes

Volver a

Novedades

Publicaciones relacionadas