<router-link> 组件支持用户在具有路由功能的应用中 (点击) 导航
to 属性指定目标地址,默认渲染成带有正确链接的 <a> 标签,可以通过配置 tag 属性生成别的标签。另外,当目标路由成功激活时,链接元素自动设置一个表示激活的 CSS 类名
<router-link> 比起写死的 <a href="..."> 会好一些
router-link 会守卫点击事件,让浏览器不再重新加载页面base 选项之后,所有的 to 属性都不需要写 (基路径) 了router-link 通过一个作用域插槽暴露底层的定制能力。这是一个更高阶的 API,主要面向库作者,但也可以为开发者提供便利,多数情况用在一个类似 NavLink 这样的自定义组件里
在使用 v-slot API 时,需要向 router-link 传入一个单独的子元素。否则 router-link 将会把子元素包裹在一个 span 元素内
<router-link to="/about" custom v-slot="{ href, route, navigate, isActive, isExactActive }">
<NavLink :active="isActive" :href="href" @click="navigate">{{ route.fullPath }}</NavLink>
</router-link>href:解析后的 URL。将会作为一个 a 元素的 href attributeroute:解析后的规范化的地址navigate:触发导航的函数。会在必要时自动阻止事件,和 router-link 同理isActive:如果需要应用激活的 class 则为 true。允许应用一个任意的 classisExactActive:如果需要应用精确激活的 class 则为 true。允许应用一个任意的 class把激活的 class 应用到一个外部元素而不是 <a> 标签本身,这时你可以在一个 router-link 中包裹该元素并使用 v-slot 属性 来创建链接
<router-link
to="/foo"
v-slot="{ href, route, navigate, isActive, isExactActive }"
custom
>
<li
:class="[isActive && 'router-link-active', isExactActive && 'router-link-exact-active']"
>
<a :href="href" @click="navigate">{{ route.fullPath }}</a>
</li>
</router-link>在 <a> 元素上添加一个 target="_blank",则 @click="navigate" 处理器会被忽略
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
<script src="https://unpkg.com/vue@2.7/dist/vue.js"></script>
<script src="https://unpkg.com/vue-router@3/dist/vue-router.js"></script>
<style>
a.router-link-active, li.router-link-active a {
color: #f66;
}
a.router-link-exact-active, li.router-link-exact-active a {
border-bottom: 1px solid #f66;
}
</style>
</head>
<body>
<div id="app">
<h1>Active Links</h1>
<ul>
<li>
<router-link to="/">/</router-link>
</li>
<li>
<router-link to="/" exact>/ (exact match)</router-link>
</li>
<li>
<router-link to="/users">/users</router-link>
</li>
<li>
<router-link to="/users" exact>/users (exact match)</router-link>
</li>
<li>
<router-link to="/users/evan">/users/evan</router-link>
</li>
<li>
<router-link to="/users/evan#foo">/users/evan#foo</router-link>
</li>
<li>
<router-link :to="{ path: '/users/evan', query: { foo: 'bar' }}">
/users/evan?foo=bar
</router-link>
</li>
<li><!-- #635 -->
<router-link :to="{ name: 'user', params: { username: 'evan' }, query: { foo: 'bar' }}" exact>
/users/evan?foo=bar (named view + exact match)
</router-link>
</li>
<li>
<router-link :to="{ path: '/users/evan', query: { foo: 'bar', baz: 'qux' }}">
/users/evan?foo=bar&baz=qux
</router-link>
</li>
<li>
<router-link to="/about">/about</router-link>
</li>
<router-link tag="li" to="/about">
<a>/about (active class on outer element)</a>
</router-link>
<li>
<router-link to="/gallery">/gallery (redirect to /gallery/image1)</router-link>
</li>
<li>
<router-link :to="{ name: 'gallery' }">/gallery named link (redirect to /gallery/image1)</router-link>
</li>
<li>
<router-link :to="{ name: 'image', params: {imageId: 'image2'} }">/gallery/image2</router-link>
</li>
<li>
<router-link :to="{ name: 'image', params: {imageId: 'image1'} }">/gallery/image1</router-link>
</li>
<li>
<router-link to="/redirect-gallery">/redirect-gallery (redirect to /gallery)</router-link>
</li>
<li>
<router-link :to="{ name: 'redirect-gallery' }">/redirect-gallery named (redirect to /gallery)</router-link>
</li>
<li>
<router-link to="/redirect-image">/redirect-image (redirect to /gallery/image1)</router-link>
</li>
<li>
<router-link :to="{ name: 'redirect-image' }">/redirect-image named (redirect to /gallery/image1)
</router-link>
</li>
<li>
<router-link to="/users?one" exact-path>/users?one</router-link>
</li>
<li>
<router-link to="/users?two" exact-path>/users?two</router-link>
</li>
<li>
<router-link to="/users/nested?two" exact-path>/users/nested?two</router-link>
</li>
</ul>
<router-view class="view"></router-view>
</div>
<script>
const Home = {template: '<div><h2>Home</h2></div>'}
const About = {template: '<div><h2>About</h2></div>'}
const Users = {
template: `
<div>
<h2>Users</h2>
<router-view></router-view>
</div>
`
}
const User = {template: '<div>{{ $route.params.username }}</div>'}
const Gallery = {
template: `
<div>
<h2>Gallery</h2>
<router-view></router-view>
</div>
`
}
const Image = {template: '<div>{{ $route.params.imageId }}</div>'}
const router = new VueRouter({
mode: 'hash',
base: "routerLink",
routes: [
{path: '/', component: Home},
{path: '/about', component: About},
{
path: '/redirect-gallery',
name: 'redirect-gallery',
redirect: {name: 'gallery'}
},
{
path: '/redirect-image',
name: 'redirect-image',
redirect: {name: 'image', params: {imageId: 'image1'}}
},
{
path: '/users',
component: Users,
children: [{path: ':username', name: 'user', component: User}]
},
{
path: '/gallery',
component: Gallery,
children: [
{
path: '',
name: 'gallery',
redirect: {name: 'image', params: {imageId: 'image1'}}
},
{path: ':imageId', component: Image, name: 'image'}
]
}
]
})
const app = new Vue({
router,
}).$mount('#app')
</script>
</body>
</html>表示目标路由的链接。当被点击后,内部会立刻把 to 的值传到 router.push(),所以这个值可以是一个字符串或者是描述目标位置的对象。
string | Location<!-- 字符串 -->
<router-link to="home">Home</router-link>
<!-- 渲染结果 -->
<a href="home">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属性的话,当点击时,会调用router.replace()而不是router.push(),于是导航后不会留下 history 记录
booleanfalse<router-link :to="{ path: '/abc'}" replace></router-link>设置append属性后,则在当前 (相对) 路径前添加基路径。例如,我们从/a导航到一个相对路径b,如果没有配置append,则路径为/b,如果配了,则为/a/b
booleanfalse<router-link :to="{ path: 'relative/path'}" append></router-link>有时候想要 <router-link> 渲染成某种标签,例如 <li>。于是我们使用tag类指定何种标签,同样它还是会监听点击,触发导航
string"a"<router-link to="/foo" tag="li">foo</router-link>
<!-- 渲染结果 -->
<li>foo</li>设置链接激活时使用的 CSS 类名。默认值可以通过路由的构造选项linkActiveClass来全局配置。
string"router-link-active"“是否激活”默认类名的依据是包含匹配
举个例子,如果当前的路径是 /a 开头的,那么 <router-link to="/a"> 也会被设置 CSS 类名。
按照这个规则,每个路由都会激活 <router-link to="/">!想要链接使用“精确匹配模式”,则使用 exact 属性:
booleanfalse<!-- 这个链接只会在地址为 / 的时候被激活 -->
<router-link to="/" exact></router-link>声明可以用来触发导航的事件。可以是一个字符串或是一个包含字符串的数组。
string | Array<string>'click'配置当链接被精确匹配的时候应该激活的 class。注意默认值也是可以通过路由构造函数选项 linkExactActiveClass 进行全局配置的
string"router-link-exact-active"当链接根据精确匹配规则激活时配置的 aria-current 的值。这个值应该是 ARIA 规范中允许的 aria-current 的值。在绝大多数场景下,默认值 page 应该是最合适的
'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false'"page"<router-view> 组件是一个 functional 组件,渲染路径匹配到的视图组件。<router-view> 渲染的组件还可以内嵌自己的 <router-view>,根据嵌套路径,渲染嵌套组件
其他属性 (非 router-view 使用的属性) 都直接传给渲染的组件,很多时候,每个路由的数据都是包含在路由参数中。
因为它也是个组件,所以可以配合<transition>和<keep-alive>使用。如果两个结合一起用,要确保在内层使用<keep-alive>
<transition>
<keep-alive>
<router-view></router-view>
</keep-alive>
</transition>string"default"
如果 <router-view>设置了名称,则会渲染对应的路由配置中 components 下的相应组件。查看 命名视图 中的例子一个路由对象 (route object) 表示当前激活的路由的状态信息,包含了当前 URL 解析得到的信息,还有 URL 匹配到的路由记录 (route records)。
路由对象是不可变 (immutable) 的,每次成功的导航后都会产生一个新的对象。
路由对象出现在多个地方:
this.$route$route 观察者回调内router.match(location) 的返回值router.beforeEach((to, from, next) => {
// `to` 和 `from` 都是路由对象
})scrollBehavior 方法的参数:const router = new VueRouter({
scrollBehavior(to, from, savedPosition) {
// `to` 和 `from` 都是路由对象
}
})$route.path
类型: string
字符串,对应当前路由的路径,总是解析为绝对路径,如 "/foo/bar"
$route.params
类型: Object
一个 key/value 对象,包含了动态片段和全匹配片段,如果没有路由参数,就是一个空对象
$route.query
类型: Object
一个 key/value 对象,表示 URL 查询参数。例如,对于路径 /foo?user=1,则有 $route.query.user == 1,如果没有查询参数,则是个空对象
$route.hash
类型: string
当前路由的 hash 值 (带 #) ,如果没有 hash 值,则为空字符串
$route.fullPath
类型: string
完成解析后的 URL,包含查询参数和 hash 的完整路径
$route.matched
类型: Array<RouteRecord>
一个数组,包含当前路由的所有嵌套路径片段的路由记录 。路由记录就是 routes 配置数组中的对象副本 (还有在 children 数组)。
const router = new VueRouter({
routes: [
// 下面的对象就是路由记录
{
path: '/foo',
component: Foo,
children: [
// 这也是个路由记录
{ path: 'bar', component: Bar }
]
}
]
})当 URL 为 /foo/bar,$route.matched 将会是一个包含从上到下的所有对象 (副本)
通过在 Vue 根实例的router配置传入 router 实例,下面这些属性成员会被注入到每个子组件
this.$router
router 实例
this.$route
当前激活的路由信息对象(详见本页下方「路由对象」一节)。这个属性是只读的,里面的属性是 immutable (不可变) 的,不过你可以 watch (监测变化) 它