vue.js学习之router-link

2024年5月30日 166次阅读 来源: HEternally

在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>。

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

    原文作者：HEternally
    原文地址: https://segmentfault.com/a/1190000010630619
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。
点赞