<router-link>屬性詳解


<router-link>組件支持用戶在具有路由功能的應用中點擊導航。通過to屬性指定目標地址,默認渲染為帶有正確連接的 <a> 標簽,可以通過配置tag屬性生成別的標簽。另外,當目標路由成功激活時,鏈接元素自動設置一個表示激活的css類名

 

<router-link>組件的屬性有:

to 、replace、 append、 tag、 active-class、 exact 、 event、 exact-active-class

 

to(必選參數):類型string/location

表示目標路由的鏈接,該值可以是一個字符串,也可以是動態綁定的描述目標位置的對象

<!-- 字符串 -->
<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

 

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 來全局配置。

<router-link :to="{path:'/about'}" active-class="activeClass">about</router-link>

默認值通過路由的構造選項 linkActiveClass 來全局配置,如下示例:

export default new Router({
  mode:'history',
  linkActiveClass:'is-active',
  routes: [
    {
      path:'/about',
      component:about
    }
]
})

 exact

  • 類型: boolean
  • 默認值: false

“是否激活” 默認類名的依據是 inclusive match (全包含匹配)。 舉個例子,如果當前的路徑是 /a 開頭的,那么<router-link to="/a">也會被設置 CSS 類名。

按照這個規則,<router-link to="/"> 將會點亮各個路由!想要鏈接使用 “exact 匹配模式”,則使用 exact 屬性:

<!-- 這個鏈接只會在地址為 / 的時候被激活 -->
<router-link to="/" exact>

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM