Vue 2.0 構建單頁應用最佳實戰

二哲發表於2016-11-29

前言

我們將會選擇使用一些vue周邊的庫vue-cli, vue-router,vue-resource,vuex

1.使用vue-cli建立專案
2.使用vue-router實現單頁路由
3.用vuex管理我們的資料流
4.使用vue-resource請求我們的node服務端
5.使用.vue檔案進行元件化的開發
PS：本文node v6.2.2 npm v3.9.5 vue v2.1.0 vue-router v2.0.3 vuex v2.0.0

最終我們將會構建出一個小demo，不廢話，直接上圖。

安裝

1.我們將會使用webpack去為我們的模組打包，預處理，熱載入。如果你對webpack不熟悉，它就是可以幫助我們把多個js檔案打包為1個入口檔案，並且可以達到按需載入。這就意味著，我們不用擔心由於使用太多的元件，導致了過多的HTTP請求，這是非常有益於產品體驗的。但我們並不只是為了這個而使用webpack，我們需要用webpack去編譯.vue檔案，如果沒有使用一個loader去轉換我們.vue檔案裡的style、js和html，那麼瀏覽器就無法識別。

2.模組熱載入是webpack的一個非常碉堡的特性，將會為我們的單頁應用帶來極大的便利。
通常來說，當我們修改了程式碼重新整理頁面，那應用裡的所有狀態就都沒有了。這對於開發一個單頁應用來說是非常痛苦的，因為需要重新在跑一遍流程。如果有模組熱載入，當你修改了程式碼，你的程式碼會直接修改，頁面並不會重新整理，所以狀態也會被保留。

3.Vue也為我們提供了CSS預處理，所以我們可以選擇在.vue檔案裡寫LESS或者SASS去代替原生CSS。

4.我們過去通常需要使用npm下載一堆的依賴，但是現在我們可以選擇Vue-cli。這是一個vue生態系統中一個偉大創舉。這意味著我們不需要手動構建我們的專案，而它就可以很快地為我們生成。

首先，安裝vue-cli。(確保你有node和npm)

npm i -g vue-cli

然後建立一個webpack專案並且下載依賴

vue init webpack vue-tutorial

cd vue-tutorial

npm i

接著使用 npm run dev 在熱載入中執行我們的應用

這一行命令代表著它會去找到package.json的scripts物件，執行node bulid/dev-server.js。在這檔案裡，配置了Webpack，會讓它去編譯專案檔案，並且執行伺服器，我們在localhost:8080即可檢視我們的應用。

這些都準備好後，我們需要為我們的路由、XHR請求、資料管理下載三個庫，我們可以從vue的官網中找到他們。另外我們使用bootstrap作為我的UI庫

npm i vue-resource vue-router vuex bootstrap --save

初始化（main.js）

檢視我們的應用檔案，我們可以在src目錄下找到App.vue和main.js。main.js將會作為我們應用的入口檔案而App.vue會作為我們應用的初始化元件。先讓我們來完善下main.js

// src/main.js
import Vue from 'vue'
import VueRouter from 'vue-router'
import VueResource from 'vue-resource'

import App from './App'
import Home from './components/Home'
import 'bootstrap/dist/css/bootstrap.css'

Vue.use(VueRouter)
Vue.use(VueResource)

const routes = [{
  path : '/',
  component : Home
},{
  path : '/home',
  component : Home
}];

const router = new VueRouter({
  routes
});

/* eslint-disable no-new */
// 例項化我們的Vue
var app = new Vue({
  el: '#app',
  router,
  ...App,
});複製程式碼

這有兩個與1.0不同的地方

一、vue-router路由的引數由物件統一變為了陣列要注意。還有則是例項化vue的el引數已經不能設定html和body了，因為在vue2中是會替換我們指定的標籤

二、我們必須在例項化vue的時候指定渲染什麼元件，以前我們是通過路由來指定如router.start(App, '#app')，而在vue2中則不需要了

可以發現我們在main.js裡使用了兩個元件App.vue和Home.vue，稍後讓我們具體實現它們的內容。

而我們的index.html只需要保留<div id="app"></div>即可，我們的Vue在例項化時設定了el : '#app' 所以會替換這標籤，為我們App元件的內容

//index.html
<div id="app"></div>複製程式碼

