vue項目建立步驟和路由router知識點

時間 2020-05-30

原文原文鏈接

菜單快捷導航：html

vue項目建立
vue路由router知識點(路徑參數、查詢參數、命名路由、嵌套路由、命名視圖、hash/history模式)
vue導航守衛（全局守衛、單個路由獨享、組件級守衛）

一、建立一個vue項目步驟 （windows環境下）。建立vue項目前，檢查系統是否具有建立項目的條件（是否已經安裝好了node.js、webpack、vue-cli）。cmd打開終端。vue

1.1 若是還沒安裝node.js，則先安裝node.js ，安裝完成後，查看node版本node

node -v

1.2 安裝淘寶鏡像，安裝完成後查看npm版本：npm -vwebpack

npm install -g cnpm --registry=https://registry.npm.taobao.org

1.3 安裝webpackgit

npm install webpack -g

1.4 安裝vue全局腳手架，vue-cli2.x使用 npm install -g vue-cli ， vue-cli3.x使用 npm install -g @vue/cli 安裝，查看vue版本： vue -V github

npm install -g vue-cli

　　或 web

npm install -g @vue/cli

1.5 準備工做作好了，開始正式建立vue項目，建立vue項目能夠選擇兩種方式。下面的my_vue_pro是vue項目名字vue-router

vue init webpack my_vue_pro

　　或vue-cli

vue create my_vue_pro

　 vue init 是vue-cli2.x的初始化方式，可使用github上面的一些模板來初始化項目，webpack是官方推薦的標準模板名。vue-cli2.x項目向3.x遷移只須要把static目錄複製到public目錄下，老項目的src目錄覆蓋3.x的src目錄。 vue create 是vue-cli3.x的初始化方式，目前模板是固定的，模板選項可自由配置，建立出來的是vue-cli3的項目，與vue-cli2項目結構不一樣，配置方法不一樣，具體配置方法參考官方文檔。npm

　　若是vue版本仍是2.x, 從vue-cli2.x升級到最新版：先執行卸載： npm uninstall -g vue-cli ，再安裝最新版 npm install -g @vue/cli

1.6 cd進入項目

cd my_vue_pro

1.7 添加須要的依賴包，好比添加vue路由vue-router依賴包，可使用 npm install vue-router , 或者 vue add router

npm install vue-router

　　或

vue add router

1.8 安裝全部依賴包， npm install 。卸載依賴包： npm uninstall xxx

cnpm install

1.9 運行項目，查看package.json文件中的scripts腳本中的運行方式， npm run dev 或 npm run serve

npm run serve

二、vue路由vue-router解說

　　Vue Router 是 Vue.js 官方的路由管理器。它和 Vue.js 的核心深度集成，讓構建單頁面應用變得易如反掌。包含的功能有：

嵌套的路由/視圖表
模塊化的、基於組件的路由配置
路由參數、查詢、通配符
基於 Vue.js 過渡系統的視圖過渡效果
細粒度的導航控制
帶有自動激活的 CSS class 的連接
HTML5 歷史模式或 hash 模式，在 IE9 中自動降級
自定義的滾動條行爲

爲了加深對路由的理解，在安裝vue-router包後，若是項目自動生成了router.js，先刪除，咱們手動來寫一個router.js。建立router.js後，再新增長2個vue頁面，命名pageA和pageB，以下圖：

其中router.js代碼

import Vue from 'vue' import Router from 'vue-router'
//自定義頁面
import PageA from './views/PageA' import PageB from './views/PageB'

//安裝路由到vue
Vue.use(Router) const routes = [ { path: '/', redirect: '/pageB'  //重定向，設置默認進入pageB頁面
 }, { //動態路徑參數，以冒號開頭，若是有多個參數則繼續日後面追加
        path: '/pageA/:id/:name', name: 'pageA', component: PageA }, { path: '/pageB', name: 'pageB', component: PageB } ] export default new Router({ //mode: 'hash', //默認hash模式，hash模式有#；另外還有一種history模式，沒有#符號
 routes })

