Vue2全家桶之二:vue-router(路由)詳細教程,看這個就夠了

這是我第5篇簡書。

??由于Vue在開發時對路由支持的不足,于是官方補充了vue-router插件。vue的單頁面應用是基于路由和組件的,路由用于設定訪問路徑,并將路徑和組件映射起來。傳統的頁面應用,是用一些超鏈接來實現頁面切換和跳轉的。在vue-router單頁面應用中,則是路徑之間的切換,實際上就是組件的切換。路由就是SPA(單頁應用)的路徑管理器。再通俗的說,vue-router就是我們WebApp的鏈接路徑管理系統。
??有的小伙伴會有疑慮,為什么我們不能像原來一樣直接用a標簽編寫鏈接呢?因為我們一般用Vue做的都是單頁應用,只有一個主頁面index.html,所以你寫的<a></a>標簽是不起作用的,要使用vue-router來進行管理。

一、安裝

如果你用vue-cli腳手架來搭建項目,配置過程會選擇是否用到路由(詳細見我上一篇簡書),如果選擇y,后面下載依賴會自動下載vue-router。
這里還是說一下安裝:npm install vue-router

二、創建組件

如果在一個模塊化工程中使用它,必須要通過 Vue.use() 明確地安裝路由功能,用vue-cli生產了我們的項目結構,src文件目錄下會有一個router文件夾,此處就是編寫路由組件的地方。在src/router/index.js,這個文件就是路由的核心文件:

import Vue from 'vue'   //引入Vue
import Router from 'vue-router'  //引入vue-router
import Hello from '@/components/Hello'  //引入根目錄下的Hello.vue組件
 
Vue.use(Router)  //Vue全局使用Router
 
export default new Router({
  routes: [              //配置路由,這里是個數組
    {                    //每一個鏈接都是一個對象
      path: '/',         //鏈接路徑
      name: 'Hello',     //路由名稱,
      component: Hello   //對應的組件模板
    },{
      path:'/hi',
      component:Hi,
      children:[        //子路由,嵌套路由 (此處偷個懶,免得單獨再列一點)
        {path:'/',component:Hi},
        {path:'hi1',component:Hi1},
        {path:'hi2',component:Hi2},
      ]
    }
  ]
})

三、router-link制作導航

1.router-link 是一個組件,它默認會被渲染成一個帶有鏈接的a標簽,通過to屬性指定鏈接地址。
注意:被選中的router-link將自動添加一個class屬性值.router-link-active。

<router-link to="/">[text]</router-link>
  • to:導航路徑,要填寫的是你在router/index.js文件里配置的path值,如果要導航到默認首頁,只需要寫成 to="/" ,
  • [text] :就是我們要顯示給用戶的導航名稱。

2.router-view 用于渲染匹配到的組件。
①.可以給router-view組件設置transition過渡Vue2.0 Transition常見用法全解惑)。

<transition name="fade">
  <router-view ></router-view>
</transition>

css過渡類名:
組件過渡過程中,會有四個CSS類名進行切換,這四個類名與transition的name屬性有關,比如name="fade",會有如下四個CSS類名:

  • fade-enter:進入過渡的開始狀態,元素被插入時生效,只應用一幀后立刻刪除。
  • fade-enter-active:進入過渡的結束狀態,元素被插入時就生效,在過渡過程完成后移除。
  • fade-leave:離開過渡的開始狀態,元素被刪除時觸發,只應用一幀后立刻刪除。
  • fade-leave-active:離開過渡的結束狀態,元素被刪除時生效,離開過渡完成后被刪除。

從上面四個類名可以看出,fade-enter-activefade-leave-active在整個進入或離開過程中都有效,所以CSS的transition屬性在這兩個類下進行設置。

過渡模式mode:

  • in-out(mode默認in-out模式):新元素先進入過渡,完成之后當前元素過渡離開。
  • out-in:當前元素先進行過渡離開,離開完成后新元素過渡進入。

②.還可以配合<keep-alive>使用,keep-alive可以緩存數據,這樣不至于重新渲染路由組件的時候,之前那個路由組件的數據被清除了。比如對當前的路由組件a進行了一些DOM操作之后,點擊進入另一個路由組件b,再回到路由組件a的時候之前的DOM操作還保存在,如果不加keep-alive再回到路由組件a時,之前的DOM操作就沒有了,得重新進行。如果你的應用里有一個購物車組件,就需要用到keep-alive。

