WordPress 7.2: qué cambia en el editor y cómo migrar - A developer's laptop screen showing a JSX snippet where the prop __experimentalGroup is renamed

WordPress 7.2: qué cambia en el editor y cómo migrar

WordPress 7.2 se publica en fase beta y el equipo de Core ya difundió, el 18 de noviembre de 2026, la dev note que ordena los cambios menores del editor. Son cinco ajustes y la mayoría no interrumpe la carga del sitio ni dispara un error evidente: se manifiestan como controles que aparecen en el panel equivocado, CSS que de golpe se aplica en el front end o handlers que reciben un evento distinto. Esa ausencia de ruido es lo que los hace fáciles de pasar por alto.

Las dev notes se escriben durante la beta y se compilan en la Field Guide al llegar la release candidate; las fuentes no informan una fecha de lanzamiento final de 7.2. Conviene leer los cambios según lo que exigen del código, no según el orden en que aparecen en el documento.

Por dónde empezar

  • Obligatorio si tu bloque usa __experimentalGroup: renombrar la prop a group. No hace falta chequeo de versión.
  • Revisión antes de actualizar: qué CSS adicional quedó cargado en bloques que renderiza su bloque padre y que hasta ahora no llegaba al front end.
  • Revisión de filtros: cualquier handler de teclado, input o composición que agregues al bloque Párrafo vía editor.BlockListBlock.
  • Sin acción: registry.subscribe con un store que todavía no está registrado.
  • Acción solo si seguís usando el componente: el import de la hoja de estilos de __experimentalImageEditor.

La prop __experimentalGroup desaparece: controles que caen en el panel equivocado