我們的初始化就到這結束了，接下來讓我們開始建立元件。

建立首頁元件

首先我們在App.vue裡為我們的應用寫個頂部導航。

// src/App.vue

<template>
  <div id="wrapper">
    <nav class="navbar navbar-default">
      <div class="container">
        <a class="navbar-brand" href="#">
          <i class="glyphicon glyphicon-time"></i>
          計劃板
        </a>
        <ul class="nav navbar-nav">
          <li><router-link to="/home">首頁</router-link></li>
          <li><router-link to="/time-entries">計劃列表</router-link></li>
        </ul>
      </div>
    </nav>
    <div class="container">
      <div class="col-sm-3">

      </div>
      <div class="col-sm-9">
        <router-view></router-view>
      </div>
    </div>
  </div>
</template>複製程式碼

除了我們的navbar以外，我們還需要一個.container去放我們其餘需要展示的資訊。
並且在這裡我們要放一個router-view標籤，vue-router的切換就是通過這個標籤開始顯現的。

在這有個與1.0不同的地方

以前我們可以直接通過寫a標籤然後寫v-link屬性進行路由跳轉，在vue2中改為了寫<router-link>標籤再寫對應屬性（to）進行跳轉

接著，我們需要建立一個Home.vue作為我們的首頁

// src/components/Home.vue

<template>
  <div class="jumbotron">
    <h1>任務追蹤</h1>
    <p>
      <strong>
        <router-link to="/time-entries">建立一個任務</router-link>
      </strong>
    </p>
  </div>
</template>複製程式碼

不出意外的話，你可以看見如下效果

建立側邊欄元件

目前我們首頁左側還有一塊空白，我們需要它放下一個側邊欄去統計所有計劃的總時間。

// src/App.vue

  //...

  <div class="container">
    <div class="col-sm-3">
      <sidebar></sidebar>
    </div>
    <div class="col-sm-9">
      <router-view></router-view>
    </div>
  </div>

  //...複製程式碼

<script>
  import Sidebar from './components/Sidebar.vue'

  export default {
    components: { 'sidebar': Sidebar },
  }
</script>複製程式碼

在Sidebar.vue我們需要通過store去獲取總時間，我們的總時間是共享的資料

// src/components/Sidebar.vue
<template>
  <div class="panel panel-default">
    <div class="panel-heading">
      <h1 class="text-center">已有時長</h1>
    </div>

    <div class="panel-body">
      <h1 class="text-center">{{ time }} 小時</h1>
    </div>

  </div>
</template>

<script>
  export default {
    computed: {
        time() {
          return this.$store.state.totalTime
        }
      }
  }
</script>複製程式碼

建立計劃列表元件

然後我們需要去建立我們的時間跟蹤列表。


// src/components/TimeEntries.vue

<template>
  <div>
    //`v-if`是vue的一個指令
    //`$route.path`是當前路由物件的路徑，會被解析為絕對路徑當
    //`$route.path !== '/time-entries/log-time'`為`true`是顯示，`false`，為不顯示。
    //to 路由跳轉地址
    <router-link
      v-if="$route.path !== '/time-entries/log-time'"
      to="/time-entries/log-time"
      class="btn btn-primary">
      建立
    </router-link>

    <div v-if="$route.path === '/time-entries/log-time'">
      <h3>建立</h3>
    </div>

    <hr>

    <router-view></router-view>

    <div class="time-entries">
      <p v-if="!plans.length"><strong>還沒有任何計劃</strong></p>

      <div class="list-group">
      <--
        v-for迴圈，注意引數順序為(item,index) in items
      -->
        <a class="list-group-item" v-for="(plan,index) in plans">
          <div class="row">
            <div class="col-sm-2 user-details">

            <--
            `:src`屬性，這個是vue的屬性繫結簡寫`v-bind`可以縮寫為`:`
             比如a標籤的`href`可以寫為`:href`
            並且在vue的指令裡就一定不要寫插值表示式了(`:src={{xx}}`)，vue自己會去解析
            -->

              <img :src="plan.avatar" class="avatar img-circle img-responsive" />
              <p class="text-center">
                <strong>
                  {{ plan.name }}
                </strong>
              </p>
            </div>

            <div class="col-sm-2 text-center time-block">
              <h3 class="list-group-item-text total-time">
                <i class="glyphicon glyphicon-time"></i>
                {{ plan.totalTime }}
              </h3>
              <p class="label label-primary text-center">
                <i class="glyphicon glyphicon-calendar"></i>
                {{ plan.date }}
              </p>
            </div>

            <div class="col-sm-7 comment-section">
              <p>{{ plan.comment }}</p>
            </div>

            <div class="col-sm-1">
              <button
                class="btn btn-xs btn-danger delete-button"
                @click="deletePlan(index)">
              X
              </button>
            </div>

          </div>
        </a>

      </div>
    </div>
  </div>
