FE

Vue 学习笔记（三十一）：Vue Router 示例

用 Vue.js + Vue Router 创建单页应用，是非常简单的。使用 Vue.js ，我们已经可以通过组合组件来组成应用程序，当你要把 Vue Router 添加进来，我们需要做的是，将组件 (components) 映射到路由 (routes)，然后告诉 Vue Router 在哪里渲染它们。

官网 Getting Started 示例：

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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
<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>
        <!-- 使用 router-link 组件来导航. -->
        <!-- 通过传入 `to` 属性指定链接. -->
        <!-- <router-link> 默认会被渲染成一个 `<a>` 标签 -->
        <router-link to="/foo">Go to Foo</router-link>
        <router-link to="/bar">Go to Bar</router-link>
    </p>
    <!-- 路由出口 -->
    <!-- 路由匹配到的组件将渲染在这里 -->
    <router-view></router-view>
</div>

<script>
    // 0. 如果使用模块化机制编程，导入Vue和VueRouter，要调用 Vue.use(VueRouter)
    // 1. 定义 (路由) 组件。
    // 可以从其他文件 import 进来
    const Foo = { template: '<div>foo</div>' }
    const Bar = { template: '<div>bar</div>' }

    // 2. 定义路由
    // 每个路由应该映射一个组件。 其中"component" 可以是
    // 通过 Vue.extend() 创建的组件构造器，
    // 或者，只是一个组件配置对象。
    // 我们晚点再讨论嵌套路由。
    const routes = [
        { path: '/foo', component: Foo },
        { path: '/bar', component: Bar }
    ]

    // 3. 创建 router 实例，然后传 `routes` 配置
    // 你还可以传别的配置参数, 不过先这么简单着吧。
    const router = new VueRouter({
        routes // (缩写) 相当于 routes: routes
    })

    // 4. 创建和挂载根实例。
    // 记得要通过 router 配置参数注入路由，
    // 从而让整个应用都有路由功能
    const app = new Vue({
        router
    }).$mount('#app')

    // 现在，应用已经启动了！

</script>

渲染结果：

Hello App!

Go to Foo Go to Bar

总结一下：

  1. 页面实现（html模版中）
    　　在vue-router中, 我们看到它定义了两个标签<router-link> 和<router-view>来对应点击和显示部分。<router-link> 就是定义页面中点击的部分，<router-view> 定义显示部分，就是点击后，区配的内容显示在什么地方。所以 <router-link> 还有一个非常重要的属性 to，定义点击之后，要到哪里去， 如：<router-link to="/foo">Go to Foo</router-link>

  2. js 中配置路由
    首先要定义route, 一条路由的实现。它是一个对象，由两个部分组成：path和component. path 指路径，component 指的是组件。如：{ path: ‘/foo’, component: Foo }
    这里有两条路由，组成一个routes: 

    1
    2
    3
    4
    const routes = [
          { path: '/foo', component: Foo },
          { path: '/bar', component: Bar }
     	]

    最后创建router 对路由进行管理，它是由构造函数 new vueRouter() 创建，接受routes 参数。

    1
    2
    3
    const router = new VueRouter({
      	 routes // (缩写) 相当于 routes: routes
    })

    配置完成后，把 router 实例注入到 vue 根实例中,就可以使用路由了。

    1
    2
    3
    const app = new Vue({
         		router
       	}).$mount('#app')

    执行过程：当用户点击 router-link 标签时，会去寻找它的 to 属性，它的 to 属性和 js 中配置的路径{ path: '/foo', component: Foo} path 一一对应，从而找到了匹配的组件，最后把组件渲染到 <router-view> 标签所在的地方。所有的这些实现才是基于 hash 实现的。

vue-cli 示例：

创建一个vue-cli项目：
1
vue create simpleRouterDemo

提示：

Invalid project name: “simpleRouterDemo”
Warning: name can no longer contain capital letters

换成横线连接的名字：

1
vue create simple-router-demo
在src 目录下新建两个组件，home.vue 和 about.vue

