1. 程式人生 > >Vue中router-link介紹

Vue中router-link介紹

原文地址:http://router.vuejs.org/zh-cn/api/router-link.html

<router-link>

<router-link> 元件支援使用者在具有路由功能的應用中(點選)導航。 通過 to 屬性指定目標地址,預設渲染成帶有正確連結的 <a> 標籤,可以通過配置 tag 屬性生成別的標籤.。另外,當目標路由成功啟用時,連結元素自動設定一個表示啟用的 CSS 類名。

<router-link> 比起寫死的 <a href="..."> 會好一些,理由如下:

  • 無論是 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>
  • <!-- 渲染結果 -->
  • <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
    • 型別: 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>