Vue-Router安装与使用
# 介绍
Vue Router 是 Vue.js (opens new window) 官方的路由管理器。它和 Vue.js 的核心深度集成,让构建单页面应用变得易如反掌。
# 安装
1.在已有Vue项目中手动安装vue-router
npm install --save vue-router
- 使用vue-cli创建自带vue-router的新项目
空格选择/取消 a全选 i反选
vue create project_name
#Vue 会询问你使用哪种配置
Default ([Vue 2] babel, eslint)
Default (Vue 3 Preview) ([Vue 3] babel, eslint)
Manually select features
#请选择 Manually select features,Vue会询问你当前项目需要哪些配置
Check the features needed for your project: (Press <space> to select, <a> to toggle all, <i> to invert selection)
>(*) Choose Vue version
(*) Babel
( ) TypeScript
( ) Progressive Web App (PWA) Support
( ) Router
( ) Vuex
( ) CSS Pre-processors
(*) Linter / Formatter
( ) Unit Testing
( ) E2E Testing
#请将Router 选中,后面一系列的询问按照实际情况进行选择就好
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 路由的基础配置
如果选择了第一种安装方式(
手动安装
),需要手动在src
文件夹下新建一个名为router
的文件夹并新建index.js
文件如果选择了第二种安装方式(
自定义安装
),不用自己进行配置,新建项目完毕后就可以直接使用了
# 将Router安装到Vue中
如果需要让当前Vue实例支持路由功能
.需要在Vue实例化时将VueRouter
的实例对象注入到Vue实例配置选项router中。(手动安装
)
// src/router/index.js
import Vue from 'vue' // 引入Vue
import VueRouter from 'vue-router' // 引入VueRouter
// Vue支持VueRouter
Vue.use(VueRouter)
let router = new VueRouter() // 初始化VueRouter
new Vue({
router // 将VueRouter的实例对象配置到Vue实例化配置对象的router选项中
}).$mount('#app')
2
3
4
5
6
7
8
9
10
11
12
13
main.js
中引用
// src/main.js
import router from './router'
new Vue({
router,
render: h => h(App)
}).$mount('#app')
2
3
4
5
6
7
8
# Router的相关配置
属性名 | 类型 | 描述 |
---|---|---|
routes | Array | 当前Router中所有路由配置 |
modeString | 可选值: "hash" / "history" | 默认值'hash' 该模式下路由使用hash保证路由与视图一致history 模式使用h5新增 window.history 实现路由与视图一致 |
linkActiveClass | String 默认值: "router-link-active" | 全局配置 <router-link> 默认的激活的 class |
linkExactActiveClass | String 默认值: "router-link-exact-active" | 全局配置 <router-link> 默认的精确激活的 class。 |
严格匹配link标签to路由路径必须全等于当前浏览器的url,非严格匹配当前浏览器url可以为当前link的子路由。
例子
to="/home" url="/home/user" 非严格匹配
to="/home" url="/home/user/10086" 非严格匹配
to="/home" url="/home" 严格匹配
to="/" url="/order" / 是所有路由的根路由,所以他们非严格匹配
2
3
4
# Router.routes 的相关配置
{
path: string,
component?: Component, // 当前路由匹配时显示的路由组件
name?: string, // 命名路由
redirect?: string | Location | Function, // 路由重定向
props?: boolean | Object | Function, //
alias?: string | Array<string>, // 路由别名
children?: Array<RouteConfig>, // 嵌套路由
beforeEnter?: (to: Route, from: Route, next: Function) => void, //路由守卫
caseSensitive?: boolean, // 匹配规则是否大小写敏感?(默认值:false)
}
2
3
4
5
6
7
8
9
10
11
# 实现一个简单的路由
# 1.配置路由
import Vue from 'vue'
import VueRouter from 'vue-router'
import App from './App.vue'
import Home from './views/Home'
import Order from './views/Order'
import User from './views/User'
// Vue支持VueRouter
Vue.use(VueRouter)
let router = new VueRouter({
routes: [
{
path: '/home',
component: Home
},
{
path: '/order',
component: Order
},
{
path: '/user',
component: User
}
]
})
new Vue({
render: h => h(App),
router
}).$mount('#app')
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
# 2. 在组件中实现路由
VueRouter给Vue提供了两个组件
- router-link
- router-view
# 1. router-link 用于实现路由的跳转组件:该组件支持的属性
to: string | location
当用户点击该组件时就会跳转至to指定的路由
// 导航指定的url
<router-link to="/home">主页</router-link>
<router-link to="/order">订单</router-link>
<router-link to="/user">用户</router-link>
/* 导航指定的location
vue router中location对象的常用属性{
path:'/', //指定跳转路由的路径
hash:'#top' // 指定跳转路由的哈希值
name: 'Home', // 指定跳转的具名路由的name值
params: {}, // 指定跳转的路由传递params对象
query: {} // 指定跳转的路由传递query键值对
}
*/
<router-link :to="{path:'/user'}">user</router-link>
// 使用location进行页面跳转时,当前location的params属性无法传递给路由组件的
<router-link :to="{path:'/user',hash:'#top',params:{id:1,name:'小明'}}">user</router-link>
// 使用name路由导航,可以向任何具名路由传递params
<router-link :to="{name:'User',hash:'#top',params:{id:1,name:'小明'}}">user</router-link>
// query支持 name导航和path导航,不推荐传递对象属性时使用query传参
<router-link :to="{name:'User',hash:'#top',query:{id:1,name:'小明'}}">user</router-link>
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
replace: bool
当该属性为真时,路由的跳转将以替换的形式
跳转到下一个页面(下一个路由会把当前浏览器历史记录栈中的url替换成将要跳转的路由),默认值为false
// 使用替换的形式跳转路由
<router-link class="tab-item" replace to="/user">用户</router-link>
2
append: bool
当该属性为真时,当前路由如果是相对路径(路径没有/开头)路由的跳转将会基于浏览器url
进行下一级的跳转,默认值为false
// 如果当前浏览器url /order
// 点击 Gec 会跳转到 /order/gec
<router-link to="gec" append>Gec</router-link>
// 点击 Gec1 因为Gec1的to不是相对路径 append就会无效,路由会跳转到 /gec
<router-link to="/gec" append>Gec1</router-link>
// 点击 Gec2 没有append 会跳转到 /gec
<router-link to="gec">Gec2</router-link>
2
3
4
5
6
7
tag: string
指定当该router-link标签最终以什么DOM元素渲染到页面上,默认值是a
// 将router-link以span元素渲染到页面上
<router-link tag="span" class="tab-item" to="/">主页</router-link>
2
active-class: string
指定当前router-link元素,如果与浏览器url非严格匹配时class名。默认值是VueRouter实例化时 linkActiveClass 指定值
// 当前router-link非严格匹配时class名为aaaa
<router-link active-class="aaaa" to="/order">订单</router-link>
2
exact-active-class:string
指定当前router-link元素,如果与浏览器url严格匹配时class名。默认值是VueRouter实例化时 linkExactActiveClass 指定值
// 当前router-link严格匹配时class名为ex
<router-link exact-active-class="ex" to="/">主页</router-link>
2
exact: bool
指定当前router-link元素使用严格匹配,这时active-class 只能在严格匹配
的模式下被激活,默认值false
// 当前路由开启严格匹配模式
<router-link exact to="/">主页</router-link>
2
event: string | Array<string>
指定当前router-link元素,声明可以用来触发导航的事件。可以是一个字符串或是一个包含字符串的数组。默认值是click
// 双击 和 点击都能触发当前元素的路由跳转
<router-link :event="['dblclick','click']" to="/">主页</router-link>
2
# 2. router-view 根据当前VueRouter的配置,当路由路由路径发生改变时渲染对应的路由视图组件
router-view 组件是一个 functional 组件,渲染路径匹配到的视图组件。<router-view>
渲染的组件还可以内嵌自己的 <router-view>
,根据嵌套路径,渲染嵌套组件。
其他属性 (非 router-view 使用的属性除name) 都直接传给渲染的组件
,很多时候,每个路由的数据都是包含在路由参数中。
<div id="app">
<router-view data="somedata"/>
</div>
// data属性会作为props直接传递给 router-view渲染的视图组件
2
3
4
因为它也是个组件,所以可以配合 transition
和 keep-alive
使用。如果两个结合一起用,要确保在内层使用 keep-alive
:
<transition name="fade">
<keep-alive>
<router-view></router-view>
</keep-alive>
</transition>
2
3
4
5