安装
模块化工程中使用它,必须要通过 Vue.use() 明确地安装路由功能
import Vue from 'vue'
import VueRouter from 'vue-router'
Vue.use(VueRouter)
<!-- 使用 router-link 组件来导航. -->
<!-- 通过传入 `to` 属性指定链接. -->
<!-- <router-link> 默认会被渲染成一个 `<a>` 标签 -->
<router-link to="/foo">Go to Foo</router-link>
<!-- 路由出口 -->
<!-- 路由匹配到的组件将渲染在这里 -->
<router-view></router-view>
<!--自动设置 class 属性值 .router-link-active-->
动态路由匹配
『动态路径参数』(dynamic segment)
const router = new VueRouter({
routes: [
// 动态路径参数 以冒号开头
{ path: '/user/:id', component: User }
]
})
/user/foo 和 /user/bar 都将映射到相同的路由
<router-link to="/user/foo">/user/foo</router-link>
const User = {
template: '<div>User {{ $route.params.id }}</div>'
}
// foo
/user/:username/post/:post_id
/user/evan/post/123
{ username: 'evan', post_id: 123 }
嵌套路由
const router = new VueRouter({
routes: [
{ path: '/user/:id', component: User,
children: [
{
// 当 /user/:id 匹配成功,
// UserHome 会被渲染在 User 的 <router-view> 中
{ path: '', component: UserHome },
// 当 /user/:id/profile 匹配成功,
// UserProfile 会被渲染在 User 的 <router-view> 中
path: 'profile',
component: UserProfile
},
{
// 当 /user/:id/posts 匹配成功
// UserPosts 会被渲染在 User 的 <router-view> 中
path: 'posts',
component: UserPosts
}
]
}
]
})
以 / 开头的嵌套路径会被当作根路径。 这让你充分的使用嵌套组件而无须设置嵌套的路径
编程式的导航
router.push(location, onComplete?, onAbort?)
在 Vue 实例内部,你可以通过 $router 访问路由实例。因此你可以调用 this.$router.push
const userId = 123
router.push({ name: 'user', params: { userId }}) // -> /user/123
router.push({ path: `/user/${userId}` }) // -> /user/123
//它不会向 history 添加新记录,替换掉当前的 history 记录
router.replace(location, onComplete?, onAbort?)
<router-link :to="..." replace>
router.replace(...)
//参数是一个整数
//意思是在 history 记录中向前或者后退多少步,类似 window.history.go(n)。
router.go(n)
命名路由
name
const router = new VueRouter({
routes: [
{
path: '/user/:userId',
name: 'user',
component: User
}
]
})
<router-link :to="{ name: 'user', params: { userId: 123 }}">User</router-link>
//
router.push({ name: 'user', params: { userId: 123 }})
命名视图
router-view 没有设置名字,那么默认为 default
<router-view class="view one"></router-view>
<router-view class="view two" name="a"></router-view>
<router-view class="view three" name="b"></router-view>
const router = new VueRouter({
routes: [
{
path: '/',
components: {
default: Foo,
a: Bar,
b: Baz
}
}
]
})
重定向 和 别名
const router = new VueRouter({
routes: [
{ path: '/a', redirect: '/b' }
]
})
//命名路由
const router = new VueRouter({
routes: [
{ path: '/a', redirect: { name: 'foo' }}
]
})
别名
/a 的别名是 /b,意味着,当用户访问 /b 时,URL 会保持为 /b,但是路由匹配则为 /a,就像用户访问 /a 一样
const router = new VueRouter({
routes: [
{ path: '/a', component: A, alias: '/b' }
]
})
路由组件传参
使用props解耦
const User = {
props: ['id'],
template: '<div>User {{ id }}</div>'
}
const router = new VueRouter({
routes: [
{ path: '/user/:id', component: User, props: true }
// 对于包含命名视图的路由,你必须分别为每个命名视图添加props选项:
{
path: '/user/:id',
components: { default: User, sidebar: Sidebar },
props: { default: true, sidebar: false }
}
]
})
HTML5 History 模式
vue-router 默认 hash
模式 —— 使用 URL 的 hash 来模拟一个完整的 URL,于是当 URL 改变时,页面不会重新加载。
history
模式,这种模式充分利用 history.pushState API 来完成 URL 跳转而无须重新加载页面。需要后台配置支持
const router = new VueRouter({
mode: 'history',
routes: [...]
})
导航守卫
路由元信息
定义路由的时候可以配置 meta 字段
过渡动效
<transition>
<router-view></router-view>
</transition>
数据获取
导航完成后获取数据
// replace getPost with your data fetching util / API wrapper
替换getPost用你自己的数据fetching工具或API 包
在导航完成前获取数据
滚动行为
这个功能只在 HTML5 history 模式下可用。
mode:'history'
懒加载
使用的是 Babel,你将需要添加 syntax-dynamic-import
插件,才能使 Babel 可以正确地解析语法。
const Foo = () => import('./Foo.vue')
网友评论