La vista previa de las solicitudes deja de quedarse pegada en pantalla
· 4 min de lectura
En el panel lateral derecho, al pasar el cursor (o enfocar con el teclado) una tarjeta de Solicitudes Recientes o Solicitudes Abiertas, se despliega a su izquierda una ventana con el detalle breve de la solicitud. El problema: una vez se activaba el foco sobre la tarjeta, la ventana podía quedarse visible aunque el usuario ya estuviera en otra parte de la aplicación.
Ahora la ventana acompaña a la tarjeta mientras el puntero o el foco estén sobre ella o sobre la propia ventana, y desaparece en cuanto ambos la abandonan.
El diagnóstico: el cierre dependía de un solo evento
La tarjeta gobernaba la ventana con dos únicos disparadores: onBlur cerraba y
onMouseLeave programaba el cierre. Ese diseño tiene tres huecos:
- El foco no siempre dispara
blur. Cuando la lista se reordena por un evento del socket (new-request-created,request-status-updated), React mueve el nodo de la tarjeta en el DOM. El navegador pierde el foco sin emitirblur, y el estadoopendel componente seguía entrue: la ventana quedaba flotando, anclada a una posición vieja. - La ventana no era interactiva. Se renderizaba con
pointer-events-none, así que no había forma de «entrar» en ella: al mover el cursor hacia el detalle, la ventana se cerraba antes de poder leerla. - La acción de la tarjeta no cerraba nada. Al hacer clic para abrir el detalle en una pestaña, la tarjeta conservaba el foco y con él la ventana.
Qué cambió
- Un solo criterio de permanencia: la ventana sigue abierta mientras el puntero
esté sobre la tarjeta o sobre la ventana, o mientras la tarjeta tenga el foco
de teclado. El cierre se programa solo cuando ninguna de las tres condiciones se
cumple (
request-compact-card.tsx). - La ventana es interactiva (
pointer-events-auto): el puntero puede entrar en ella sin que desaparezca, y solo se cierra al salir de ambas piezas. El margen de cierre subió a 160 ms para poder cruzar el hueco de 12 px sin parpadeos. - Eventos nativos en la tarjeta y en la ventana. React omite el
pointerentersintético cuando el destino ya lo gestiona React (el paso tarjeta ⇄ ventana), lo que habría cerrado la vista justo al intentar leerla. Los listeners nativos sí se disparan en ambos nodos, incluido el del portal. - Red de seguridad mientras está abierta: un clic en cualquier otro lugar, un
cambio de foco,
Escape, la pérdida de foco de la ventana del navegador o el ocultamiento de la pestaña la cierran. Así no puede quedar «pegada» aunque el navegador pierda el foco sin avisar. - La acción cierra la vista: al hacer clic (o
Enter/Espacio) en la tarjeta, la ventana desaparece antes de abrir el detalle en una pestaña. - Se cierra si la tarjeta sale del área visible al desplazar el panel lateral, y se reancla si la solicitud se actualiza o la lista se reordena.
Impacto
- Aplica por igual a Solicitudes Recientes y Solicitudes Abiertas: ambas usan la misma tarjeta compacta, así que no hay dos comportamientos que mantener.
- El modo colapsado del panel sigue mostrando solo el icono con su
titlenativo, sin ventana flotante. - No hay cambios de API ni de base de datos; es una corrección de interacción.
Archivos clave
| Capa | Archivo |
|---|---|
| Tarjeta (ciclo de vida de la ventana) | ccf-almacen-web/src/components/requests/request-compact-card.tsx |
| Ventana de vista previa | ccf-almacen-web/src/components/requests/request-preview-panel.tsx |
| Pruebas de comportamiento | ccf-almacen-web/src/components/__tests__/solicitud-tooltip-vista-previa.test.tsx |
Verificación
- 7 pruebas nuevas cubren: apertura por cursor y por teclado, cierre al salir de
la tarjeta y al perder el foco, permanencia con el puntero sobre la ventana,
regreso de la ventana a la tarjeta, cierre al ejecutar la acción, con
Escapey con un clic fuera.jesten verde. tsc --noEmitsin errores enrequests/ynext lintsin avisos en los archivos tocados.
