Enrutamiento de Vue.js

En este capítulo presentaremos el enrutamiento de Vue.js.

El enrutamiento de Vue.js nos permite acceder a diferentes contenidos a través de diferentes URL.

Con Vue.js se puede implementar una aplicación web de una sola página (single page web application, SPA) con múltiples vistas.

El enrutamiento de Vue.js requiere cargarla librería vue-router

Dirección de documentación en chino:Documentación de vue-router。


Instalación

1. Descarga directa / CDN

https://unpkg.com/vue-router/dist/vue-router.js

NPM

Se recomienda usar el espejo de Taobao:

cnpm install vue-router

Ejemplo simple

Vue.js + vue-router puede implementar fácilmente aplicaciones de una sola página.

<router-link>Es un componente que se utiliza para establecer un enlace de navegación y cambiar entre diferentes contenidos HTML.toEl atributo es la dirección de destino, es decir, el contenido que se debe mostrar.

En el siguiente ejemplo agregamos vue-router, luego configuramos los componentes y la asignación de rutas, y finalmente le decimos a vue-router dónde renderizarlos. El código es el siguiente:

Código HTML

<script src="https://unpkg.com/vue/dist/vue.js"></script> <script src="https://unpkg.com/vue-router/dist/vue-router.js"></script> <div id="app"> <h1>Hello App!</h1> <p> <!--Usa el componente router-link para navegar.--> <!--Especifica el enlace mediante el atributo `to`.--> <!--<router-link> se renderiza por defecto como una etiqueta `<a>`.--> <router-link to="/foo">Go to Foo</router-link> <router-link to="/bar">Go to Bar</router-link> </p> <!--Salida de la ruta--> <!--Los componentes que coincidan con la ruta se renderizarán aquí.--> <router-view></router-view> </div>

Código JavaScript

//0. Si usas programación modular, importa Vue y VueRouter, y debes llamar a Vue.use(VueRouter). //1. Define los componentes de (ruta). //Se pueden importar desde otros archivos. const Foo = { template: '<div>foo</div>' } const Bar = { template: '<div>bar</div>' } //2. Define las rutas. //Cada ruta debe asignarse a un componente. Donde "component" puede ser //un constructor de componentes creado con Vue.extend(), //o simplemente un objeto de configuración de componente. //Discutiremos las rutas anidadas más adelante. const routes = [ { path: '/foo', component: Foo }, { path: '/bar', component: Bar } ] //3. Crea una instancia de router y luego pasa la configuración `routes`. //También puedes pasar otros parámetros de configuración, pero por ahora mantengámoslo simple. const router = new VueRouter({ routes //(abreviatura) Equivale a routes: routes }) //4. Crea y monta la instancia raíz. //Recuerda inyectar el enrutamiento mediante el parámetro de configuración router, //para que toda la aplicación tenga funciones de enrutamiento. const app = new Vue({ router }).$mount('#app') //¡Ahora, la aplicación ya está iniciada!

Pruébalo »

Los enlaces de navegación en los que se ha hecho clic recibirán un estilo.class ="router-link-exact-active router-link-active"。


Propiedades relacionadas con <router-link>

A continuación podemos conocer más propiedades de <router-link>.

to

Representa el enlace de la ruta de destino. Cuando se hace clic, internamente pasará inmediatamente el valor de `to` a router.push(), por lo que este valor puede ser una cadena o un objeto que describa la posición de destino.

<!-- 字符串 -->
<router-link to="home">Home</router-link>
<!-- 渲染结果 -->
<a href="home.html">Home</a>

<!-- 使用 v-bind 的 JS 表达式 -->
<router-link v-bind:to="'home'">Home</router-link>

<!-- 不写 v-bind 也可以,就像绑定别的属性一样 -->
<router-link :to="'home'">Home</router-link>

<!-- 同上 -->
<router-link :to="{ path: 'home' }">Home</router-link>

<!-- 命名的路由 -->
<router-link :to="{ name: 'user', params: { userId: 123 }}">User</router-link>

<!-- 带查询参数,下面的结果为 /register?plan=private -->
<router-link :to="{ path: 'register', query: { plan: 'private' }}">Register</router-link>

replace

Si se establece el atributo replace, al hacer clic se llamará a router.replace() en lugar de router.push(); después de la navegación no quedará registro en el historial.

<router-link :to="{ path: '/abc'}" replace></router-link>

append

Si se establece el atributo append, se agregará la ruta delante de la ruta (relativa) actual. Por ejemplo, si navegamos desde /a a una ruta relativa b, sin configurar append, la ruta será /b; si está configurado, será /a/b.

<router-link :to="{ path: 'relative/path'}" append></router-link>

tag

A veces se quiere<router-link>renderizar como una determinada etiqueta, por ejemplo,<li>. Entonces usamostagla propiedad para especificar qué tipo de etiqueta; de todas formas seguirá escuchando el clic y activará la navegación.

<router-link to="/foo" tag="li">foo</router-link>
<!-- 渲染结果 -->
<li>foo</li>

active-class

Establece el nombre de clase CSS que se usará cuando el enlace esté activo. Se puede reemplazar con el siguiente código.

<style>
   ._active{
      background-color : red;
   }
</style>
<p>
   <router-link v-bind:to = "{ path: '/route1'}" active-class = "_active">Router Link 1</router-link>
   <router-link v-bind:to = "{ path: '/route2'}" tag = "span">Router Link 2</router-link>
</p>

Nota: aquíclassse usaactive-class="_active"。

exact-active-class

para configurar la clase que debe activarse cuando el enlace coincide exactamente. Se puede reemplazar con el siguiente código.

<p>
   <router-link v-bind:to = "{ path: '/route1'}" exact-active-class = "_active">Router Link 1</router-link>
   <router-link v-bind:to = "{ path: '/route2'}" tag = "span">Router Link 2</router-link>
</p>

event

Declara el evento que se puede usar para activar la navegación. Puede ser una cadena o un array que contenga cadenas.

<router-link v-bind:to = "{ path: '/route1'}" event = "mouseover">Router Link 1</router-link>

El código anterior establece event como mouseover; es decir, al mover el mouse sobre Router Link 1, el contenido HTML de la navegación cambiará.

Ejemplo de enrutamiento con NPM

A continuación mostramos un ejemplo simple de enrutamiento usando npm. Antes de comenzar, descarga el código fuente de este ejemplo:

Ejemplo de enrutamiento

También puedes descargarlo desde Github:https://github.com/chrisvfritz/vue-2.0-simple-routing-example

Después de descargar, descomprime el directorio, renómbralo como vue-demo, entra en ese directorio y ejecuta el siguiente comando:

# 安装依赖,使用淘宝资源命令 cnpm
cnpm install

# 启动应用,地址为 localhost:8080
cnpm run dev

Si necesitas publicar en el entorno de producción, puedes ejecutar el siguiente comando:

cnpm run build

Después de una ejecución exitosa, visita http://localhost:8080 y verás la siguiente interfaz:

Otras extensiones