View Code

main.js是vue項目的入口腳本，在這裏引入router.js, 傳入路由配置。

import Vue from 'vue' import App from './App.vue' import router from './router.js' Vue.config.productionTip = false

new Vue({ router, //key名字必須命名爲router
  render: h => h(App) }).$mount('#app')

View Code

2.1 路由視圖<router-view> 組件和路由導航<router-link>組件

　在項目啓動模板頁App.vue上面有個<router-view>路由視圖組件，至關因而一個佔位符同樣（<slot>插槽也相似），以後頁面的路由變化引發的頁面替換都是在<router-view>路由視圖上進行。

　　而<router-link>有點相似於超連接標籤<a>，<router-link>上有個必寫的屬性to, 就相似於超連接<a>的href屬性，設置要跳轉的路由連接。

　　App.Vue測試代碼：

<template>
  <div id="app">
    <div id="nav">
      <router-link to="/pageA/5188/王大錘">pageA</router-link> |
      <router-link to="/pageB">pageB</router-link>
    </div>
    <router-view/>
  </div>
</template>

2.2 路徑參數和查詢參數

　　路徑參數和查詢參數做爲頁面之間的數據傳遞的一種方式，使用很是頻繁。路徑參數，望文生義意思是參數做爲路徑的一部分，在配置路由的時候把參數配置好，而後在瀏覽器中輸入url時，必須傳參，不然會找不到這個路由這個頁面。例如，pageA頁面的路由配置爲：/pageA/:id/:name ，意思是pageA頁面後面必須傳一個id參數和name參數，這兩個參數做爲路徑的一部分，必須傳值。而後在pageA頁面中用：this.$route.params 來獲取全部的路徑參數。

　　而查詢參數則沒有路徑參數這麼嚴格，路由不會對此作驗證。路由參數在url中的表現爲頁面連接後面加 ?key=value&... ，而後在頁面中用：this.$route.query 來獲取全部查詢參數。以下圖：

咱們打印this.$route變量，看到如上圖右邊部份內容：

this.$route.name : 頁面名字。這個name就是在router.js中配置的那個name, 這個name也是有大用處的，好比在<router-link>中使用「命名路由」的時候就是用到它，舉例說明，經過在路由連接標籤的to屬性設置name和相應的參數，而後跳轉效果和設置路由path是同樣的：
```
<router-link :to="{ name: 'pageA', params: { id: 5188, name:'王大錘' }}">命名路由pageA</router-link>
```
this.$route.path: 路由路徑，包含路徑參數，不包含查詢參數
this.$route.fullPath：路由全路徑，包含路徑參數和查詢參數
this.$route.query: 路徑全部查詢參數
this.$route.params: 路徑全部路徑參數
this.$route.meta: 路由元信息，在配置路由的時候能夠把自定義的一些數據存在meta中，用做其餘用途
this.$route.matched: 裏面包含了路由的一些匹配信息

2.3 路由props設置及路徑參數獲取

　　在設置頁面路由時，若是增長一個props屬性，並設置爲true, 則在頁面中能夠直接拿到參數，不須要經過this.$route.params來取參數。好比router.js中部分代碼：

{ path: '/pageC/:id/:name', name: 'pageC', props: true, //設置props屬性爲true, 則能夠在PageC頁面中直接取參數
 component: PageC }

在PageC頁面中參數獲取：

<template>
    <div class="box">
        <h1>佛山 -- 黃飛鴻，from PageC </h1>
        <h3>男兒何不帶吳鉤，收取關山五十州</h3>
        <h3>路徑參數id: {{this.id}}, name: {{this.name}}</h3>
    </div>
</template>

<script> export default { name: 'pageC', props: ['id', 'name'], //直接接收路徑參數
 created(){ console.log("id: ", this.id, ", name: ", this.name) } } </script>