home.vue

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<template>
  <div>
    <h1>home</h1>
    <p>{{msg}}</p>
  </div>
</template>
<script>
export default {
  data() {
    return {
      msg: "我是home 组件",
    };
  },
};
</script>

about.vue

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<template>
  <div>
    <h1>about</h1>
    <p>{{aboutMsg}}</p>
  </div>
</template>
<script>
export default {
  data() {
    return {
      aboutMsg: "我是about组件",
    };
  },
};
</script>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<template>
  <div id="app">
    <img src="./assets/logo.png" />
    <header>
      <!-- router-link 定义点击后导航到哪个路径下 -->
      <router-link to="/home">Home</router-link>
      <br />
      <router-link to="/about">About</router-link>
    </header>
    <!-- 对应的组件内容渲染到router-view中 -->
    <router-view></router-view>
  </div>
</template>

<script>
export default {};
</script>
在 src目录下新建 router.js 定义router, 就是定义路径到组件的映射。
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
import Vue from "vue";
import VueRouter from "vue-router";

// 引入组件
import home from "./home.vue";
import about from "./about.vue";

// 要告诉 vue 使用 vueRouter
Vue.use(VueRouter);

const routes = [
    {
        path: "/home",
        component: home
    },
    {
        path: "/about",
        component: about
    },
    // 重定向
    {
        path: '/',
        redirect: '/home'
    }
]

var router = new VueRouter({
    routes
})
export default router;

注意：假如上面没有重定向，可以注释掉运行观察，点击页面上的home 和about 可以看到组件来回切换。但是有一个问题，当首次进入页面的时候，页面中并没有显示任何内容（期望进来默认显示 home ）。这是因为首次进入页面时，它的路径是 ‘/‘，我们并没有给这个路径做相应的配置。一般，页面一加载进来都会显示home页面，我们也要把这个路径指向home组件。但是如果我们写{ path: ‘/‘, component: Home },vue 会报错，因为两条路径却指向同一个方向。这怎么办？这需要重定向，所谓重定向，就是重新给它指定一个方向，它本来是访问 / 路径，我们重新指向‘/home’, 它就相当于访问 ‘/home’, 相应地, home组件就会显示到页面上。vueRouter中用 redirect 来定义重定向。

1
2
3
4
5
// 重定向
{
    path: '/',
    redirect: '/home'
}
把路由注入到根实例中，启动路由

这里其实还有一种方法，就像vuex store 注入到根实例中一样，我们也可以把vueRouter 直接注入到根实例中。在main.js中引入路由，注入到根实例中。

1
2
3
4
5
6
7
8
9
10
11
12
13
import Vue from 'vue'
import App from './App.vue'

// Vue.config.productionTip = false


// 引入路由
import router from "./router.js"    // import router 的router 一定要小写， 不要写成Router, 否则报 can't match的报错
new Vue({
  el: '#app',
  router,  // 注入到根实例中
  render: h => h(App)
})
运行
1
npm run serve

遇到错误：

1
2
3
4
Failed to compile.

./src/router.js
Module not found: Error: Can't resolve 'vue-router' in '/Users/zhang/FE/learn-vue/vueCliProjects/simple-router-demo/src'

注意需要安装：

1
npm install --save vue-router
示例的路由是怎么实现？

打开浏览器控制台，首先看到 router-link 标签渲染成了 a 标签，to 属性变成了a 标签的 href 属性，这时就明白了点击跳转的意思。router-view 标签渲染成了我们定义的组件，其实它就是一个占位符，它在什么地方，匹配路径的组件就在什么地方，所以 router-link 和router-view 标签一一对应，成对出现。

当点击Home和About 来回切换时，a 标签有一个样式类 .router-link-active 也在来回切换， 原来这是当router-link 处于选中状态时，vueRouter 会自动添加这个类，因此我们也可以利用这个类来改变选中时的状态，如选中时，让它变成红色。但当设置 .router-link-active {color: red;}，它并没有生效，这时还要在类前面加一个a, a.router-link-active {color: red;}, 这样就没有问题了。未处于选中状态的router-link， 我们也想给它更改样式，怎么办? 直接给它添加一个 class 就可以了， <router-link class="red">Home</router-link>