</template>複製程式碼

關於template的解釋，都寫在一起了，再看看我們的script

// src/components/TimeEntries.vue

<script>
    export default {
        name : 'TimeEntries',
        computed : {
          plans () {
            // 從store中取出資料
            return this.$store.state.list
          }
        },
        methods : {
          deletePlan(idx) {
            // 稍後再來說這裡的方法
            // 減去總時間
            this.$store.dispatch('decTotalTime',this.plans[idx].totalTime)
            // 刪除該計劃
            this.$store.dispatch('deletePlan',idx)
          }
        }
    }
</script>複製程式碼

別忘了為我們的元件寫上一些需要的樣式

// src/components/TimeEntries.vue

<style>
  .avatar {
    height: 75px;
    margin: 0 auto;
    margin-top: 10px;
    margin-bottom: 10px;
  }
  .user-details {
    background-color: #f5f5f5;
    border-right: 1px solid #ddd;
    margin: -10px 0;
  }
  .time-block {
    padding: 10px;
  }
  .comment-section {
    padding: 20px;
  }
</style>複製程式碼

既然我們的資料是共享的，所以我們需要把資料存在store裡

我們在src下建立個目錄為store

在store下分別建立4個js檔案actions.js,index.js,mutation-types.js,mutations.js

看名字也就知道這4個分別是做啥用的了，建議大家多閱讀閱讀vuex的文件，多姿勢多動手實踐，慢慢的也就能理解了。

// src/store/index.js
import Vue from 'vue'
import Vuex from 'vuex'

Vue.use(Vuex);

// 先寫個假資料
const state = {
  totalTime: 0,
  list: [{
    name : '二哲',
    avatar : 'https://sfault-avatar.b0.upaiyun.com/147/223/147223148-573297d0913c5_huge256',
    date : '2016-12-25',
    totalTime : '6',
    comment : '12月25日晚上，陪女朋友一起過聖誕節需要6個小時'
  }]
};

export default new Vuex.Store({
  state,
})複製程式碼

由於新增了頁面和store 在我們的入口js檔案裡配置下

// src/main.js
import store from './store'
import TimeEntries from './components/TimeEntries.vue'
//... 

const routes = [{
  path : '/',
  component : Home
},{
  path : '/home',
  component : Home
},{
  path : '/time-entries',
  component : TimeEntries,
}];

var app = new Vue({
  el: '#app',
  router,
  store,
  ...App,
});複製程式碼

不出意外的話，你可以在/time-entries 路由下看見這樣的頁面

通過vue-Devtools我們可以發現我們的store已經構造好了並且成功從store獲取了資料

建立任務元件

這個比較簡單我們直接給出程式碼

// src/components/LogTime.vue

<template>
  <div class="form-horizontal">
    <div class="form-group">
      <div class="col-sm-6">
        <label>日期</label>
        <input
          type="date"
          class="form-control"
          v-model="date"
          placeholder="Date"
        />
      </div>
      <div class="col-sm-6">
        <label>時間</label>
        <input
          type="number"
          class="form-control"
          v-model="totalTime"
          placeholder="Hours"
        />
      </div>
    </div>
    <div class="form-group">
      <div class="col-sm-12">
        <label>備註</label>
        <input
          type="text"
          class="form-control"
          v-model="comment"
          placeholder="Comment"
        />
      </div>
    </div>
    <button class="btn btn-primary" @click="save()">儲存</button>
    <router-link to="/time-entries" class="btn btn-danger">取消</router-link>
    <hr>
  </div>
</template>

