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 aindex.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')orouter.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.
<!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) →
</a>
<a href="#" @click.prevent="verDetalle(204)" class="list-group-item list-group-item-action">
👤 Elena Morales (ID: 204) →
</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">← 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>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿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.