【騰訊Bugly乾貨分享】基於 Webpack & Vue & Vue-Router 的 SPA 初體驗

最近這幾年的前端圈子，由於戲臺一般精彩紛呈，從 MVC 到 MVVM，你剛唱罷我登場。 backbone，angularjs 已成昨日黃花，reactjs 如日中天，同時另一更輕量的 vue 發展勢頭更猛，尤其是即將 release 的2.0版本，號稱兼具了 angularjs 和 reactjs ... ...

本文來自於騰訊bugly開發者社區，非經作者同意，請勿轉載，原文地址：http://dev.qq.com/topic/57d13a57132ff21c38110186

導語

最近這幾年的前端圈子，由於戲臺一般精彩紛呈，從 MVC 到 MVVM，你剛唱罷我登場。 backbone，angularjs 已成昨日黃花，reactjs 如日中天，同時另一更輕量的 vue 發展勢頭更猛，尤其是即將 release 的2.0版本，號稱兼具了 angularjs 和 reactjs 的兩者優點。不過現在的官方版本還是1.0 ，下麵就是基於1.0版本的初體驗。

1. 為什麼要 SPA？

SPA： 就是俗稱的單頁應用（Single Page Web Application）。

在移動端，特別是 hybrid 方式的H5應用中，性能問題一直是痛點。使用 SPA，沒有頁面切換，就沒有白屏阻塞，可以大大提高 H5 的性能，達到接近原生的流暢體驗。

2. 為什麼選擇 vue？

在選擇 vue 之前，使用 reactjs 也做過一個小 Demo，雖然兩者都是面向組件的開發思路，但是 reactjs 的全家桶方式，實在太過強勢，而自己定義的 JSX 規範，揉和在 JS 的組件框架里，導致如果後期發生頁面改版工作，工作量將會巨大。

vue 相對來說，就輕量的多，他的view層，還是原來的 dom 結構，除了一些自定義的 vue 指令作為自定義標簽以外，只要學會寫組件就可以了，學習成本也比較低。

3. 環境配置

初始化工程，需要 node 環境使用 npm 安裝相應的依賴包。

先創建一個測試目錄，在裡面依次輸入以下命令。

 //初始化package.json
 npm init

 //安裝vue的依賴
 npm install vue --save
 npm install vue-router --save

 //安裝webpack的開發依賴
 npm install webpack --save-dev

 //安裝babel的ES6 Loader 的開發依賴
 npm install babel --save-dev
 npm install babel-core --save-dev
 npm install babel-loader --save-dev
 npm install babel-preset-es2015 --save-dev

 //安裝html loacer 的開發依賴
 npm install html-loader --save-dev

4. 目錄結構

src 為開發目錄，其中 components 為組件子目錄，templates 為模板子目錄。

dist 為構建出的文件目錄。

index.html 為入口文件。

package.json 為項目描述文件，是剛纔 npm init 所建立。

webpack.config.js 是 webpack 的構建配置文件

5. Webpack 配置

下麵是 webpack 的配置文件，如何使用 webpack，請移步 webpack 的官網。

 var webpack= require("webpack");

 module.exports={
     entry:{
         bundle:[ "./src/app.js"]
     },
     output:{
         path:__dirname,
         publicPath:"/",
         filename:"dist/[name].js"
     },
     module:{
         loaders:[
             {test: /\.html$/, loaders: ['html']},
             {test: /(\.js)$/, loader:["babel"] ,exclude:/node_modules/, 
              query:{
                      presets:["es2015"]
              }
             }
         ]
     },
     resolve:{
     },
     plugins:[
          /* 
          new webpack.optimize.UglifyJsPlugin({
             compress: {
                 warnings: false
             }
         })
                */
     ]
 }

6. 入口文件

index.html

 <!doctype html>
 <html lang="en">
 <head>
     <meta charset="UTF-8">
     <title>Vue Router Demo</title>
 </head>
 <body>
    <div id="app">
       <router-view></router-view>
     </div>
     <script src="dist/bundle.js"></script>
 </body>
 </html>

其中 id 為 app 的 div 是頁面容器，其中的 router-view 會由 vue-router 去渲染組件，講結果掛載到這個 div 上。

app.js

 var Vue = require('vue');
 var VueRouter = require('vue-router');

 Vue.use(VueRouter);
 Vue.config.debug = true;
 Vue.config.delimiters = ['${', '}']; // 把預設的{{ }} 改成ES6的模板字元串 ${ }
 Vue.config.devtools = true;

 var App = Vue.extend({});
 var router = new VueRouter({});

 router.map(require('./routes'));
 router.start(App, '#app');
 router.go({"path":"/"});

這是 vue 路由的配置。其中由於習慣問題，我把 vue 預設的{{ }} 改成了的 ${ } ,總感覺這樣看模板，才順眼一些。