<transition>
  <keep-alive>
    <router-view></router-view>
  </keep-alive>
</transition>

四、動態路由匹配

我們經常需要把某種模式匹配到的所有路由,全都映射到同個組件。
調用router的map方法映射路由,每條路由以key-value的形式存在,key是路徑,value是組件。例如:'/home'是一條路由的key,它表示路徑;{component: Home}則表示該條路由映射的組件:

router.map({
    '/home': { component: Home },
    '/about': { component: About }
})

例如,我們有一個 User 組件,對于所有 ID 各不相同的用戶,都要使用這個組件來渲染。那么,我們可以在 vue-router 的路由路徑中使用『動態路徑參數』來達到這個效果。

const User = {
  template: '<div>User</div>'
}

const router = new VueRouter({
  routes: [
    // 動態路徑參數 以冒號開頭
    { path: '/user/:id', component: User }
  ]
})

例如: /user/foo 和 /user/bar 都將映射到相同的路由。
一個『路徑參數』使用冒號 : 標記。當匹配到一個路由時,參數值會被設置到this.$route.params,可以在每個組件內使用。
你可以在一個路由中設置多段『路徑參數』,對應的值都會設置到 $route.params 中。例如:

五、vue-router參數傳遞

1.用name傳值(不推薦)
2.通過<router-link> 標簽中的to傳參
<router-link :to="{name:‘dxl’,params:{key:value}}">東西里</router-link>
  • name:就是我們在路由配置文件中起的name值。
    另:命名路由就是用一個名稱來標識一個路由,在定義路由的時候設置一個name屬性即可。在router-link中也可以用路由的名字來鏈接到一個路由。
  • params:就是我們要傳的參數,它也是對象形勢,在對象里可以傳遞多個值。
    最后用$route.params.username進行接收.
3.用url傳參

上面第五點也有提到。 :冒號的形式傳遞參數
(1).在router路由配置文件里以冒號的形式設置參數

{
    path:'/params/:newsId/:userName,
    component:Params
}

(2).組件形式,在src/components目錄下建立我們params.vue組件。
我們在頁面里輸出了url傳遞的參數。

<template>
    <div>
        <h2>{{ msg }}</h2>
        <p>新聞ID:{{ $route.params.newsId}}</p>
        <p>用戶名:{{ $route.params.userName}}</p>
    </div>
</template>
<script>
export default {
  name: 'params',
  data () {
    return {
      msg: 'params page'
    }
  }
}
</script>

(3).<router-view>標簽path路徑中傳值

<router-link to="/params/888/dxl shuai>params</router-link>

(4).正則表達式在URL傳值中的應用
希望我們傳遞的新聞ID只能是數字的形式,這時候我們就需要在傳遞時有個基本的類型判斷,path:'/params/:newsId(\\d+)/:userName'

六.響應路由參數的變化

當使用路由參數時,例如從 /user/foo 導航到 /user/bar,原來的組件實例會被復用。因為兩個路由都渲染同個組件,比起銷毀再創建,復用則顯得更加高效。不過,這也意味著組件的生命周期鉤子不會再被調用。
復用組件時,想對路由參數的變化作出響應的話:
(1). watch(監測變化) $route 對象:

const User = {
  template: '...',
  watch: {
    '$route' (to, from) {
      // 對路由變化作出響應...
    }
  }
}

(2).beforeRouteUpdate 導航守衛
如果目的地和當前路由相同,只有參數發生了改變 (比如從一個用戶資料到另一個 /users/1 -> /users/2),你需要使用 beforeRouteUpdate來響應這個變化 (比如抓取用戶信息)。

const User = {
  template: '...',
  beforeRouteUpdate (to, from, next) {
    // react to route changes...
    // don't forget to call next()
  }
}

七、實現不同路由不同頁面標題

// 定義路由的時候如下定義,name也可為中文
const routes = [
  { path: '/goods', component: goods, name: 'goods' },
  { path: '/orders', component: orders, name: 'orders' },
  { path: '/seller', component: seller, name: 'seller' }
];
// 創建路由實例
const router = new VueRouter({
  routes: routes
})
// 關鍵在這里,設置afterEach鉤子函數
router.afterEach((to, from, next) => {
  document.title = to.name;
})

