vue.js学习之router-link

在vue2.0中，原来的v-link指令已经被<router-link>组件替代了，这个组件接受以下属性参数：

• to：一个路径字符串，或者一个Location Descriptor对象。
• tag：渲染的html元素类型，默认是a。
• exact：用于控制当前激活项的匹配行为（严格匹配或者贪婪匹配）。
• append：控制相对链接路径的追加方式。
• replace：替代而不是作为历史条目压榨你。
• active-class：当前链接项激活时增加的css样式。

例如：

<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>
          <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>
      </ul>
      <router-view class="view"></router-view>
    </div>

原文地址：router-link · GitBook
<router-link>组件支持用户在具有路由功能的应用中（点击）导航。通过to属性指定目标地址，默认渲染成带有正确链接的a标签，可以通过配置tag属性生成别的标签。另外，当目标路由成功激活时，链接元素自动设置一个表示激活的css类名。

<router-link>比起写死的a会好一些，理由如下：

• 无论是HTML5 history模式还是hash模式，它的表现行为一致，所以，当你要切换路由模式，或者在IE9降级使用hash模式，无须作任何变动。
• 在HTML5 history模式下，router-link会拦截点击事件，让浏览器不在重新加载页面。
• 当你在HTML5 history模式下使用base选项之后，所有的to属性都不需要写（基路径）了。

Props

• to
• 类型: string | Location
• required
• 表示目标路由的链接。当被点击后，内部会立刻把 to 的值传到 router.push()，所以这个值可以是一个字符串或者是描述目标位置的对象。
  <!-- 字符串 -->
• <router-link to="home">Home</router-link>
• <!-- 渲染结果 -->
• Home
• <!-- 使用 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
• 类型: boolean
• 默认值: false
• 设置 replace 属性的话，当点击时，会调用 router.replace() 而不是 router.push()，于是导航后不会留下 history 记录。
• <router-link :to="{ path: '/abc'}" replace></router-link>
  append
• 类型: boolean
• 默认值: false

• 设置 append 属性后，则在当前（相对）路径前添加基路径。例如，我们从 /a 导航到一个相对路径b，如果没有配置 append，则路径为 /b，如果配了，则为 /a/b

  • <router-link :to="{ path: 'relative/path'}" append></router-link>
    tag
• 类型: string
• 默认值: "a"
• 有时候想要 <router-link> 渲染成某种标签，例如 <li>。 于是我们使用 tag prop 类指定何种标签，同样它还是会监听点击，触发导航。
• <router-link to="/foo" tag="li">foo</router-link>
• <!-- 渲染结果 -->
• <li>foo</li>
• active-class
• 类型: string
• 默认值: "router-link-active"
• 设置 链接激活时使用的 CSS 类名。默认值可以通过路由的构造选项 linkActiveClass 来全局配置。
• exact
  类型: boolean

默认值: false

• "是否激活" 默认类名的依据是 inclusive match （全包含匹配）。 举个例子，如果当前的路径是 /a 开头的，那么 <router-link to="/a"> 也会被设置 CSS 类名。
  按照这个规则，<router-link to="/"> 将会点亮各个路由！想要链接使用 "exact 匹配模式"，则使用 exact 属性：

<!-- 这个链接只会在地址为 / 的时候被激活 -->
<router-link to="/" exact>
查看更多关于激活链接类名的例子 可运行.
将"激活时的CSS类名"应用在外层元素
有时候我们要让 "激活时的CSS类名" 应用在外层元素，而不是 a 标签本身，那么可以用<router-link> 渲染外层元素，包裹着内层的原生 a 标签：

<router-link tag="li" to="/foo">
 <a>/foo</a>
</router-link>

在这种情况下，a 将作为真实的链接（它会获得正确的 href 的），而 "激活时的CSS类名" 则设置到外层的 <li>。

欢迎光临我的个人微博 知乎 微信公众号