routes.js

 module.exports = {
   '/': {
     component: require('./components/index')
   },
    '/list': {
     component: require('./components/list')
   },
   '*': {
     component: require('./components/notFound')
   }
 }

7. 第一個組件

components/index.js

 module.exports = {
   template: require('../templates/index.html'),

   ready: function () {
   }
 };

templates/index.html

 <h1>Index</h1>
 <hr/>
 <p>Hello World Index!</p>

執行 webpack 構建命令

瀏覽器中訪問：

查看 bundle 源碼：

發現 template 模板文件，已經被 webpack 打成字元串了。這其中，其實是 webpack 的 html-loader 起的作用

8. 組件之間跳轉

修改剛纔的 index 組件，增加一個跳轉鏈接，不用 href 了，要用 vue 的指令 v-link。

 <h1>Index</h1>
 <hr/>
 <p>Hello World Index!</p>
 <p><a v-link="{path:'/list'}" >List Page</a></p>

添加 list 組件

components/list.js

 module.exports = {
   template: require('../templates/list.html'),

   data:function(){
       return {items:[{"id":1,"name":"hello11"},{"id":2,"name":"hello22"}]};
   },
   ready: function () {
   }
 };

templates/list.html

 <h1>List</h1>
 <hr/>

 <p>Hello List Page!</p>
 <ul>
     <li v-for="(index,item) in items">
          ${item.id} : ${item.name}
     </li>
 </ul>

v-for 也是 vue 的預設指令，是用來迴圈數據列表的。

現在開始執行 webpack —watch 命令進行監聽，這樣就不用每次敲 webpack 命令了。只要開發者每次修改 js 點了保存，webpack 都會自動構建最新的 bundle 文件。

瀏覽器里試試看：

index 頁

點擊 List Page 跳轉到 list 頁

Bingo！單頁面兩個組件之間跳轉切換成功！

9. 組件生命周期

修改 componets/list.js

 module.exports = {
   template: require('../templates/list.html'),

   data:function(){
       return {items:[{"id":1,"name":"hello11"},{"id":2,"name":"hello22"}]};
   },

   //在實例開始初始化時同步調用。此時數據觀測、事件和 watcher 都尚未初始化
   init:function(){
       console.log("init..");
   },

   //在實例創建之後同步調用。此時實例已經結束解析選項，這意味著已建立：數據綁定，計算屬性，方法，watcher/事件回調。但是還沒有開始 DOM 編譯，$el 還不存在。
   created:function(){
       console.log("created..");
   },

   //在編譯開始前調用。
   beforeCompile:function(){
        console.log("beforeCompile..");
   },

   //在編譯結束後調用。此時所有的指令已生效，因而數據的變化將觸發 DOM 更新。但是不擔保 $el 已插入文檔。
   compiled:function(){
        console.log("compiled..");
   },

    //在編譯結束和 $el 第一次插入文檔之後調用，如在第一次 attached 鉤子之後調用。註意必須是由 Vue 插入（如 vm.$appendTo() 等方法或指令更新）才觸發 ready 鉤子。
   ready: function () {
     console.log("ready..");

   },

   //在 vm.$el 插入 DOM 時調用。必須是由指令或實例方法（如 $appendTo()）插入，直接操作 vm.$el 不會 觸發這個鉤子。
   attached:function(){
        console.log("attached..");
   },

   //在 vm.$el 從 DOM 中刪除時調用。必須是由指令或實例方法刪除，直接操作 vm.$el 不會 觸發這個鉤子。
   detached:function(){
        console.log("detached..");
   },

   //在開始銷毀實例時調用。此時實例仍然有功能。
   beforeDestroy:function(){
        console.log("beforeDestroy..");
   },

   //在實例被銷毀之後調用。此時所有的綁定和實例的指令已經解綁，所有的子實例也已經被銷毀。如果有離開過渡，destroyed 鉤子在過渡完成之後調用。
   destroyed:function(){
        console.log("destroyed..");
   }

 };

在瀏覽器里執行了看看：

首次進入 List 頁面的執行順序如下：

此時點一下瀏覽器的後退，List Component 會被銷毀，執行順序如下：

這是官方的生命周期的圖：

10. 父組件與子組件

在很多情況下，組件是有父子關係的，比如 list 列表組件有個子組件 item

components/item.js

 module.exports = {
   template: require('../templates/item.html'),

   props:["id","name"],

   ready: function () {

   }
 };

templates/item.html

 <p>我是subitem： ${id} - ${name}</p>

修改 list 組件，添加 item 的引用

components/list.js

 //引用item組件
 import item from "./item";

 module.exports = {
   template: require('../templates/list.html'),

   data:function(){
       return {items:[{"id":1,"name":"hello11"},{"id":2,"name":"hello22"}]};
   },

  //定義item組件為子組件
   components:{
      "item":item
   },

   ready: function () {
   }

 };