La prop se elimina de InspectorControls y de InspectorControls.Slot (#83171). Se había estabilizado como group en WordPress 6.2 (#47105) y desde entonces pasarla emitía un aviso de deprecación que fijaba la 6.4 como versión de remoción. La eliminación efectiva llegó recién en 7.2: entre el aviso y el corte pasaron varias versiones, y es habitual que un warning que se repite durante tanto tiempo deje de leerse.

El resultado no es un error fatal, y por eso puede llegar a producción sin que nadie lo note. Los controles pasan a renderizarse en el grupo por defecto, junto al resto de los ajustes del bloque: un control pensado para el panel Advanced aparece fuera de él, y un ToolsPanelItem destinado a un panel como Typography se muestra sin ese panel alrededor.

Como group funciona desde 6.2, la corrección es un renombre sin condicionales. Solo necesitás un camino alternativo si tu plugin todavía declara compatibilidad con versiones anteriores a 6.2, que es el único escenario donde conservar la prop vieja tiene sentido.

// Antes
<InspectorControls __experimentalGroup="advanced">
 <TextControl label={ __( 'Custom ID' ) } value={ id } onChange={ setId } />
</InspectorControls>

// Después
<InspectorControls group="advanced">
 <TextControl label={ __( 'Custom ID' ) } value={ id } onChange={ setId } />
</InspectorControls>

Para el panel Advanced existe un atajo: InspectorAdvancedControls aplica group="advanced" por su cuenta. Sirve únicamente para ese panel; si el control pertenece a Typography, Color o cualquier otro, hay que pasar el slug correspondiente en group.

El CSS adicional ahora llega a bloques que renderiza el bloque padre

Antes de 7.2, el CSS cargado en el panel Advanced de un bloque se perdía en el front end cuando su propio bloque padre lo renderizaba. El caso documentado es el Navigation Link dentro del bloque Navegación: Core generaba los estilos solo para los bloques del contenido interno regular, y como Navegación carga sus inner blocks desde un post de menú, esos bloques se salteaban el paso.

Desde 7.2 el CSS se genera cuando cada bloque se renderiza, sin importar cómo lo haya cargado el padre. Los bloques que ya funcionaban no cambian y su CSS no se duplica. No hay que tocar código, pero sí revisar: reglas que antes se ignoraban ahora se aplican, y pueden aparecer estilos que nunca se vieron en producción.

Ejemplo hipotético, solo para ilustrar el riesgo: un Navigation Link con CSS adicional en el panel Advanced que declare text-transform: uppercase y un color de fondo distinto. Hasta la 7.1 ese CSS no llegaba al front end y el enlace se veía igual que el resto del menú. Con 7.2 empieza a aplicarse sin que nadie haya editado el bloque. La decisión es si ese estilo era el que se quería desde el principio o un residuo de pruebas.

Multiselección nativa en el Párrafo: los eventos ya no salen del bloque

El bloque Párrafo se suma a la multiselección nativa de iOS y Android. Para lograrlo, opta por mover el wrapper contenteditable del bloque al canvas wrapper. La consecuencia directa es que los handlers de eventos de teclado, input y composición dejan de dispararse en el bloque y pasan a hacerlo en el elemento canvas.

El alcance está acotado: afecta solo al Párrafo, que ya fue adaptado. La dev note anticipa que en el futuro alcanzará a otros bloques de texto como Heading y List Item, y aclara que no tocará bloques no-core salvo que opten por el cambio cuando la API esté disponible.

Donde sí impacta hoy es en los filtros que agregan props al Párrafo. El patrón típico es editor.BlockListBlock con un onKeyDown dentro de wrapperProps:

addFilter(
 'editor.BlockListBlock',
 'my-plugin/track-keys',
 ( BlockListBlock ) => ( props ) => (
 <BlockListBlock
 { ...props }
 wrapperProps={ {
 ...props.wrapperProps,
 onKeyDown: ( event ) => {
 // ...
 },
 } }
 />
 )
);

Esos listeners se siguen llamando, mediante un pseudo-SyntheticEvent, así que el handler no se pierde. Las diferencias son sutiles: el target del evento nativo apunta al canvas en lugar del elemento del bloque, mientras que el target del evento sintético se ajustó para señalar al bloque. Si tu handler lee event.target para identificar el bloque, seguís obteniéndolo; si inspecciona el evento nativo, vas a encontrar el canvas. Vale la pena probar esos handlers contra la beta antes de dar por sentado que nada cambió.

registry.subscribe deja de escuchar stores ajenos

registry.subscribe( listener, storeName ) es más eficiente en 7.2 cuando el store indicado no está registrado en el momento de la llamada. Antes, el listener se enganchaba a la lista global del registry y se ejecutaba en cada update de cualquier store, tanto antes como después de que se registrara el store objetivo. Ahora el registry lo guarda como listener pendiente y lo conecta recién cuando ese store aparece, de modo que solo corre para sus updates.

Suscribirse antes del registro sigue funcionando igual, y la función unsubscribe que devuelve la llamada también. No hacen falta cambios de código. El único coletazo posible es para el código que dependía de que ese listener se disparara por stores no relacionados: va a ver menos llamadas. Ese comportamiento nunca estuvo documentado, así que en la práctica era una dependencia accidental. Si necesitás enterarte de los cambios de varios stores, la salida es suscribirte a cada uno.

La hoja de estilos de __experimentalImageEditor cambia de paquete

El componente de @wordpress/block-editor para construir interfaces de recorte y edición de imágenes quedó deprecado en 7.1; la recomendación es dejar de usarlo. Si el código todavía lo hace, hay un detalle de 7.2 para corregir: la hoja de estilos estaba mal definida en @wordpress/block-library y se muda a @wordpress/block-editor. Los imports del CSS deben apuntar a la nueva ubicación.

Los otros tres documentos: estilos por estado, componentes y menús

API para controles de estilo según el estado

Una nota aparte, también del 18 de noviembre, presenta la API pública para controles de estilo que dependen del estado seleccionado en el editor. Cuatro funciones de @wordpress/block-editor trabajan con viewport y pseudo estados: getSelectedBlockStyleState lee el estado seleccionado, hasSelectedBlockStyleState indica si hay uno distinto del default, getStyleForState devuelve el objeto de estilo de ese estado y setStyleForState lo actualiza.

cambios editor WordPress 7.2 diagrama explicativo

Por defecto, los controles del inspector se ocultan cuando hay un estado de estilo activo. Para mostrar controles propios, existe el slot style-state en InspectorControls y en BlockControls. Las integraciones de viewport que necesiten media queries cuentan con getViewportMediaQueries en @wordpress/global-styles-engine y su equivalente en PHP, wp_get_viewport_media_queries. Sin parámetros devuelven los valores de Core: 480 px para mobile y 782 px para tablet; en PHP, include_desktop viene en false.

Components: fin de Emotion y ocho componentes deprecados

El 10 de noviembre se publicó la nota de @wordpress/components. La migración de Emotion a SCSS Modules queda completa, con efectos concretos para quien usaba comportamientos específicos de Emotion. La prop css de __experimentalView se acepta por compatibilidad pero ya no hace nada: hay que usar style para declaraciones inline o className para reglas de hoja de estilos. __experimentalStyleProvider dejó de administrar la caché de Emotion, y los componentes que la necesitaban para insertar estilos en un iframe deben proveer su propia caché apuntando al <head> del documento destino.

En paralelo, ColorPalette, GradientPicker y DuotonePicker suman la prop presentation, que reemplaza a asButtons y define la semántica de accesibilidad de los swatches: "listbox" es el valor por defecto, con un solo tab stop y navegación por flechas; "toggle-buttons" da a cada swatch su propio tab stop y expone la selección con aria-pressed; "command-buttons" también da un tab stop por swatch pero no expone estado de selección, y sirve cuando activar un swatch ejecuta una acción. Ocho componentes quedan deprecados con remoción prevista para 7.4: Animate, Divider, Elevation, ResponsiveWrapper, Scrollable, Surface, Tip y ZStack. En todos los casos la salida es CSS propio, tokens de diseño o un componente alternativo.

Menús Opciones y Ver con el nuevo componente Menu

El 11 de noviembre se anunció que los menús Opciones (el botón «⋮») y Ver del encabezado del editor usan el componente Menu de @wordpress/ui, tanto en el editor de entradas como en el de sitio. La mayoría de los plugins no necesita cambios: PluginMoreMenuItem, PluginSidebarMoreMenuItem y PluginPreviewMenuItem siguen funcionando con sus props documentadas.

Hay dos consecuencias prácticas. Los ítems de plugins en el menú Opciones ahora viven en un submenú Panels en lugar de un grupo «Plugins» separado, así que las pruebas de extremo a extremo tienen que abrir Opciones, después Panels y recién entonces buscar el ítem. Y el markup cambió: los estilos o tests que apuntan a clases de @wordpress/components como .components-menu-item__button dejan de coincidir, por lo que conviene seleccionar por rol y nombre. Además, la prop as de esos tres componentes se ignora y emite un aviso de deprecación; nunca estuvo documentada y solo funcionaba porque las props extra llegaban al ActionItem subyacente. La corrección es quitarla y usar icon, onClick, href, disabled y target según corresponda.

CambioA quién afectaAcción
Se elimina __experimentalGroupAutores de bloques que usan InspectorControlsRenombrar la prop a group
CSS adicional en bloques hijosBloques con CSS propio dentro de un bloque padreRevisar reglas que antes se ignoraban
Multiselección nativa en PárrafoFiltros editor.BlockListBlock sobre el PárrafoProbar handlers de teclado, input y composición
registry.subscribe con store ausenteCódigo que se suscribe antes del registro del storeNinguna; verificar dependencias de updates ajenos
Hoja de estilos de __experimentalImageEditorQuien importa el CSS del componente deprecadoApuntar el import a @wordpress/block-editor

Fuentes

Volver a

Novedades

Publicaciones relacionadas