Simplificando la gestión del router de Vue

02 octubre 2019
Simplificando la gestión del router de Vue

Cuando creamos nuestra aplicación Vue una de las cosas que debemos configurar, si nuestra app dispone de varias páginas, es el router.

Vue dispone de un router propio lo suficientemente bueno para que no necesites usar ningún otro y que se configura de una forma similar a esta:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
import Vue from 'vue'
import Router from 'vue-router'
import Login from '../pages/Login'
import Home from '../pages/Home'
import Article from '../pages/Article'

Vue.use(Router)

new Router({
routes: [
{
path: '/login',
name: 'login',
component: Login
},
{
path: '/',
name: 'home',
component: Home,
meta: {
auth: true
}
},
{
path: '/articulo/:slug',
name: 'home',
props: true,
component: Article,
meta: {
auth: true
}
},
]
})

Como vemos las cada ruta se define en un Objeto dentro de un Array, indicando el path al que responderá, el nombre y el componente que mostrará dicha página o vista, además de otras muchas configuraciones que podría tener.

Si nuestra aplicación tiene muchas páginas este array se volverá un poco complicado de manejar.

Si habeis trabajado con Nuxt.js conoceréis que en su caso, con colocar los componentes en la carpeta pages, ya se genera de forma automática la ruta con el nombre del componente, que además podemos meter en distintos niveles de carpetas.

Pues ese comportamiento es lo que vamos a replicar de una forma más básica para cualquier aplicación Vue que no necesite emplear Nuxt.js

En primer lugar modificamos el router.js, vamos a explicarlo por partes:

Importamos Vue y Vue router y le indicamos a Vue que lo use, nada extraño aquí:

1
2
3
4
import Vue from 'vue'
import Router from 'vue-router'

Vue.use(Router)

Haciendo uso de la gestión de dependencias de Webpack, en concreto de require.context(), que nos permite, en nuestro caso, obtenemos un contexto con todos los archivos *.vue en la carpeta /pages que es donde guardamos las páginas de nuestra App.

Esto sólo funciona en un entorno webpack si usamos Vue directamente en el navegador require.context no estará definido.

1
2
3
4
5
6
7
const files = require.context('../pages/', false, /\.vue$/)
const pages = []

files.keys().forEach((key) => {
if (key === './index.js') return
pages[key.replace(/(\.\/|\.vue)/g, '')] = files(key).default
})

A continuación vamos añadiendo rutas de vue-router en función de los archivos que tenemos en nuestro contexto, usando el nombre del fichero como ruta (en minúsculas) y para el nombre de la ruta el nombre indicado en el componente o el nombre del fichero, y, obviamente el propio componente como componente que gestionará esa ruta.

1
2
3
4
5
6
7
8
9
const routes = []
Object.keys(pages).forEach(page => {
const route = {
path: '/' + page.toLowerCase()
name: pages[page].name.toLowerCase || page.toLowerCase()
component: pages[page]
}
routes.push(route)
})

Ahora sólo tenemos que instanciar el router

1
2
3
const router = new Router({  
routes: routes
})

Y voilà cada componente que añadamos a la carpeta /pages tendrá su propia ruta sin necesidad de hacer nada más.

Pero, ¿y si quiero personalizar la ruta, añadirle parámetros, o metas?. Un paso más

Lo que acabamos de hacer es cómodo pero poco flexible, ya que no podríamos configurar por ejemplo una ruta que contenga parámetros o indicarle un meta.requireAuth para que el router mediante un guard compruebe si el usuario esta sogueado.

Para solucionarlo lo que podemos hacer es definir en nuestro componente una key llamada ‘route’ que contenga esa configuración y que si esta existe nuestro generador de rutas lo lea y aplique, y si no que use el procedimiento por defecto.

Modificamos la parte de generación de rutas

1
2
3
4
5
6
7
8
9
10
11
12
13
14
const routes = []
Object.keys(pages).forEach(page => {
let route = {}

if (pages[page].route !== undefined) {
route = pages[page].route
} else {
route = {
path: '/' + page.toLowerCase()
}
}
route.component = pages[page]
routes.push(route)
})

Y en nuestro componente, por ejemplo Articule.vue añadimos la key de esta forma:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<template>
....
</template>
<script>
export default {
....
route: {
path: '/articulo/:slug',
name: 'article',
props: true,
meta: {
auth: true
}
}
...
}
</script>

Y así el generador de rutas que hemos creado usará esa configuración.

De esta forma además tenemos la configuración de la página en el propio componente.

Esto podríamos ir iterandolo para permitir, por ejemplo, como hace Nuxt.js crear rutas a partir de las carpetas y demás, pero creo que esta ya fuera del objetivo y ¿por qué no usar Nuxt.js directamente?

Programador y desarrollador de aplicaciones web, #drupal es mi guia. Amante de la #f1, de las buenas conversaciones y de los pequeños detalles.