vue.js學習之router-link

在vue2.0中,原來的v-link指令已經被<router-link>組件替代了,這個組件接受如下屬性參數:php

  • to:一個路徑字符串,或者一個Location Descriptor對象。
  • tag:渲染的html元素類型,默認是a。
  • exact:用於控制當前激活項的匹配行爲(嚴格匹配或者貪婪匹配)。
  • append:控制相對連接路徑的追加方式。
  • replace:替代而不是做爲歷史條目壓榨你。
  • active-class:當前連接項激活時增長的css樣式。

例如: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類名。html

<router-link>比起寫死的a會好一些,理由以下:vue

  • 不管是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

默認值: falseapp

  • "是否激活" 默認類名的依據是 inclusive match (全包含匹配)。 舉個例子,若是當前的路徑是 /a 開頭的,那麼 <router-link to="/a"> 也會被設置 CSS 類名。
    按照這個規則,<router-link to="/"> 將會點亮各個路由!想要連接使用 "exact 匹配模式",則使用 exact 屬性:

<!-- 這個連接只會在地址爲 / 的時候被激活 -->
<router-link to="/" exact>
查看更多關於激活連接類名的例子 可運行.
將"激活時的CSS類名"應用在外層元素
有時候咱們要讓 "激活時的CSS類名" 應用在外層元素,而不是 a 標籤自己,那麼能夠用<router-link> 渲染外層元素,包裹着內層的原生 a 標籤:ui

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

在這種狀況下,a 將做爲真實的連接(它會得到正確的 href 的),而 "激活時的CSS類名" 則設置到外層的 <li>。.net

歡迎光臨個人我的微博 知乎 微信公衆號code

相關文章
相關標籤/搜索