Vuex詳解

itwangchen發表於2019-03-22

在SPA單頁面元件的開發中 Vue的vuex和React的Redux 都統稱為同一狀態管理,個人的理解是全域性狀態管理更合適;簡單的理解就是你在state中定義了一個資料之後,你可以在所在專案中的任何一個元件裡進行獲取、進行修改,並且你的修改可以得到全域性的響應變更。下面我們們一步一步地剖析下vuex的使用:
首先要安裝、使用 vuex
首先在 vue 2.0+ 你的vue-cli專案中安裝 vuex :

npm install vuex --save複製程式碼

然後 在src檔案目錄下新建一個名為store的資料夾,為方便引入並在store資料夾裡新建一個index.js,裡面的內容如下:

 
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
const store = new Vuex.Store();
 
export default store;複製程式碼

接下來,在 main.js裡面引入store,然後再全域性注入一下,這樣一來就可以在任何一個元件裡面使用this.$store了:

import store from './store'//引入store
 
new Vue({
  el: '#app',
  router,
  store,//使用store
  template: '<App/>',
  components: { App }
})複製程式碼

說了上面的前奏之後,接下來就是納入正題了,就是開篇說的state的玩法。回到store檔案的index.js裡面,我們先宣告一個state變數,並賦值一個空物件給它,裡面隨便定義兩個初始屬性值;然後再在例項化的Vuex.Store裡面傳入一個空物件,並把剛宣告的變數state仍裡面:

 
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
 const state={//要設定的全域性訪問的state物件
     showFooter: true,
     changableNum:0
     //要設定的初始屬性值
   };
 const store = new Vuex.Store({
       state
    });
 
export default store;複製程式碼

實際上做完上面的三個步驟後,你已經可以用this.$store.state.showFooter或this.$store.state.changebleNum在任何一個元件裡面獲取showfooter和changebleNum定義的值了,但這不是理想的獲取方式;vuex官方API提供了一個getters,和vue計算屬性computed一樣,來實時監聽state值的變化(最新狀態),並把它也仍進Vuex.Store裡面,具體看下面程式碼:

 
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
 const state={   //要設定的全域性訪問的state物件
     showFooter: true,
     changableNum:0
     //要設定的初始屬性值
   };
const getters = {   //實時監聽state值的變化(最新狀態)
    isShow(state) {  //方法名隨意,主要是來承載變化的showFooter的值
       return state.showFooter
    },
    getChangedNum(){  //方法名隨意,主要是用來承載變化的changableNum的值
       return state.changebleNum
    }
};
const store = new Vuex.Store({
       state,
       getters
});
export default store;複製程式碼

光有定義的state的初始值,不改變它不是我們想要的需求,接下來要說的就是mutations了,mutattions也是一個物件,這個物件裡面可以放改變state的初始值的方法,具體的用法就是給裡面的方法傳入引數state或額外的引數,然後利用vue的雙向資料驅動進行值的改變,同樣的定義好之後也把這個mutations扔進Vuex.Store裡面,如下:

 
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
 const state={   //要設定的全域性訪問的state物件
     showFooter: true,
     changableNum:0
     //要設定的初始屬性值
   };
const getters = {   //實時監聽state值的變化(最新狀態)
    isShow(state) {  //承載變化的showFooter的值
       return state.showFooter
    },
    getChangedNum(){  //承載變化的changebleNum的值
       return state.changableNum
    }
};
const mutations = {
    show(state) {   //自定義改變state初始值的方法,這裡面的引數除了state之外還可以再傳額外的引數(變數或物件);
        state.showFooter = true;
    },
    hide(state) {  //同上
        state.showFooter = false;
    },
    newNum(state,sum){ //同上,這裡面的引數除了state之外還傳了需要增加的值sum
       state.changableNum+=sum;
    }
};
 const store = new Vuex.Store({
       state,
       getters,
       mutations
});
export default store;複製程式碼