2.4 嵌套路由。實際生活中的應用界面，一般由多層嵌套的組件組合而成。一樣地，URL 中各段動態路徑也按某種結構對應嵌套的各層組件。好比如今PageB頁面中嵌入頁面PageC, 則須要在PageB頁面中增長一個路由視圖<router-view>標籤，做爲嵌套頁面PageC的佔位符。

　　路由部分代碼：

{ path: '/pageB', name: 'pageB', component: PageB, meta: { isOK: true, type: 9 }, children: [ { path: 'pageC/:id/:name', component: PageC, props: true, //設置props屬性爲true, 則能夠在PageC頁面中直接取參數
                name: 'subPageC', meta: { requiresAuth: true, id: 51666 }, //自定義數據
 } ] },

View Code

　PageB頁面中部分代碼：

<template>
    <div class="box">
        <h1>一片雲 -- 羅小虎，from PageB </h1>
        <h3>千磨萬擊還堅勁，任爾東南西北風</h3>
        <!-- 嵌套路由，嵌套頁面佔位符 -->
        <router-view></router-view>
    </div>
</template>

<script> export default { name: 'pageB', created(){ console.log('...pageB...') console.log(this.$route) } } </script>

View Code

　　效果圖：

2.5 編程式的導航。　<router-link>叫聲明式導航，還有種編程式導航，格式爲：router.push(location, onComplete?, onAbort?), 在頁面中的使用例子：

// 字符串
router.push('home') // 對象
router.push({ path: 'home' }) // 命名的路由
router.push({ name: 'user', params: { userId: '123' }}) // 帶查詢參數，變成 /register?plan=private
router.push({ path: 'register', query: { plan: 'private' }}) /*注意：若是提供了 path，params 會被忽略，上述例子中的 query 並不屬於這種狀況。 取而代之的是下面例子的作法，你須要提供路由的 name 或手寫完整的帶有參數的 path： */ const userId = '123' router.push({ name: 'user', params: { userId }}) // -> /user/123
router.push({ path: `/user/${userId}` }) // -> /user/123 // 這裏的 params 不生效, 即編程式導航若是提供了path, 則路徑參數必須寫入path中。而查詢參數能夠不寫入
router.push({ path: '/user', params: { userId }}) // -> /user

　　一樣的編程式導航規則也適用於<router-link>導航組件的to屬性

　　router.replace(location, onComplete?, onAbort?) 和router.push(...)很像，惟一的不一樣就是，它不會向 history 添加新記錄，而是跟它的方法名同樣 —— 替換掉當前的 history 記錄。聲明式導航替換用法： <router-link :to="..." replace> ，編程式導航替換用法： router.replace(...)

router.go(n)的使用，這個方法的參數是一個整數，意思是在 history 記錄中向前或者後退多少步，相似 window.history.go(n)。

// 在瀏覽器記錄中前進一步，等同於 history.forward()
router.go(1) // 後退一步記錄，等同於 history.back()
router.go(-1) // 前進 3 步記錄
router.go(3) // 若是 history 記錄不夠用，那就默默地失敗唄
router.go(-100) router.go(100)

2.6 命名視圖。有時候想同時 (同級) 展現多個視圖，而不是嵌套展現，例如建立一個佈局，有 sidebar (側導航) 和 main (主內容) 兩個視圖，這個時候命名視圖就派上用場了。你能夠在界面中擁有多個單獨命名的視圖，而不是隻有一個單獨的出口。若是 router-view 沒有設置名字，那麼默認爲 default。

router.js中部分代碼：

{ path: '/pageD', name: 'pageD', components: { //演示命名視圖
            default: PageD, tanA: PageA, tanB: PageB } }

App.vue中部分代碼：

<router-view/>
    <!-- 命名視圖, 路由視圖名字匹配了，就會展現匹配的頁面內容 -->
    <router-view name="tanA"/>
    <router-view name="tanB"/>

