hace 6 años
Es una situación común y frustrante para muchos usuarios de internet: estás navegando por una página web, aplicas filtros, avanzas en la paginación, encuentras el producto que te interesa, lo revisas, y al presionar el botón "atrás" del navegador, ¡sorpresa! Vuelves a la página en su estado inicial, perdiendo todos los filtros y la página en la que estabas. Si eres desarrollador web y utilizas paginación y filtrado del lado del cliente, seguramente te has topado con este problema. Afortunadamente, existe una solución elegante para mejorar la experiencia del usuario y mantener el estado de tu página web al usar el botón atrás: el History API.

- ¿Por qué se pierde el estado al usar el botón atrás?
- La solución: History API al rescate
- Implementando la persistencia del estado con History API
- Detectar el botón atrás con JQuery (y Javascript puro)
- Beneficios de usar History API para la persistencia del estado
- Consideraciones importantes
- Preguntas frecuentes (FAQ)
- Conclusión
¿Por qué se pierde el estado al usar el botón atrás?
Cuando se utilizan técnicas de paginación y filtrado del lado del cliente, como con Javascript y JQuery, las interacciones del usuario a menudo no generan una recarga completa de la página. Se manipula el DOM dinámicamente para mostrar nuevos resultados sin una nueva petición al servidor. El problema surge porque el navegador, por defecto, al presionar el botón atrás, simplemente regresa a la URL anterior en el historial de navegación. Si no se ha indicado explícitamente que guarde el estado de la página, se mostrará la versión inicial de esa URL, perdiendo las modificaciones realizadas por el Javascript.

La solución: History API al rescate
El History API es una potente herramienta proporcionada por los navegadores modernos que permite a los desarrolladores web manipular el historial de navegación del usuario sin necesidad de recargar la página completa. Esto significa que podemos actualizar la URL en la barra de direcciones, guardar datos asociados a esa URL, y gestionar los eventos de navegación hacia adelante y hacia atrás. Las dos funciones principales que nos interesan son:
pushState(): Permite añadir una nueva entrada al historial de navegación. Podemos especificar un estado (un objeto Javascript con datos), un título (que la mayoría de los navegadores ignoran por seguridad) y una URL. Es importante destacar quepushState()no recarga la página, simplemente actualiza el historial y la URL en la barra de direcciones.popstateevent: Este evento se dispara cuando el usuario navega hacia atrás o hacia adelante en el historial del navegador (por ejemplo, al hacer clic en el botón atrás o adelante). El eventopopstateproporciona acceso al estado que fue guardado previamente conpushState()para esa entrada del historial.
Implementando la persistencia del estado con History API
Veamos cómo podemos aplicar el History API en un escenario típico de paginación y filtrado del lado del cliente.
1. Captura del estado actual de la página
Primero, necesitamos identificar qué información representa el estado actual de nuestra página. En el ejemplo del usuario, el estado incluye:
- Página actual de la paginación.
- Filtros seleccionados (categoría, fabricante, peso, etc.).
Cuando el usuario interactúa con los controles de paginación o los filtros, debemos capturar estos valores. Por ejemplo, podríamos guardar la página actual en una variable Javascript y los filtros seleccionados en un objeto o array.