templates/list.html

 <h1>List</h1>
 <hr/>
 <p>Hello List Page!</p>
 <ul>
     <li v-for="(index,item) in items">
         <!--使用item子組件，同時把id,name使用props傳值給item子組件-->
         <item v-bind:id="item.id" v-bind:name="item.name"></item>
     </li>
 </ul>

瀏覽器里試試看：

子組件成功被調用了

11. 組件跳轉傳參

組件之間的跳轉傳參，也是一種非常常見的情況。下麵為列表頁，增加跳轉到詳情頁的跳轉，並傳參 id 給詳情頁

修改路由 routes.js

 module.exports = {

   '/': {
     component: require('./components/index')
   },
    '/list': {
     component: require('./components/list')
   },

   //增加詳情頁的跳轉路由，併在路徑上加上id傳參，具名為name：show
    '/show/:id': {
       name:"show",
       component: require('./components/show')
     },
   '*': {
     component: require('./components/notFound')
   }
 }

添加組件 show

components/show.js

 module.exports = {
   template: require('../templates/show.html'),

   data:function(){
       return {};
   },

   created:function(){
        //獲取params的參數ID
        var id=this.$route.params.id;

        //根據獲取的參數ID，返回不同的data對象（真實業務中，這裡應該是Ajax獲取數據）
        if (id==1){
             this.$data={"id":id,"name":"hello111","age":24};
        }else{
         this.$data={"id":id,"name":"hello222","age":28};
        }
   },

   ready: function () {
       console.log(this.$data);
   }

 };

templates/show.html

 <h1>Show</h1>
 <hr/>

 <p>Hello show page!</p>

 <p>id:${id}</p>
 <p>name:${name}</p>
 <p>age:${age}</p>

修改 templates/item.html

 <p>我是subitem： <a v-link="{name:'show',params: { 'id': id } }"> ${id} : ${name}</a> </p>

這裡 name:’show’ 表示具名路由路徑，params 就是傳參。

繼續瀏覽器里點到詳情頁試試：

點擊“hello11”，跳轉到詳情頁：

傳參邏輯成功。

12. 嵌套路由

僅有路由跳轉是遠遠不夠的，很多情況下，我們還有同一個頁面上，多標簽頁的切換，在 vue 中，用嵌套路由，也可以非常方便的實現。

添加兩個小組件

components/tab1.js

 module.exports = {
   template: "<p>Tab1 content</p>"
 };

components/tab2.js

 module.exports = {
   template: "<p>Tab2 content</p>"
 };

修改 components/index.js 組件，掛載這兩個子組件

 import tab1 from "./tab1";
 import tab2 from "./tab2";

 module.exports = {
   template: require('../templates/index.html'),

   components:{
      "tab1":tab1,
      "tab2":tab2
   },

   ready: function () {

   }
 };

在路由裡加上子路由

 module.exports = {

   '/': {
     component: require('./components/index'),

     //子路由
     subRoutes:{
       "/tab1":{
           component:require('./components/tab1')
       },
       "/tab2":{
           component:require('./components/tab2')
       }
     }
   },

    '/list': {
     component: require('./components/list')
   },

    '/show/:id': {
       name:"show",
       component: require('./components/show')
     },

   '*': {
     component: require('./components/notFound')
   }

 }

好了，在瀏覽器里試一下：

初始狀態：

點了 tab1，tab2：

Tab 切換沒問題，可是，初始狀態顯示是空的，能不能預設顯示 Tab1 Content 呢？很簡單，調整下路由就可以了：

 module.exports = {

   '/': {
     component: require('./components/index'),

     //子路由
     subRoutes:{
      //預設顯示Tab1
       "/":{
           component:require('./components/tab1')
       },
       "/tab1":{
           component:require('./components/tab1')
       },
       "/tab2":{
           component:require('./components/tab2')
       }
     }
   }
 }

13. 業界 vue 使用案例

小米移動官網：http://m.mi.com/1/#/index

餓了嗎招聘：https://jobs-mobile.ele.me/#!/

更多精彩內容歡迎關註bugly的微信公眾賬號：

騰訊 Bugly是一款專為移動開發者打造的質量監控工具，幫助開發者快速，便捷的定位線上應用崩潰的情況以及解決方案。智能合併功能幫助開發同學把每天上報的數千條 Crash 根據根因合併分類，每日日報會列出影響用戶數最多的崩潰，精准定位功能幫助開發同學定位到出問題的代碼行，實時上報可以在發佈後快速的瞭解應用的質量情況，適配最新的 iOS, Android 官方操作系統，鵝廠的工程師都在使用，快來加入我們吧！