2.7 路由模式。默認路由模式是hash模式，即地址欄中域名後帶有#符號（此 hash 不是密碼學裏的散列運算）。它的特色就是使用 URL 的 hash 來模擬一個完整的 URL，因而當 URL 改變時，頁面不會從新加載。不過看起來不是很美觀，另外hash模式的路由，在做爲回調地址和一些第三方公司合做時，會有點麻煩，好比若是想實現微信快捷登陸或者獲取微信用戶受權時，當微信用戶受權成功後，回跳回來時，微信返回的code參數會插入到#符號前面，這樣的話就爲了獲取這個code，就須要一系列的另外操做了。

　　路由模式還有另一種模式就是history模式，這種模式是沒有#符號的，符合咱們日常的使用習慣。這種模式充分利用 history.pushState API 來完成 URL 跳轉而無須從新加載頁面。

export default new Router({ //mode: 'hash', //默認hash模式，hash模式有#；另外還有一種history模式，沒有#符號
    mode: 'history', //history模式，沒有#符號
 routes })

　　不過這種模式要玩好，還須要後臺配置支持。由於咱們的應用是個單頁客戶端應用，若是後臺沒有正確的配置，當用戶在瀏覽器直接訪問 http://oursite.com/user/id 就會返回 404，這就很差看了。

　　因此呢，你要在服務端增長一個覆蓋全部狀況的候選資源：若是 URL 匹配不到任何靜態資源，則應該返回同一個 index.html 頁面，這個頁面就是你 app 依賴的頁面。

三、路由導航守衛。「導航」表示路由正在發生改變，vue-router提供的導航守衛主要用來經過跳轉或取消的方式守衛導航，從而達到控制導航走向。有多種機會植入路由導航過程當中：全局的，單個路由獨享的，或者組件級的。

3.1 全局前置守衛： router.beforeEach

import router from './router.js' Vue.config.productionTip = false

//全局守衛 //beforeEach， 全局前置守衛，當一個導航觸發時，全局前置守衛按照建立順序調用。
router.beforeEach((to, from, next)=>{ console.log("....beforeEach....") //數據校驗時
  // if (to.fullPath === '/home'){
  // next('/login')
  // }

  if (to.path != '/login'){ next(); } else { setTimeout(()=>{ next(); }, 1000) } console.log(to) console.log(from) console.log(next); })

當一個導航觸發時，全局前置守衛按照建立順序調用。守衛是異步解析執行，此時導航所在全部守衛resolve完以前一直處於等待中。

每一個守衛方法接收三個參數：

to: Route: 即將要進入的目標路由對象。
from: Route: 當前導航正要離開的路由
next: Function: 必定要調用該方法來 resolve 這個鉤子。執行效果依賴 next 方法的調用參數。
- next(): 進行管道中的下一個鉤子。若是所有鉤子執行完了，則導航的狀態就是 confirmed (確認的)。
- next(false): 中斷當前的導航。若是瀏覽器的 URL 改變了 (多是用戶手動或者瀏覽器後退按鈕)，那麼 URL 地址會重置到 from 路由對應的地址。
- next('/') 或者 next({ path: '/' }): 跳轉到一個不一樣的地址。當前的導航被中斷，而後進行一個新的導航。你能夠向 next 傳遞任意位置對象，且容許設置諸如 replace: true、name: 'home' 之類的選項以及任何用在 router-link 的 to prop 或 router.push 中的選項。
- next(error): (2.4.0+) 若是傳入 next 的參數是一個 Error 實例，則導航會被終止且該錯誤會被傳遞給 router.onError() 註冊過的回調。

確保要調用 next 方法，不然鉤子就不會被 resolved。

3.2 全局解析守衛： router.beforeResolve ，這和 router.beforeEach 相似，區別是在導航被確認以前，同時在全部組件內守衛和異步路由組件被解析以後，解析守衛就被調用

3.3 全局後置鉤子： router.afterEach ，然而和守衛不一樣的是，這些鉤子不會接受 next 函數也不會改變導航自己：

router.afterEach((to, from)=>{ console.log("....afterEach....") console.log(to) console.log(from) })