<script>
  export default {
        name : 'LogTime',
        data() {
            return {
                date : '',
                totalTime : '',
                comment : ''
            }
        },
        methods:{
          save() {
            const plan = {
              name : '二哲',
              image : 'https://sfault-avatar.b0.upaiyun.com/888/223/888223038-5646dbc28d530_huge256',
              date : this.date,
              totalTime : this.totalTime,
              comment : this.comment
            };
            this.$store.dispatch('savePlan', plan)
            this.$store.dispatch('addTotalTime', this.totalTime)
            this.$router.go(-1)
          }
        }
    }
</script>複製程式碼

這個元件很簡單就3個input輸入而已，然後就兩個按鈕，儲存我們就把資料push進我們store的列表裡

LogTime屬於我們TimeEntries元件的一個子路由，所以我們依舊需要配置下我們的路由，並且利用webpack讓它懶載入，減少我們首屏載入的流量

// src/main.js
//...
const routes = [{
  path : '/',
  component : Home
},{
  path : '/home',
  component : Home
},{
  path : '/time-entries',
  component : TimeEntries,
  children : [{
    path : 'log-time',
    // 懶載入
    component : resolve => require(['./components/LogTime.vue'],resolve),
  }]
}];

//...複製程式碼

vuex部分

在vue2.0中廢除了使用事件的方式進行通訊，所以在小專案中我們可以使用Event Bus，其餘最好都使用vuex，本文我們使用Vuex來實現資料通訊

相信你剛剛已經看見了我寫了很多this.$store.dispatch('savePlan', plan) 類似這樣的程式碼，我們再次統一說明。

仔細思考一下，我們需要兩個全域性資料，一個為所有計劃的總時間，一個是計劃列表的陣列。

src/store/index.js 沒啥太多可介紹的，其實就是傳入我們的state,mutations,actions來初始化我們的Store。如果有需要的話我們還可能需要建立我們的getter在本例中就不用了。

接著我們看mutation-types.js，既然想很明確瞭解資料，那就應該有什麼樣的操作看起，當然這也看個人口味哈

// src/store/mutation-types.js

// 增加總時間或者減少總時間
export const ADD_TOTAL_TIME = 'ADD_TOTAL_TIME';
export const DEC_TOTAL_TIME = 'DEC_TOTAL_TIME';

// 新增和刪除一條計劃
export const SAVE_PLAN = 'SAVE_PLAN';
export const DELETE_PLAN = 'DELETE_PLAN';複製程式碼

// src/store/mutations.js
import * as types from './mutation-types'

export default {
    // 增加總時間
  [types.ADD_TOTAL_TIME] (state, time) {
    state.totalTime = state.totalTime + time
  },
  // 減少總時間
  [types.DEC_TOTAL_TIME] (state, time) {
    state.totalTime = state.totalTime - time
  },
  // 新增計劃
  [types.SAVE_PLAN] (state, plan) {
    // 設定預設值，未來我們可以做登入直接讀取暱稱和頭像
    const avatar = 'https://sfault-avatar.b0.upaiyun.com/147/223/147223148-573297d0913c5_huge256';

    state.list.push(
      Object.assign({ name: '二哲', avatar: avatar }, plan)
    )
  },
  // 刪除某計劃
  [types.DELETE_PLAN] (state, idx) {
    state.list.splice(idx, 1);
  }
};複製程式碼

最後對應看我們的actions就很明白了

// src/store/actions.js

import * as types from './mutation-types'

export default {
  addTotalTime({ commit }, time) {
    commit(types.ADD_TOTAL_TIME, time)
  },
  decTotalTime({ commit }, time) {
    commit(types.DEC_TOTAL_TIME, time)
  },
  savePlan({ commit }, plan) {
    commit(types.SAVE_PLAN, plan);
  },
  deletePlan({ commit }, plan) {
    commit(types.DELETE_PLAN, plan)
  }
};複製程式碼

我們的actions其實就是去觸發事件和傳入引數啦

加了這三個檔案後我們的store終於完整了，更新下我們的程式碼

// src/store/index.js 完整程式碼

import Vue from 'vue'
import Vuex from 'vuex'
import mutations from './mutations'
import actions from './actions'

Vue.use(Vuex);

const state = {
  totalTime: 0,
  list: []
};

export default new Vuex.Store({
  state,
  mutations,
  actions
})複製程式碼

this.$store.dispatch('savePlan', plan)當執行了這樣的方法就會呼叫actions.js裡的savePlan方法，而savePlan又會觸發 mutations裡的 types.SAVE_PLAN 最後修改資料檢視更新

