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

前言

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

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 css

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

安裝

1.咱們將會使用webpack去爲咱們的模塊打包,預處理,熱加載。若是你對webpack不熟悉,它就是能夠幫助咱們把多個js文件打包爲1個入口文件,而且能夠達到按需加載。這就意味着,咱們不用擔憂因爲使用太多的組件,致使了過多的HTTP請求,這是很是有益於產品體驗的。但咱們並不僅是爲了這個而使用webpack,咱們須要用webpack去編譯.vue文件,若是沒有使用一個loader去轉換咱們.vue文件裏的style、js和html,那麼瀏覽器就沒法識別。vue

2.模塊熱加載是webpack的一個很是碉堡的特性,將會爲咱們的單頁應用帶來極大的便利。
一般來講,當咱們修改了代碼刷新頁面,那應用裏的全部狀態就都沒有了。這對於開發一個單頁應用來講是很是痛苦的,由於須要從新在跑一遍流程。若是有模塊熱加載,當你修改了代碼,你的代碼會直接修改,頁面並不會刷新,因此狀態也會被保留。java

3.Vue也爲咱們提供了CSS預處理,因此咱們能夠選擇在.vue文件裏寫LESS或者SASS去代替原生CSS。node

4.咱們過去一般須要使用npm下載一堆的依賴,可是如今咱們能夠選擇Vue-cli。這是一個vue生態系統中一個偉大創舉。這意味着咱們不須要手動構建咱們的項目,而它就能夠很快地爲咱們生成。webpack

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

npm i -g vue-cli github

而後建立一個webpack項目而且下載依賴web

vue init webpack vue-tutorial

cd vue-tutorial

npm i

接着使用 npm run dev 在熱加載中運行咱們的應用

這一行命令表明着它會去找到package.jsonscripts對象,執行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.vuemain.jsmain.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不一樣的地方

1、vue-router路由的參數由對象統一變爲了數組要注意。還有則是實例化vue的el參數已經不能設置htmlbody了,由於在vue2中是會替換咱們指定的標籤

2、咱們必須在實例化vue的時候指定渲染什麼組件,之前咱們是經過路由來指定如router.start(App, '#app'),而在vue2中則不須要了

能夠發現咱們在main.js裏使用了兩個組件App.vueHome.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

相關文章
相關標籤/搜索