2. Actualización del historial con pushState()
Cada vez que el usuario cambie la página o aplique un filtro, debemos actualizar el historial utilizando pushState(). El estado que guardemos con pushState() será el que recuperemos cuando el usuario pulse el botón atrás.
Aquí tienes un ejemplo conceptual en Javascript (adaptable a JQuery):
function actualizarEstadoHistorial() { const paginaActual = obtenerPaginaActual(); // Función para obtener la página actual const filtrosSeleccionados = obtenerFiltrosSeleccionados(); // Función para obtener los filtros const estado = { pagina: paginaActual, filtros: filtrosSeleccionados }; const nuevaURL = generarURLConEstado(estado); // Función para generar una URL con el estado window.history.pushState(estado, '', nuevaURL); } En este código:
obtenerPaginaActual()yobtenerFiltrosSeleccionados()son funciones que debes implementar para obtener los valores actuales de la paginación y los filtros de tu página.estadoes un objeto Javascript que contiene la información del estado que queremos guardar.generarURLConEstado(estado)es una función que genera una nueva URL que refleja el estado actual. Puedes usar parámetros de consulta en la URL para representar el estado (ej:/productos?pagina=2&categoria=electronica&fabricante=marcaX).window.history.pushState(estado, '', nuevaURL)añade una nueva entrada al historial con el estado, un título vacío ('') y la nueva URL.
Debes llamar a actualizarEstadoHistorial() cada vez que cambie la paginación o los filtros, por ejemplo, dentro de los manejadores de eventos de los botones de paginación o los controles de filtro.
3. Manejo del evento popstate
Ahora, cuando el usuario pulse el botón atrás o adelante, se disparará el evento popstate. En el manejador de este evento, debemos recuperar el estado guardado y aplicarlo a la página.

Ejemplo de cómo manejar el evento popstate (también adaptable a JQuery):
window.addEventListener('popstate', function(event) { if (event.state) { const estadoGuardado = event.state; restaurarEstadoPagina(estadoGuardado); // Función para restaurar el estado de la página } }); En este código:
window.addEventListener('popstate', ...)añade un listener para el eventopopstate.event.statecontiene el estado que guardamos previamente conpushState(). Si es la primera carga de la página o si se navega a una página sin estado,event.statepuede sernull, por eso verificamosif (event.state).restaurarEstadoPagina(estadoGuardado)es una función que debes implementar para aplicar el estado guardado a la página. Esta función debería leer los valores deestadoGuardado.paginayestadoGuardado.filtrosy actualizar la paginación y los filtros visualmente en la página, y por supuesto, mostrar los productos correspondientes al nuevo estado.
Detectar el botón atrás con JQuery (y Javascript puro)
Como se mencionó en la pregunta inicial, puedes utilizar el evento popstate para "detectar" (en realidad, para reaccionar a) la navegación hacia atrás o adelante. El código proporcionado en la pregunta es correcto:
// Javascript puro window.onpopstate = function(event) { if (event.state) { // Verifica que haya un estado guardado console.log("Botón atrás/adelante presionado. Estado:", event.state); // Llama a tu función para restaurar el estado aquí restaurarEstadoPagina(event.state); } }; // JQuery $(window).on('popstate', function(event) { if (event.state) { // Verifica que haya un estado guardado console.log("Botón atrás/adelante presionado. Estado:", event.state); // Llama a tu función para restaurar el estado aquí restaurarEstadoPagina(event.state); } }); Es importante notar que el evento popstate se dispara tanto al navegar hacia atrás como hacia adelante en el historial. Dentro del manejador del evento, la clave para restaurar el estado correctamente es usar event.state para acceder a los datos que guardaste con pushState().
Beneficios de usar History API para la persistencia del estado
- Mejora la experiencia del usuario: Evita la frustración de perder filtros y paginación al navegar hacia atrás.
- Navegación más fluida: La navegación se siente más natural y rápida, ya que no se recarga la página completa.
- URLs semánticas: Puedes generar URLs que reflejen el estado de la página, lo que facilita compartir enlaces y mejora el SEO (aunque este último punto es más sutil y depende de cómo tu servidor maneje estas URLs).
Consideraciones importantes
- Compatibilidad del navegador: El History API es compatible con todos los navegadores modernos. Para navegadores muy antiguos, es posible que necesites ofrecer una alternativa o simplemente no implementar la persistencia del estado.
- Manejo de la URL: Es importante generar URLs consistentes y que reflejen el estado. Piensa en cómo quieres que se vean las URLs con filtros y paginación y cómo tu servidor podría interpretar estas URLs (aunque en este caso, al ser todo del lado del cliente, la URL principalmente sirve para el historial del navegador).
- Estado inicial: Considera el estado inicial de la página cuando se carga por primera vez. En el manejador de
popstate, debes tener en cuenta queevent.statepuede sernullen la carga inicial o al navegar a una página sin estado previo.
Preguntas frecuentes (FAQ)
- ¿Es necesario usar JQuery para implementar esto?
- No, el History API es parte de Javascript puro. JQuery puede simplificar la manipulación del DOM y los eventos, pero no es imprescindible. Los ejemplos proporcionados se pueden adaptar fácilmente a Javascript puro.
- ¿Afecta esto al SEO de mi página web?
- En principio, el uso del History API para manipular el estado del lado del cliente no debería afectar negativamente al SEO. Los motores de búsqueda generalmente ejecutan Javascript y pueden indexar el contenido dinámico. Sin embargo, es importante asegurarse de que el contenido sea accesible y que las URLs generadas sean semánticas y coherentes. Para SEO más avanzado, considera el renderizado del lado del servidor o el pre-renderizado para contenido dinámico complejo.
- ¿Qué pasa si el usuario abre la página en una nueva pestaña o comparte el enlace?
- Si generas URLs que reflejen el estado (por ejemplo, usando parámetros de consulta), al abrir la URL en una nueva pestaña o compartirla, la página debería cargarse con ese estado específico (filtros y página). Debes implementar la lógica en tu servidor o en el Javascript de inicio de la página para leer los parámetros de la URL y aplicar el estado inicial correspondiente.
- ¿Cómo manejar estados complejos o mucha información en el estado?
- Puedes guardar objetos Javascript complejos como estado con
pushState(). Sin embargo, si el estado es muy grande o complejo, considera serializarlo a un formato más compacto (como JSON) o guardar solo la información esencial. También puedes usar la URL para reflejar parte del estado, especialmente los filtros y la paginación, lo que facilita la compartición de enlaces y la comprensión de la URL.
Conclusión
Mantener el estado de la página al usar el botón atrás es crucial para una buena experiencia de usuario en aplicaciones web que utilizan paginación y filtrado del lado del cliente. El History API ofrece una solución robusta y elegante para lograrlo. Al implementar pushState() y manejar el evento popstate, puedes crear una experiencia de navegación mucho más fluida y agradable para tus usuarios, evitando la frustración de perder el contexto al navegar hacia atrás.