动态路由
上面我们定义的路由，都是严格匹配的，只有 router-link 中的to属性和 js 中一条路由 route 中 path 一模一样，才能显示相应的组件 component. 但有时现实却不是这样的，当我们去访问网站并登录成功后，它会显示 欢迎你，+ 你的名字。不同的用户登录， 只是显示“你的名字” 部分不同，其它部分是一样的。这就表示，它是一个组件，假设是 user 组件。不同的用户（就是用户的id不同），它都会导航到同一个 user 组件中。这样我们在配置路由的时候，就不能写死, 就是路由中的 path 属性，不能写死，那要怎么设置? 导航到 user 组件，路径中肯定有 user, id 不同，那就给路径一个动态部分来匹配不同的id. 在 vue-router 中，动态部分以 : 开头，那么路径就变成了 /user/:id，这条路由就可以这么写： { path:"/user/:id", component: user }.

我们定义一个user组件（自己随便写一个就好了），页面中再添加两个router-link 用于导航， 最后router.js中添加路由配置，来体验一下

app.vue 中添加两个router-link：

1
2
3
4
5
6
7
8
9
10
11
12
13
<template>
  <div id="app">
    <img src="./assets/logo.png">
    <header>
      <router-link to="/home">Home</router-link>
      <router-link to="/about">About</router-link>
     <!--  增加两个到user组件的导航，可以看到这里使用了不同的to属性 -->
      <router-link to="/user/123">User123</router-link>
      <router-link to="/user/456">User456</router-link>
    </header>
    <router-view></router-view>   
  </div>
</template>

router.js 配置user动态路由：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
...
...
import user from "./user.vue";
...
...
const routes = [
    {
        path: "/home",
        component: home
    },
    {
        path: "/about",
        component: about
    },
    /*新增user路径，配置了动态的id*/
    {
        path: "/user/:id",
        component: user
    },
    {
        path: '/',
        redirect: '/home'
    }
]

user.vue

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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
<!-- 简单示例 -->
<!-- <template>
  <div>
    <h1>User</h1>
    <div>我是user组件</div>
  </div>
</template>
<script>
export default {};
</script> -->


<!-- 传递参数示例 -->
<!-- <template>
  <div>
    <h1>User</h1>
    <div>我是user组件, 动态部分是{{dynamicSegment}}</div>
  </div>
</template>
<script>
export default {
  computed: {
    dynamicSegment() {
      return this.$route.params.id;
    },
  },
};
</script> -->

<!-- watch 来监听$route -->
<template>
  <div>
    <h1>User</h1>
    <div>我是user组件, 动态部分是{{dynamicSegment}}</div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      dynamicSegment: "",
    };
  },
  watch: {
    $route(to, from) {
      // to表示的是你要去的那个组件，from 表示的是你从哪个组件过来的，它们是两个对象，你可以把它打印出来，它们也有一个param 属性
      console.log(to);
      console.log(from);
      this.dynamicSegment = to.params.id;
    },
  },
};
</script>

当整个vue-router 注入到根实例后，在组件的内部，可以通过this.$route 来获取到 router 实例。它有一个params 属性，就是来获得这个动态部分的。它是一个对象，属性名，就是路径中定义的动态部分 id, 属性值就是router-link中to 属性中的动态部分，如123。使用vuex时，组件中想要获取到state 中的状态，是用computed 属性，在这里也是一样，在组件中，定义一个computed 属性 dynamicSegment
动态路由在来回切换时，由于它们都是指向同一组件，vue不会销毁再创建这个组件，而是复用这个组件，就是当第一次点击（如：user123）的时候，vue 把对应的组件渲染出来，但在user123, user456点击来回切换的时候，这个组件就不会发生变化了，组件的生命周期不管用了。这时如果想要在组件来回切换的时候做点事情，那么只能在组件内部（user.vue中）利用watch 来监听 $route 的变化。把上面的代码用监听$route 实现
上面示例还有个问题：在相同组件之间切换时因为不刷新组件,所以用watch 来监听$route;但是我发现从其他组件切换到该组件时,第一次没能触发watch里面的$route()函数;拿您的例子来说就是:当我从home组件或者about组件第一次切换到user组件的时候不能触发$route,导致不能获取到id;这是正常的吗? 是正常的， 从home 组件或about组件切换到user组件的时候，home组件或about组件销毁，user组件重新生成，user组件是一个全新的组件，不同组件的切换是组件的创建和销毁，不会走$route