3.4 路由獨享守衛： beforeEnter ，參數和全局前置守衛同樣，執行順序在全局前置守衛以後，在全局解析守衛以前。router.js中部分測試代碼：

 { //動態路徑參數，以冒號開頭，若是有多個參數則繼續日後面追加
        path: '/pageA/:id/:name', name: 'pageA', component: PageA, //路由獨享的守衛
        beforeEnter: (to, from, next) => { console.log(".....路由獨享的守衛...beforeEnter...") console.log(to) console.log(from) console.log(next) next(); } },

3.5 組件內路由守衛。進入組件時、組件路徑參數變化時，離開組件時分別監聽。

<script> export default { name: 'pageA', //組件內的守衛
 beforeRouteEnter (to, from, next) { // 在渲染該組件的對應路由被 confirm 前調用
            // 不！能！獲取組件實例 `this`
            // 由於當守衛執行前，組件實例還沒被建立
            console.log('...組件內守衛beforeRouteEnter...') console.log(to) console.log(from) next(); }, beforeRouteUpdate (to, from, next) { // 在當前路由改變，可是該組件被複用時調用
            // 舉例來講，對於一個帶有動態參數的路徑 /foo/:id，在 /foo/1 和 /foo/2 之間跳轉的時候，
            // 因爲會渲染一樣的 Foo 組件，所以組件實例會被複用。而這個鉤子就會在這個狀況下被調用。
            // 能夠訪問組件實例 `this`
            console.log('...組件內守衛beforeRouteUpdate2222...') console.log(to) console.log(from) next(); }, beforeRouteLeave (to, from, next) { // 導航離開該組件的對應路由時調用
            // 能夠訪問組件實例 `this`
            console.log('...組件內守衛beforeRouteLeave3333...') console.log(to) console.log(from) next(); } } </script>

注意： beforeRouteEnter 守衛衛不能訪問 this，由於守衛在導航確認前被調用,所以即將登場的新組件還沒被建立。不過，你能夠經過傳一個回調給 next來訪問組件實例。在導航被確認的時候執行回調，而且把組件實例做爲回調方法的參數。

beforeRouteEnter (to, from, next) { next(vm => { // 經過 `vm` 訪問組件實例
 }) }

beforeRouteEnter 是支持給next 傳遞迴調的惟一守衛。對於 beforeRouteUpdate 和 beforeRouteLeave 來講，this已經可用了，因此不支持傳遞迴調，由於沒有必要了。

beforeRouteLeave 這個離開守衛一般用來禁止用戶在還未保存修改前忽然離開。該導航能夠經過 next(false) 來取消。

beforeRouteLeave (to, from , next) { const answer = window.confirm('Do you really want to leave? you have unsaved changes!') if (answer) { next() } else { next(false) } }

完整的導航解析流程

導航被觸發。
在失活的組件裏調用離開守衛。
調用全局的 beforeEach 守衛。
在重用的組件裏調用 beforeRouteUpdate 守衛 (2.2+)。
在路由配置裏調用 beforeEnter 。
解析異步路由組件。
在被激活的組件裏調用 beforeRouteEnter 。
調用全局的 beforeResolve 守衛 (2.5+)。
導航被確認。
調用全局的 afterEach 鉤子。
觸發 DOM 更新。
用建立好的實例調用 beforeRouteEnter 守衛中傳給 next 的回調函數。

----------------------- 導航守衛調用步驟記錄 ---------------

一、beforeEach  //全局守衛
二、beforeEnter  //路由獨享守衛
三、beforeRouteEnter  //組件內守衛
四、beforeResolve   //全局解析守衛
五、afterEach        //全局後置鉤子
六、beforeRouteLeave  //離開頁面的時候調用，組件內獨享（不離開頁面不調用）
 若是是路由複用（路由不變，路徑參數變化），調用步驟爲： 一、beforeEach  //全局守衛
二、beforeRouteUpdate //組件內守衛
三、beforeResolve   //全局解析守衛
四、afterEach        //全局後置鉤子
五、beforeRouteLeave  //離開頁面的時候調用，組件內獨享（不離開頁面不調用）