這時候你完全可以用 this.$store.commit('show') 或 this.$store.commit('hide') 以及 this.$store.commit('newNum',6) 在別的元件裡面進行改變showfooter和changebleNum的值了,但這不是理想的改變值的方式;因為在 Vuex 中,mutations裡面的方法 都是同步事務,意思就是說:比如這裡的一個this.$store.commit('newNum',sum)方法,兩個元件裡用執行得到的值,每次都是一樣的,這樣肯定不是理想的需求

好在vuex官方API還提供了一個actions,這個actions也是個物件變數,最大的作用就是裡面的Action方法 可以包含任意非同步操作,這裡面的方法是用來非同步觸發mutations裡面的方法,actions裡面自定義的函式接收一個context引數和要變化的形參,context與store例項具有相同的方法和屬性,所以它可以執行context.commit(' '),然後也不要忘了把它也扔進Vuex.Store裡面:

 
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
 const state={   //要設定的全域性訪問的state物件
     showFooter: true,
     changableNum:0
     //要設定的初始屬性值
   };
const getters = {   //實時監聽state值的變化(最新狀態)
    isShow(state) {  //承載變化的showFooter的值
       return state.showFooter
    },
    getChangedNum(){  //承載變化的changebleNum的值
       return state.changableNum
    }
};
const mutations = {
    show(state) {   //自定義改變state初始值的方法,這裡面的引數除了state之外還可以再傳額外的引數(變數或物件);
        state.showFooter = true;
    },
    hide(state) {  //同上
        state.showFooter = false;
    },
    newNum(state,sum){ //同上,這裡面的引數除了state之外還傳了需要增加的值sum
       state.changableNum+=sum;
    }
};
 const actions = {
    hideFooter(context) {  //自定義觸發mutations裡函式的方法,context與store 例項具有相同方法和屬性
        context.commit('hide');
    },
    showFooter(context) {  //同上註釋
        context.commit('show');
    },
    getNewNum(context,num){   //同上註釋,num為要變化的形參
        context.commit('newNum',num)
     }
};
  const store = new Vuex.Store({
       state,
       getters,
       mutations,
       actions
});
export default store;複製程式碼

而在外部元件裡進行全域性執行actions裡面方法的時候,你只需要用執行

this.$store.dispatch('hideFooter')

或this.$store.dispatch('showFooter')

以及this.$store.dispatch('getNewNum',6) //6要變化的實參

這樣就可以全域性改變改變showfooter或changebleNum的值了,如下面的元件中,需求是跳轉元件頁面後,根據當前所在的路由頁面進行隱藏或顯示頁面底部的tabs選項卡

<template>
  <div id="app">
    <router-view/>
    <FooterBar v-if="isShow" />
  </div>
</template>

<script>
import FooterBar from '@/components/common/FooterBar'
import config from './config/index'
export default {
  name: 'App',
  components:{
    FooterBar:FooterBar
  },
  data(){
    return {
    }
  },
  computed:{
     isShow(){
       return this.$store.getters.isShow;
     }
  },
  watch:{
      $route(to,from){ //跳轉元件頁面後,監聽路由引數中對應的當前頁面以及上一個頁面
          console.log(to)
        if(to.name=='book'||to.name=='my'){ // to.name來獲取當前所顯示的頁面,從而控制該顯示或隱藏footerBar元件
           this.$store.dispatch('showFooter') // 利用派發全域性state.showFooter的值來控制        }else{
           this.$store.dispatch('hideFooter')
        }
      }
  }
}
</script>
        }else{
           this.$store.dispatch('hideFooter')
        }
      }
  }
}
</script>複製程式碼

至此就可以做到一呼百應的全域性響應狀態改變了!

modules 模組化 以及 元件中引入 mapGetters、mapActions 和 mapStates的使用

因為在大多數的專案中,我們對於全域性狀態的管理並不僅僅一種情況的需求,有時有多方面的需求,比如寫一個商城專案,你所用到的全域性state可能是關於購物車這一塊兒的也有可能是關於商品價格這一塊兒的;像這樣的情況我們就要考慮使用vuex中的 modules 模組化了,具體怎麼使用modules呢?我們們繼續一步一步的走:

首先,在store資料夾下面新建一個modules資料夾,然後在modules檔案裡面建立需要管理狀態的js檔案,既然要把不同部分的狀態分開管理,那就要把它們給分成獨立的狀態檔案了,如下圖:
圖片描述

而對應的store資料夾下面的index.js 裡面的內容就直接改寫成:

import Vue from 'vue';
import Vuex from 'vuex';
import footerStatus from './modules/footerStatus'
import collection from './modules/collection'
Vue.use(Vuex);

export default new Vuex.Store({
    modules:{
         footerStatus,
         collection
    }
});複製程式碼

相應的js,其中的 namespaced:true 表示當你需要在別的檔案裡面使用( mapGetters、mapActions 接下來會說 )時,裡面的方法需要註明來自哪一個模組的方法:

//collection.js

const state={
    collects:[],  //初始化一個colects陣列
};
const getters={
  renderCollects(state){ //承載變化的collects
    return state.collects;
  }
};
const mutations={
     pushCollects(state,items){ //如何變化collects,插入items
        state.collects.push(items)
     }
 };
const actions={
    invokePushItems(context,item){ //觸發mutations裡面的pushCollects ,傳入資料形參item 對應到items
        context.commit('pushCollects',item);
    }
};
export default {
     namespaced:true,//用於在全域性引用此檔案裡的方法時標識這一個的檔名
     state,
     getters,
     mutations,
     actions
}複製程式碼
 
//footerStatus.js
 
const state={   //要設定的全域性訪問的state物件
     showFooter: true,
     changableNum:0
     //要設定的初始屬性值
   };
const getters = {   //實時監聽state值的變化(最新狀態)
    isShow(state) {  //承載變化的showFooter的值
       return state.showFooter
    },
    getChangedNum(){  //承載變化的changebleNum的值
       return state.changableNum
    }
};
const mutations = {
    show(state) {   //自定義改變state初始值的方法,這裡面的引數除了state之外還可以再傳額外的引數(變數或物件);
        state.showFooter = true;
    },
    hide(state) {  //同上
        state.showFooter = false;
    },
    newNum(state,sum){ //同上,這裡面的引數除了state之外還傳了需要增加的值sum
       state.changableNum+=sum;
    }
};
 const actions = {
    hideFooter(context) {  //自定義觸發mutations裡函式的方法,context與store 例項具有相同方法和屬性
        context.commit('hide');
    },
    showFooter(context) {  //同上註釋
        context.commit('show');
    },
    getNewNum(context,num){   //同上註釋,num為要變化的形參
        context.commit('newNum',num)
     }
};
export default {
    namespaced: true, //用於在全域性引用此文裡的方法時標識這一個的檔名
    state,
    getters,
    mutations,
    actions
}複製程式碼

這樣一改就有了關於兩個模組的state管理檔案了 footerStatus.js和collection.js,現在你要執行當前的程式碼話,專案會報錯!因為我們把上面的程式碼模組化分開了,引用的地方還沒有改。接下來我們們一起來看看 mapState,mapGetters,mapActions的使用,首先 在需要用的 元件裡面先匯入 import {mapState,mapGetters,mapActions} from 'vuex';我們們先修正一下隱藏或顯示頁面底部的tabs選項卡(就是上面舉的臨時例子)的元件程式碼

 
<template>
  <div id="app">
    <router-view/>
    <FooterBar v-if="isShow" />
  </div>
</template>
 