PS：在這有個技巧就是，在mutations裡都是用大寫下劃線連線，而我們的actions裡都用小寫駝峰對應。

個人理解這其實就是一個釋出訂閱的模式

mutation-types 記錄我們所有的事件名

mutations 註冊我們各種資料變化的方法

actions 則可以編寫非同步的邏輯或者是一些邏輯，再去commit
我們的事件

如果有getter 我們可以把一些需要處理返回的資料放在這即可，不進行業務操作

最後別忘了在我們的main.js裡使用我們的store

// src/store/main.js

import store from './store'
// ...

var app = new Vue({
  el: '#app',
  router,
  store,
  ...App,
});複製程式碼

開始體驗下你自己的任務計劃板吧！

最後

通過本文，我們可以學習到許多關於vue的特性。

1.瞭解了vue-cli腳手架

2.初步對webpack有了一些瞭解和認識

3.如何用.vue愉快的開發

4.使用vuex進行元件通訊

5.路由（子路由）的應用

6.使用 vue-devtools 觀察我們的資料

個人網站：www.meckodo.com

github地址：github.com/MeCKodo/vue…

Have a nice day

構建單頁Web應用
2015-12-27
Web
Webpack實戰-構建同構應用
2017-12-19
Web
Webpack實戰-構建 Electron 應用
2017-12-24
Web
用Web Components構建單頁面應用
2015-01-19
Web
基於七牛SDK構建的Vue單頁圖片管理應用
2019-02-22
Vue
基於Vue 2.0高仿今日頭條單頁應用——vue-toutiao
2017-04-25
Vue
Webpack實戰-構建離線應用
2017-12-23
Web
實戰Parcel構建一個基於Vue.js的相簿應用
2018-05-09
Vue.js
Webpack實戰-為單頁應用生成HTML
2019-02-27
WebHTML
Webpack實戰-管理多個單頁應用
2017-12-22
Web
webpack 多頁應用架構系列實戰
2017-07-16
Web應用架構
使用React構建大型應用的最佳實踐
2016-05-30
React
應用於 Hybrid App 的 Vue 多頁面構建
2019-03-04
APPVue
如何構建Vue大型應用
2019-04-14
Vue
vue 單頁應用（spa）前端路由實現原理
2018-03-31
Vue前端路由
vue專案構建與實戰
2017-06-27
Vue
採用 vue+webpack 構建的單頁應用——私人部落格 MintloG 誕生記
2018-12-06
VueWeb
VUE 單頁面應用修改頁面title
2018-10-22
Vue
快速構建H5單頁面切換應用
2024-04-19
H5
使用 Vue + Flask 搭建單頁應用
2019-05-13
VueFlask
VUE單頁應用骨架屏方案
2019-01-16
Vue
webpack 搭建vue多單頁應用
2018-03-18
WebVue
Vue單頁及多頁應用全域性配置404頁面實踐
2018-05-20
Vue
Vue SPA(單頁應用)首屏優化實踐
2017-05-09
Vue優化
使用webpack構建多頁應用
2019-04-09
Web
[譯]用AngularJS構建大型ASP.NET單頁應用（二）
2014-12-03
AngularJSASP.NET
[譯]用AngularJS構建大型ASP.NET單頁應用（三）
2014-12-09
AngularJSASP.NET
Aggregated APIServer 構建雲原生應用最佳實踐
2021-11-23
APIServer
巧用設計模式構建可配置Vue前端應用-活動頁生成系統實踐
2018-12-04
設計模式Vue前端
【Spring實戰】構建Spring Web應用程式
2017-11-07
SpringWeb
webpack 構建多頁面應用——初探
2018-12-19
Web
WEBPACK + JSP 構建多頁應用
2018-01-22
WebJS
基於vue2 + vue-router + vuex 構建的一個音樂類單頁面應用 —— echo回聲
2017-11-23
Vue
圍繞Vue 3 Composition API構建一個應用程式，包含一些最佳實踐！
2022-07-18
VueAPI
使用vue-cli3構建的vue單頁面專案seo
2019-01-09
Vue
Vue-rap 構建基於 Vue 的流應用
2019-03-02
Vue
Vue2.0構建——踩過的坑
2017-11-23
Vue
Vue2.0構建——基礎總結
2017-11-23
Vue