八、重定向

剛進入應用都是進入到“/”這個路由的,如果想直接進入到“/goods”怎么辦,有兩種方法。一種是利用重定向,另一種是利用vue-router的導航式編程。
redirect基本重定向:

const routes = [
  { path: '/', redirect: '/goods'}
]
重定向的目標也可以是一個命名的路由。
const routes = [
  { path: '/', redirect: { name: 'goods' }}
]
重定向時也可以傳遞參數
{
  path:'/',
  redirect:'/goods/:newsId(\\d+)/:userName'
}

★.這里不得不提到alias別名的使用。
1.首先我們在路由配置文件里給路徑起一個別名,dxl。

{
    path: '/hi',
    component: Hi,
    alias:'/dxl'
 }

2.配置我們的<router-link>,起過別名之后,可以直接使用<router-link>標簽里的to屬性,進行重新定向。

<router-link to="/dxl">jspang</router-link>

區別:

  • redirect:仔細觀察URL,redirect是直接改變了url的值,把url變成了真實的path路徑。
  • alias:URL路徑沒有別改變,這種情況更友好,讓用戶知道自己訪問的路徑,只是改變了<router-view>中的內容。

★★★.注意一個大坑:
別名alias在path為'/'中,是不起作用的。

{
  path: '/',
  component: Hello,
  alias:'/home'
}

九、編程式導航

1.router.push( )
想要導航到不同的 URL,則使用 router.push (在創建vue實例并掛載后調用)。router.push方法就是用來動態導航到不同的鏈接的,這個方法會向 history 棧添加一個新的記錄,所以,當用戶點擊瀏覽器后退按鈕時,則回到之前的 URL。
當你點擊 <router-link> 時,這個方法會在內部調用,所以說,點擊 <router-link :to="..."> 等同于調用 router.push(...)。


注意:
如果提供了 path,params 會被忽略,而 query 并不屬于這種情況。取而代之的是下面例子的做法,你需要提供路由的 name 或手寫完整的帶有參數的 path:

const userId = 123
router.push({ name: 'user', params: { userId }}) // -> /user/123
router.push({ path: `/user/${userId}` }) // -> /user/123
// 這里的 params 不生效
router.push({ path: '/user', params: { userId }}) // -> /user

2.router.replace( )
router.replace跟 router.push 很像,唯一的不同就是,它不會向 history 添加新記錄,而是跟它的方法名一樣 —— 替換掉當前的 history 記錄。


3.router.go(n)
這個方法的參數是一個整數,意思是在 history 記錄中向前或者后退多少步,類似 window.history.go(n)。

// 在瀏覽器記錄中前進一步,等同于 history.forward()
router.go(1)
// 后退一步記錄,等同于 history.back()
router.go(-1)

自定義一個goback()方法,并使用this.$router.go(-1),進行后退操作

<script>
export default {
  name: 'app',
  methods:{
    goback(){
      this.$router.go(-1);
    },
    goHome(){
      this.$router.push('/');
    }
  }
}
</script>

十、路由中的鉤子

1.路由配置文件中的鉤子函數:
在路由文件中我們只能寫一個beforeEnter,就是在進入此路由配置時:

