- 首页
- 作品
- Vue Router 使用教程
- 3.2. router-link Props
3.2. router-link Props
to
- 类型:
string | Location
- required
表示目标路由的链接。当被点击后,内部会立刻把
to
的值传到 router.push()
,所以这个值可以是一个字符串或者是描述目标位置的对象。
<!-- 字符串 -->
<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
append
tag
active-class
- 类型:
string
- 默认值:
"router-link-active"
设置链接激活时使用的 CSS 类名。默认值可以通过路由的构造选项 linkActiveClass
来全局配置。
exact
event
- 类型:
string | Array<string>
- 默认值:
'click'
声明可以用来触发导航的事件。可以是一个字符串或是一个包含字符串的数组。
exact-active-class
- 类型:
string
- 默认值:
"router-link-exact-active"
配置当链接被精确匹配的时候应该激活的 class。注意默认值也是可以通过路由构造函数选项 linkExactActiveClass
进行全局配置的。
aria-current-value
- 类型:
'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false'
- 默认值:
"page"
当链接根据精确匹配规则激活时配置的 aria-current
的值。这个值应该是 ARIA 规范中允许的 aria-current 的值。在绝大多数场景下,默认值 page
应该是最合适的。