<script>
import {mapState,mapGetters,mapActions} from 'vuex'; //先要引入
import FooterBar from '@/components/common/FooterBar'
import config from './config/index'
export default {
  name: 'App',
  components:{
    FooterBar:FooterBar
  },
  data(){
    return {
    }
  },
  computed:{
    ...mapState({  //這裡的...是超引用,ES6的語法,意思是state裡有多少屬性值我可以在這裡放多少屬性值
         isShow:state=>state.footerStatus.showFooter //注意這些與上面的區別就是state.footerStatus,
                                                      //裡面定義的showFooter是指footerStatus.js裡state的showFooter
      }),
     //你也可以用下面的mapGetters來獲取isShow的值,貌似下面的更簡潔
    /*...mapGetters('footerStatus',{ //footerStatus指的是modules資料夾下的footerStatus.js模組
         isShow:'isShow' //第一個isShow是我自定義的只要對應template裡v-if="isShow"就行,
                         //第二個isShow是對應的footerStatus.js裡的getters裡的isShow
      })*/
  },
  watch:{
      $route(to,from){
        if(to.name=='book'||to.name=='my'){
           this.$store.dispatch('footerStatus/showFooter') //這裡改為'footerStatus/showFooter',
                                                           //意思是指footerStatus.js裡actions裡的showFooter方法
        }else{
           this.$store.dispatch('footerStatus/hideFooter') //同上註釋
        }
      }
  }
}
</script>複製程式碼

現在專案程式碼應該就不會報錯了,好,最後我們們再來看一下mapActions的用法,實際上上面的this.$store.dispatch('footerStatus/showFooter')已經算是一種執行相應模組的action裡的方法了,但有時會牽扯的事件的觸發及傳值,那就會有下面的mapActions用法了,還記得上面的另一個模組collection.js嗎?來看一下里面的actions中的方法結構:

const state={
    collects:[],  //初始化一個colects陣列
};
const getters={
  renderCollects(state){ //承載變化的collects
    return state.collects;
  }
};
const mutations={
     pushCollects(state,items){ //如何變化collects,插入items
        state.collects.push(items)
     }
 };
const actions={
    invokePushItems(context,item){ //觸發mutations裡面的pushCollects ,傳入資料形參item 對應到items
        context.commit('pushCollects',item);
    }
};複製程式碼

需要傳值來實時變動state.collects裡的資料,那肯定要在執行它的地方進行傳值了,所以下面用到它的地方我們用了個@click來執行這個invokePushItems方法了,並且傳入相應的物件資料item,如下:

<template>
  <div >
      <section class="joinState">
           <div class="joinStateHead">
                <span class="h3">全國改性料通訊錄</span>
                <span class="joinStatus" @click="invokePushItems(item)">加入收藏列</span>
           </div>
      </section>
  </div>
</template>

<script>
import { mapActions } from 'vuex'
export default {
  components:{
     conditionFilter
  },
  name: 'bookDetail',
  data () {
    return {
      msg: '',
      item:{
         id:'01',
         productName: '蘋果',
         price:'1.6元/斤'
       }
    }
  },
  mounted() {
    this.$store.dispatch('footerStatus/hideFooter')
  },
  methods:{
      ...mapActions('collection',[ //collection是指modules資料夾下的collection.js
          'invokePushItems'  //collection.js檔案中的actions裡的方法,在上面的@click中執行並傳入實參
      ])
  }

}
</script>複製程式碼

這樣一來,在這個元件裡面操作的 collecttion.js 中的state的資料,在其他的任何的一個元件裡面都會得到相應的更新變化了,獲取狀態的頁面程式碼如下:

<template>
  </div>
    <div>
        <ul>
            <li v-for="(val,index) in arrList" :key="index">
                <h5>{{val.productName}}</h5>
                 <p>{{val.price}}</p>
            </li>
        </ul>
    </div>
</template>

<script>
import {mapState,mapGetters,mapActions} from 'vuex';
    export default {
        name: 'book',
        data() {
            return {
            }
        },
    computed:{
        // ...mapState({  //用mapState來獲取collection.js裡面的state的屬性值
        //    arrList:state=>state.collection.collects
        // }),
        ...mapGetters('collection',{ //用mapGetters來獲取collection.js裡面的getters
            arrList:'renderCollects'
        })

    }
    }
</script>複製程式碼

至此,vuex中的常用的一些知識點使用算是簡單的分享完了,當然了,相信這些只是一些皮毛!只能說是給予剛接觸vuex的初學者一個參考與瞭解吧!


相關文章