{
      path:'/params/:newsId(\\d+)/:userName',
      component:Params,
      beforeEnter:(to,from,next)=>{
        console.log('我進入了params模板');
        console.log(to);
        console.log(from);
        next();
},

三個參數:

  • to:路由將要跳轉的路徑信息,信息是包含在對像里邊的。
  • from:路徑跳轉前的路徑信息,也是一個對象的形式。
  • next:路由的控制參數,常用的有next(true)和next(false)。

2.寫在模板中的鉤子函數:
寫在模板中就可以有兩個鉤子函數可以使用。
beforeRouteEnter:在路由進入前的鉤子函數。
beforeRouteLeave:在路由離開前的鉤子函數。

export default {
  name: 'params',
  data () {
    return {
      msg: 'params page'
    }
  },
  beforeRouteEnter:(to,from,next)=>{
    console.log("準備進入路由模板");
    next();
  },
  beforeRouteLeave: (to, from, next) => {
    console.log("準備離開路由模板");
    next();
  }
}

★此處常用于數據獲取

  • 導航完成之后獲取:先完成導航,然后在接下來的組件生命周期鉤子中獲取數據。在數據獲取期間顯示『加載中』之類的指示。
    當你使用這種方式時,我們會馬上導航和渲染組件,然后在組件的 created 鉤子中獲取數據。這讓我們有機會在數據獲取期間展示一個 loading 狀態,還可以在不同視圖間展示不同的 loading 狀態。
    假設我們有一個 Post 組件,需要基于 $route.params.id 獲取文章數據:
<template>
  <div class="post">
    <div class="loading" v-if="loading">
      Loading...
    </div>
    <div v-if="error" class="error">
      {{ error }}
    </div>
    <div v-if="post" class="content">
      <h2>{{ post.title }}</h2>
      <p>{{ post.body }}</p>
    </div>
  </div>
</template>
export default {
  data () {
    return {
      loading: false,
      post: null,
      error: null
    }
  },
  created () {
    // 組件創建完后獲取數據,
    // 此時 data 已經被 observed 了
    this.fetchData()
  },
  watch: {
    // 如果路由有變化,會再次執行該方法
    '$route': 'fetchData'
  },
  methods: {
    fetchData () {
      this.error = this.post = null
      this.loading = true
      // replace getPost with your data fetching util / API wrapper
      getPost(this.$route.params.id, (err, post) => {
        this.loading = false
        if (err) {
          this.error = err.toString()
        } else {
          this.post = post
        }
      })
    }
  }
}
  • 導航完成之前獲取:導航完成前,在路由進入的守衛中獲取數據,在數據獲取成功后再執行導航。
    通過這種方式,我們在導航轉入新的路由前獲取數據。我們可以在接下來的組件的 beforeRouteEnter 守衛中獲取數據,當數據獲取成功后只調用 next 方法。
export default {
  data () {
    return {
      post: null,
      error: null
    }
  },
  beforeRouteEnter (to, from, next) {
    getPost(to.params.id, (err, post) => {
      next(vm => vm.setData(err, post))
    })
  },
  // 路由改變前,組件就已經渲染完了
  // 邏輯稍稍不同
  beforeRouteUpdate (to, from, next) {
    this.post = null
    getPost(to.params.id, (err, post) => {
      this.setData(err, post)
      next()
    })
  },
  methods: {
    setData (err, post) {
      if (err) {
        this.error = err.toString()
      } else {
        this.post = post
      }
    }
  }
}

十一、History 模式

vue-router 默認 hash 模式 —— 使用 URL 的 hash 來模擬一個完整的 URL,于是當 URL 改變時,頁面不會重新加載。

如果不想要很丑的 hash,我們可以用路由的 history 模式,這種模式充分利用 history.pushState API 來完成 URL 跳轉而無須重新加載頁面。

const router = new VueRouter({
  mode: 'history',
  routes: [...]
})

在學習過渡效果的時候,我們學了mode的設置,但是在路由的屬性中還有一個mode。
mode的兩個值:

  • histroy:當你使用 history 模式時,URL 就像正常的 url,http://www.dxl.com/user/id
    不過這種模式要玩好,還需要后臺配置支持。因為我們的應用是個單頁客戶端應用,如果后臺沒有正確的配置,當用戶在瀏覽器直接訪問 http://www.dxl.com/user/id就會返回 404,。所以要在服務端增加一個覆蓋所有情況的候選資源:如果 URL 匹配不到任何靜態資源,則應該返回同一個 index.html 頁面,這個頁面就是你 app 依賴的頁面。

    這么做以后,你的服務器就不再返回 404 錯誤頁面,因為對于所有路徑都會返回 index.html 文件。為了避免這種情況,你應該在 Vue 應用里面覆蓋所有的路由情況,然后在給出一個 404 頁面。
const router = new VueRouter({
  mode: 'history',
  routes: [
    { path: '*', component: Error}
  ]
})

這里的path:'*'就是找不到頁面時的配置,component是我們新建的一個Error.vue的文件

  • hash:默認’hash’值,但是hash看起來就像無意義的字符排列,不太好看也不符合我們一般的網址瀏覽習慣。不配置時是這樣的:http://localhost:8080/#/users,多個#號。

十二、路由組件傳參

(這點是直接粘貼的vue官網上的教程,此處是重點要多看多體會!)
在組件中使用 $route 會使之與其對應路由形成高度耦合,從而使組件只能在某些特定的 URL 上使用,限制了其靈活性。
解耦前:
id不能直接拿出來使用

const User = {
  template: '<div>User {{ $route.params.id }}</div>'
}
const router = new VueRouter({
  routes: [
    { path: '/user/:id', component: User }
  ]
})

使用 props 將組件和路由解耦:

const User = {
  props: ['id'],
  template: '<div>User {{ id }}</div>'
}
const router = new VueRouter({
  routes: [
    { path: '/user/:id', component: User, props: true },

    // 對于包含命名視圖的路由,你必須分別為每個命名視圖添加 `props` 選項:
    {
      path: '/user/:id',
      components: { default: User, sidebar: Sidebar },
      props: { default: true, sidebar: false }
    }
  ]
})

這樣你便可以在任何地方使用該組件,使得該組件更易于重用和測試。

1.布爾模式
如果 props 被設置為 true,route.params 將會被設置為組件屬性。

2.對象模式
如果 props 是一個對象,它會被按原樣設置為組件屬性。當 props 是靜態的時候有用。

const router = new VueRouter({
  routes: [
    { path: '/promotion/from-newsletter', component: Promotion, props: { newsletterPopup: false } }
  ]
})

3.函數模式
你可以創建一個函數返回 props。這樣你便可以將參數轉換成另一種類型,將靜態值與基于路由的值結合等等。

const router = new VueRouter({
  routes: [
    { path: '/search', component: SearchUser, props: (route) => ({ query: route.query.q }) }
  ]
})

/search?q=vue會將{query: 'vue'}作為屬性傳遞給 SearchUser 組件。
請盡可能保持 props 函數為無狀態的,因為它只會在路由發生變化時起作用。如果你需要狀態來定義 props,請使用包裝組件,這樣 Vue 才可以對狀態變化做出反應。

function dynamicPropsFn (route) {
  const now = new Date()
  return {
    name: (now.getFullYear() + parseInt(route.params.years)) + '!'
  }
}
const router = new VueRouter({
  mode: 'history',
  base: __dirname,
  routes: [
    { path: '/', component: Hello }, // No props, no nothing
    { path: '/hello/:name', component: Hello, props: true }, // Pass route.params to props
    { path: '/static', component: Hello, props: { name: 'world' }}, // static values
    { path: '/dynamic/:years', component: Hello, props: dynamicPropsFn }, // custom logic for mapping between route and props
    { path: '/attrs', component: Hello, props: { name: 'attrs' }}
  ]
})
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,663評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,125評論 3 414
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,506評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,614評論 1 307
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,402評論 6 404
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,934評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,021評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,168評論 0 287
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,690評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,596評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,784評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,288評論 5 357
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,027評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,404評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,662評論 1 280
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,398評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,743評論 2 370

推薦閱讀更多精彩內容

  • 一.安裝vue-router vue-router是一個插件包,所以我們還是需要用npm來進行安裝的。打開命令行工...
    錢小強_閱讀 2,031評論 0 9
  • 推薦我的vue教程:VUE系列教程目錄 前言 通過前面我寫的VUE入門博客,相信已經大概了解VUE是何物,但是對于...
    儂姝沁兒閱讀 2,979評論 4 19
  • vue-cli搭建項目 確保安裝了node與npm 再目標文件夾下打開終端 執行cnpm i vue-cli -g...
    Akiko_秋子閱讀 3,257評論 1 22
  • 2018年1月21日 星期日 陰有霧霾 讀魯迅先生《朝花夕拾》里《范愛農》一篇,知道魯先生在紹興師范任教時,范...
    木徒閱讀 1,579評論 0 1
  • 清晨放飛鴿子午后收回烏鴉因為無法凈化天空我必須不停地從深井汲水為它們清洗羽毛如果遇上了好天氣鴿子飛過的瞬間藍天更藍...
    竹影金旭閱讀 492評論 0 0