嵌套路由
嵌套路由，主要是由我们的页面结构所决定的。当我们进入到home页面的时候，它下面还有分类，如手机系列，平板系列，电脑系列。当我们点击各个分类的时候，它还是需要路由到各个部分，如点击手机，它肯定到对应到手机的部分。

在路由的设计上，首先进入到 home ,然后才能进入到phone, tablet, computer. Phone, tablet, compute 就相当于进入到了home的子元素。所以vue 提供了childrens 属性，它也是一组路由,相当于我们所写的routes。

首先，在home页面上定义三个router-link 标签用于导航，然后再定义一个router-view标签，用于渲染对应的组件。router-link 和router-view 标签要一一对应。home.vue 组件修改如下：

1
2
3
4
5
6
7
8
9
10
11
12
<template>
    <div>
        <h1>home</h1>
<!-- router-link 的to属性要注意，路由是先进入到home,然后才进入相应的子路由如 phone,所以书写时要把 home 带上 -->
        <p>
            <router-link to="/home/phone">手机</router-link>
            <router-link to="/home/tablet">平板</router-link>
            <router-link to="/home/computer">电脑</router-link>
        </p>
        <router-view></router-view>
    </div>
</template>

router.js 配置路由，修改如下：

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
const routes = [
    {
        path:"/home",
　　　　　// 下面这个属性也不少，因为，我们是先进入home页面，才能进入子路由
        component: home,
　　　　 // 子路由
        children: [
            {
                path: "phone",
                component: phone
            },
            {
                path: "tablet",
                component: tablet
            },
            {
                path: "computer",
                component: computer
            }
        ]
    },
    {
        path: "/about",
        component: about
    },
    {
        path: "/user/:id",
        component: user
    },
    {
        path: '/', 
        redirect: '/home' 
    }
]

　　这时当我们点击home 时，它下面出现手机等字样，但没有任何对应的组件进行显示，这通常不是我们想要的。要想点击home时，要想渲染相对应的子组件，那还需要配置一条路由。当进入到home 时，它在children中对应的路由path 是空 ‘’，完整的childrens 如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
children: [
    {
        path: "phone",
        component: phone
    },
    {
        path: "tablet",
        component: tablet
    },
    {
        path: "computer",
        component: computer
    },
    // 当进入到home时，下面的组件显示
    {
        path: "",
        component: phone
    }
]

命名路由
命名路由，很简单，因为根据名字就可以知道，这个路由有一个名字，那就直接给这个路由加一个name 属性，就可以了。 给user 路由加一个name 属性：

1
2
3
4
5
{
        path: "/user/:id",
        name: "user",
        component: user
}

命名路由的使用, 在 router-link 中 to 属性就可以使用对象了, 

1
2
<router-link to="/user/123">User123</router-link> // 和下面等价 
<router-link :to="{ name: 'user', params: { userId: 123 }}">User</router-link>   // 当使用对象作为路由的时候，to前面要加一个冒号,表示绑定

编程式导航 主要应用到按钮点击上。当点击按钮的时候，跳转另一个组件, 这只能用代码，调用rourter.push() 方法。 当把 router 注入到根实例中后，组件中通过 this.$router 可以获取到 router, 所以在组件中使用 this.$router.push("home") 就可以跳转到 home 界面。