在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的初學者一個參考與瞭解吧!有哪裡不明白的或不對的,留言下,我們們可以一起討論、共同學習!