Tema 15 · SPA & Vue Router 4

15. Vue Router 4: Rutas Dinámicas, Vistas Anidadas y Navigation Guards

Construye aplicaciones de una sola página (SPA): configuración de rutas en createRouter con createWebHistory, captura de parámetros (:id), rutas anidadas (<router-view>) y protección con guards (beforeEach).

Navegación Fluida en el Frontend: Vue Router 4

En una Single Page Application (SPA), la página nunca se recarga completamente al navegar. Vue Router 4 es el enrutador oficial de Vue 3: intercepta los cambios de URL en el navegador mediante la API de History de HTML5 y actualiza dinámicamente las vistas sin pérdida de estado.

1. Modos de Historia: HTML5 History vs Hash Mode

  • createWebHistory() (Recomendado para Producción): Genera URLs limpias y profesionales (ej: https://tuapp.com/usuarios/42). Requiere que el servidor web (Nginx o Apache con mod_rewrite) esté configurado para redirigir todas las peticiones a index.html.
  • createWebHashHistory(): Utiliza el carácter hash (https://tuapp.com/#/usuarios/42). No requiere ninguna configuración especial en el servidor backend, pero las URLs son menos estéticas para SEO.

2. Componentes y Hooks Esenciales

Vue Router provee componentes globales listos para usar y composables para la Composition API:

  • <router-link to="/perfil">: Enlace accesible que previene el refresco de página y aplica automáticamente la clase CSS .router-link-active.
  • <router-view>: Punto de montaje donde se renderiza el componente asociado a la ruta actual.
  • useRoute(): Devuelve un objeto reactivo con información de la URL actual: parámetros dinámicos (route.params.id), queries (route.query.filtro) y metadatos (route.meta).
  • useRouter(): Permite navegación programática mediante código (ej: router.push('/dashboard') o router.replace('/login')).

3. Protección de Rutas con Navigation Guards (beforeEach)

Los Navigation Guards permiten inspeccionar la navegación antes de que ocurra para proteger rutas privadas (autenticación) o comprobar permisos de roles:

router.beforeEach((to, from) => {
  const estaAutenticado = Boolean(localStorage.getItem('token'));

  // Si la ruta requiere autenticación y el usuario no ha iniciado sesión:
  if (to.meta.requiereAuth && !estaAutenticado) {
    return { name: 'Login', query: { redirect: to.fullPath } };
  }
});

⚡ Navegación SPA Completa con Rutas Dinámicas y Guardias de Seguridad

Simulación de enrutador SPA reactivo con vistas, parámetros y guardia de autenticación.

index.html
Solo lectura
<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <title>Vue Router 4 SPA</title>
  <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body class="p-4 bg-light">
  <div id="app" class="card shadow-sm p-4 mx-auto" style="max-width: 520px;">
    <!-- Barra de Navegación SPA -->
    <nav class="d-flex justify-content-between align-items-center mb-3 border-bottom pb-2">
      <span class="fw-bold text-success">Mi App SPA</span>
      <div class="d-flex gap-2">
        <button @click="navegar('inicio')" class="btn btn-sm" :class="rutaActual === 'inicio' ? 'btn-success' : 'btn-outline-secondary'">
          Inicio
        </button>
        <button @click="navegar('usuarios')" class="btn btn-sm" :class="rutaActual.startsWith('usuarios') ? 'btn-success' : 'btn-outline-secondary'">
          Usuarios
        </button>
        <button @click="navegar('admin')" class="btn btn-sm" :class="rutaActual === 'admin' ? 'btn-success' : 'btn-outline-secondary'">
          Admin 🔒
        </button>
      </div>
    </nav>

    <!-- Estado de Autenticación para el Guard -->
    <div class="d-flex justify-content-between align-items-center p-2 bg-light rounded border mb-3 small">
      <span>Sesión de Administrador:</span>
      <button @click="esAdmin = !esAdmin" class="btn btn-sm py-0" :class="esAdmin ? 'btn-danger' : 'btn-primary'">
        {{ esAdmin ? 'Cerrar Sesión' : 'Iniciar como Admin' }}
      </button>
    </div>

    <!-- Router View (Área Dinámica) -->
    <div class="p-3 bg-white border rounded mb-3">
      <!-- VISTA 1: INICIO -->
      <div v-if="rutaActual === 'inicio'">
        <h5 class="fw-bold">Página de Inicio</h5>
        <p class="text-secondary small mb-0">Bienvenido a la SPA de demostración de Vue Router 4. La página nunca recarga el navegador.</p>
      </div>

      <!-- VISTA 2: LISTA DE USUARIOS -->
      <div v-else-if="rutaActual === 'usuarios'">
        <h5 class="fw-bold">Directorio de Usuarios</h5>
        <div class="list-group small">
          <a href="#" @click.prevent="verDetalle(101)" class="list-group-item list-group-item-action">
            👤 Carlos Santana (ID: 101) &rarr;
          </a>
          <a href="#" @click.prevent="verDetalle(204)" class="list-group-item list-group-item-action">
            👤 Elena Morales (ID: 204) &rarr;
          </a>
        </div>
      </div>

      <!-- VISTA 2.1: DETALLE DE USUARIO (Ruta Dinámica :id) -->
      <div v-else-if="rutaActual === 'detalle-usuario'">
        <button @click="navegar('usuarios')" class="btn btn-sm btn-link p-0 mb-2">&larr; Volver a la lista</button>
        <h5 class="fw-bold text-primary">Perfil de Usuario #{{ idSeleccionado }}</h5>
        <p class="text-secondary small mb-0">Parámetro capturado dinámicamente vía <code>route.params.id</code>.</p>
      </div>

      <!-- VISTA 3: PANEL PRIVADO (Guard) -->
      <div v-else-if="rutaActual === 'admin'">
        <h5 class="fw-bold text-danger">Panel de Administración Privado</h5>
        <p class="text-secondary small mb-0">✓ Has superado el Navigation Guard <code>beforeEach()</code> exitosamente.</p>
      </div>
    </div>

    <div v-if="mensajeGuard" class="alert alert-warning py-2 small mb-0">
      ⚠️ {{ mensajeGuard }}
    </div>
  </div>

    <script src="/assets/vendor/vue/vue.global.prod.js"></script>
  <script>
    if (!window.Vue) {
      document.write('<script src="https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.prod.js"><\/script>');
    }
  </script>
  <script>
    const { createApp, ref } = Vue;

    createApp({
      setup() {
        const rutaActual = ref('inicio');
        const esAdmin = ref(false);
        const idSeleccionado = ref(null);
        const mensajeGuard = ref('');

        // Simulación del Navigation Guard beforeEach:
        const navegar = (destino) => {
          mensajeGuard.value = '';

          if (destino === 'admin' && !esAdmin.value) {
            mensajeGuard.value = 'Navigation Guard: Acceso denegado a /admin. Inicia sesión primero.';
            return;
          }

          rutaActual.value = destino;
        };

        const verDetalle = (id) => {
          idSeleccionado.value = id;
          rutaActual.value = 'detalle-usuario';
        };

        return {
          rutaActual,
          esAdmin,
          idSeleccionado,
          mensajeGuard,
          navegar,
          verDetalle
        };
      }
    }).mount('#app');
  </script>
</body>
</html>
Pruébalo tú mismo » Se abre en una nueva pestaña con ejecución en vivo
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué configuración requiere un servidor web de producción (como Nginx o Apache) al desplegar una SPA de Vue Router con createWebHistory()?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Vue.js 3 Profesional: Composition API, Script Setup, Pinia & Vite y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.