Saltar al contenido principal

La vista previa de las solicitudes deja de quedarse pegada en pantalla

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:

  1. 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 emitir blur, y el estado open del componente seguía en true: la ventana quedaba flotando, anclada a una posición vieja.
  2. 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.
  3. 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 pointerenter sinté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 title nativo, sin ventana flotante.
  • No hay cambios de API ni de base de datos; es una corrección de interacción.

Archivos clave​

CapaArchivo
Tarjeta (ciclo de vida de la ventana)ccf-almacen-web/src/components/requests/request-compact-card.tsx
Ventana de vista previaccf-almacen-web/src/components/requests/request-preview-panel.tsx
Pruebas de comportamientoccf-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 Escape y con un clic fuera. jest en verde.
  • tsc --noEmit sin errores en requests/ y next lint sin avisos en los archivos tocados.