¿Cómo crear una Single Page Application (SPA) con Vue?
El universo de desarrollo web está lleno de términos y conceptos que pueden parecer complejos a primera vista, pero que, una vez comprendidos, fortalecen nuestras habilidades como desarrolladores. Uno de esos conceptos es el de las Single Page Applications (SPAs), aplicaciones de una sola página. En esta guía, vamos a descubrir cómo podemos implementar una SPA utilizando Vue.js y su herramienta de enrutamiento, Vue Router.
¿Qué es una SPA?
Una Single Page Application (SPA) es una aplicación web que consta de un solo documento HTML que se actualiza dinámicamente a medida que el usuario interactúa con ella.
Estructura inicial: La página contiene una estructura HTML básica con un header o footer común.
Cambio de contenido: El contenido principal se actualiza según la ruta o URL sin recargar toda la página.
Esto significa que al cambiar la URL, sólo el contenido central se modifica, haciendo la experiencia de usuario más rápida y fluida.
¿Cómo configurar Vue Router?
Vue Router es una biblioteca oficial para Vue.js que permite gestionar las rutas en nuestras SPAs. A continuación, te guiaré a través del proceso de configuración básica.
Instalación de la dependencia: Desde la terminal, ejecuta el siguiente comando para instalar Vue Router:
npminstall vue-router --save
Esto añadirá Vue Router a tu archivo package.json dentro de las dependencias.
Crear un archivo de configuración para las rutas: Dentro de tu proyecto crea un archivo routes.js o similar. Este archivo es donde definiremos nuestras rutas.
En este archivo, definimos las rutas y los componentes que estas rutas deben renderizar. El modo 'history' permite una navegación tipo histórico con URLs limpias.
¿Cómo se muestran los componentes en base a las rutas?
En el archivo principal (comúnmente App.vue), utilizaremos los componentes brindados por Vue Router:
Router-view: Es un componente crucial que se encarga de mostrar el componente asociado a la ruta actual.
Router-link: Facilita la navegación entre rutas internas de la aplicación.
<router-linkto="/home">Home</router-link>
¿Cómo gestionar las rutas no existentes?
Un aspecto esencial en toda aplicación es manejar errores, como cuando un usuario intenta acceder a una ruta que no existe. Para ello, Vue Router nos permite definir estrategias para rutas no encontradas.
Ruta "catch-all": Podemos definir una ruta con un comodín * para interceptar todas las URLs no definidas.
{path:'*',component:NotFoundComponent}
¿Qué es lo siguiente?
Hemos cubierto las bases para configurar una Single Page Application con Vue.js utilizando Vue Router. Esto nos abre un mundo de posibilidades para desarrollar aplicaciones dinámicas y eficaces.
La próxima vez nos adentraremos en la interacción con APIs, permitiendo que nuestras aplicaciones obtengan y muestren datos dinámicamente. Mantente curioso y sigue explorando el vasto horizonte del desarrollo web. ¡El conocimiento es poder!
¿Cómo crear una Single Page Application (SPA) con Vue?
El universo de desarrollo web está lleno de términos y conceptos que pueden parecer complejos a primera vista, pero que, una vez comprendidos, fortalecen nuestras habilidades como desarrolladores. Uno de esos conceptos es el de las Single Page Applications (SPAs), aplicaciones de una sola página. En esta guía, vamos a descubrir cómo podemos implementar una SPA utilizando Vue.js y su herramienta de enrutamiento, Vue Router.
¿Qué es una SPA?
Una Single Page Application (SPA) es una aplicación web que consta de un solo documento HTML que se actualiza dinámicamente a medida que el usuario interactúa con ella.
Estructura inicial: La página contiene una estructura HTML básica con un header o footer común.
Cambio de contenido: El contenido principal se actualiza según la ruta o URL sin recargar toda la página.
Esto significa que al cambiar la URL, sólo el contenido central se modifica, haciendo la experiencia de usuario más rápida y fluida.
¿Cómo configurar Vue Router?
Vue Router es una biblioteca oficial para Vue.js que permite gestionar las rutas en nuestras SPAs. A continuación, te guiaré a través del proceso de configuración básica.
Instalación de la dependencia: Desde la terminal, ejecuta el siguiente comando para instalar Vue Router:
npm install vue-router --save
Esto añadirá Vue Router a tu archivo package.json dentro de las dependencias.
Crear un archivo de configuración para las rutas: Dentro de tu proyecto crea un archivo routes.js o similar. Este archivo es donde definiremos nuestras rutas.
En este archivo, definimos las rutas y los componentes que estas rutas deben renderizar. El modo 'history' permite una navegación tipo histórico con URLs limpias.
¿Cómo se muestran los componentes en base a las rutas?
En el archivo principal (comúnmente App.vue), utilizaremos los componentes brindados por Vue Router:
Router-view: Es un componente crucial que se encarga de mostrar el componente asociado a la ruta actual.
Router-link: Facilita la navegación entre rutas internas de la aplicación.
<router-link to="/home">Home</router-link>
¿Cómo gestionar las rutas no existentes?
Un aspecto esencial en toda aplicación es manejar errores, como cuando un usuario intenta acceder a una ruta que no existe. Para ello, Vue Router nos permite definir estrategias para rutas no encontradas.
Ruta "catch-all": Podemos definir una ruta con un comodín * para interceptar todas las URLs no definidas.
{
path: '*',
component: NotFoundComponent
}
¿Qué es lo siguiente?
Hemos cubierto las bases para configurar una Single Page Application con Vue.js utilizando Vue Router. Esto nos abre un mundo de posibilidades para desarrollar aplicaciones dinámicas y eficaces.
La próxima vez nos adentraremos en la interacción con APIs, permitiendo que nuestras aplicaciones obtengan y muestren datos dinámicamente. Mantente curioso y sigue explorando el vasto horizonte del desarrollo web. ¡El conocimiento es poder!
Compañeros, si están usando la versión 3 de Vue deben descargar este paquete de 'vue-router':
$ npm i vue-router@next> Ya que si instalan ‘$ npm i vue-router’ no les va a funcionar en esta versión de Vue <
Ahora bien, si ya lo instalaron, no se preocupen, remuévanlo con este comando:
$ npm remove vue-router
E instalen el que les comento más arriba.
> Ya luego de haber instalado 'vue-router' para la versión 3 de Vue deben de hacer algunos cambios en el código para que puedan tener los mismos resultados que se muestran en esta clase.
Partamos viendo primero como queda el archivo
- main.js -
> Si se fijan, es aquí donde estamos usando nuestra función '.use()' y es de esta forma cómo le decimos a Vue que utilice el 'router' que importamos en la línea 6.
Ahora que ya tenemos este archivo listo, debemos modificar nuestro archivo
- router.js -
> Aquí estamos haciendo uso de 2 métodos de 'vue-router':
'createWebHistory': Lo usamos para el historial de navegación
'createRouter': Lo usamos para crear nuestra instancia de router, y es dentro de este donde construimos nuestro Array de rutas, siendo cada ruta representada a través de un objeto.
Ahora bien, además del uso de esos métodos, hay un par de cosas más que se hacen diferente.
Estas son:
Ya no hacemos uso de la función 'use()' ya que esta la estamos usando directamente en la instancia de nuestra aplicación de Vue en 'main.js', y por lo mismo ya no necesitamos escribir tampoco 'import Vue from 'vue'
Y el otro cambio es que ahora para que podamos dirigir todas las rutas que no existen a un componente destinado para eso, que en nuestro caso es el componente 'Error.vue', debemos definir el 'path’ de esa ruta de esta forma:
path: "/:catchAll(.*)",
ya que si lo hacen así:
path: "*",
No les va a funcionar.
-------------------------------
> Los componentes que se crearon en la clase que están dentro del directorio 'views' son iguales, por eso no es necesario ponerlos en este comentario <
-------------------------------
Y bueno, ya con estas modificaciones no deberían tener problemas al correr su aplicación 😄.
Espero les sirva, Saludos!
Se puede apreciar que al escribir manualmente la dirección en la barra, la pagina se recarga, sin embargo, al hacer clic al enlace generado por el router-link, la pagina no recarga. Esa en la idea de usar router-view y router-link
La forma de usar Vue Router cambió un poquito mucho en VueJS 3
Les recomiendo usar el comando:
vue add router
Y se ahorran todo el trabajo, aunque les quedará una estructura diferente y a esta altura del proyecto les sobreescribirá muchas cosas, así que para simplificarlo mas, el archivo router.js quedaría así:
import { createRouter, createWebHistory } from "vue-router";
import Home from "@/views/Home.vue";
const router = createRouter({
history: createWebHistory(process.env.BASE_URL),
routes: [
{
path: "/",
name: "Home",
component: Home
}
]
});
export default router;
Y el archivo main.js así:
import { createApp } from "vue";
import App from "./App.vue";
//El @ representa al directorio src
import "@/assets/css/tailwind.css";
import router from "@/router.js";
createApp(App)
.use(router)
.mount("#app");
Holaa, tengo una duda, lo que pasa es que para instalar Vue Router lo hice desde la UI, entonces me reemplazo y me creó unos archivos, y veo que me da esta ruta así, pero no entiendo el porque y para que sirve, ya que no veo que cambie en algo en el navegador. Solo es una duda :)
import { createApp } from "vue";
import App from "./App.vue";
import "@/assets/css/tailwind.css";
import "@/router";
createApp(App).mount("#app");```
¿Cómo puedo hacer para pasarle el router?
Hola, ¿para qué se usa exactamente el 'mode: 'history'? Veo que normalmente recomiendan quitarlo porque hace conflicto de algún modo al realizar la build con npm del proyecto. ¿Es necesario ponerlo?