vuex最簡單、最詳細的入門文件
轉自:https://segmentfault.com/a/1190000009404727
如果你在使用 vue.js
, 那麼我想你可能會對 vue 元件之間的通訊感到崩潰 。
我在使用基於 vue.js 2.0 的UI框架 ElementUI
開發網站的時候 , 就遇到了這種問題 : 一個頁面有很多表單 , 我試圖將表單寫成一個單檔案元件 , 但是表單 ( 子元件 ) 裡的資料和頁面 ( 父元件 ) 按鈕互動的時候 , 它們之間的通訊很麻煩 :
<!--父元件中引入子元件-->
<template>
<div>
<a href="javascript:;" @click ="show = true">點選</a>
<t-dialog :show.sync="show"></t-dialog>
</div>
</template>
<script>
import dialog from './components/dialog.vue'
export default {
data(){
return {
show:false
}
},
components:{
"t-dialog":dialog
}
}
</script>
<!--子元件-->
<template>
<el-dialog :visible.sync="currentShow"></el-dialog>
</template>
<script>
export default {
props:['show'],
computed:{
currentShow:{
get(){
return this.show
},
set(val){
this .$emit("update:show",val)
}
}
}
}
</script>
之所以這麼麻煩 , 是因為父元件可以通過 props
給子元件傳遞引數 , 但子元件內卻不能直接修改父元件傳過來的引數。
這時候 , 使用 vuex
就可以比較方便的解決這種問題了 :
<!--父元件中引入子元件-->
<template>
<div>
<a href="javascript:;" @click="$store.state.show = true">點選</a>
<t-dialog></t-dialog>
</div>
</template>
<script>
import dialog from './components/dialog.vue'
export default {
components:{
"t-dialog":dialog
}
}
</script>
<!--子元件-->
<template>
<el-dialog :visible.sync="$store.state.show"></el-dialog>
</template>
<script>
export default {}</script>
是不是方便了許多 , 這就是 vuex 最簡單的應用 , 不要被網上其他教程嚇到 , vuex 原來可以這麼簡單 !
安裝、使用 vuex
首先我們在 vue.js 2.0 開發環境中安裝 vuex :
npm install vuex --save
然後 , 在 main.js
中加入 :
import vuex from 'vuex'
Vue.use(vuex);
var store = new vuex.Store({//store物件
state:{
show:false
}
})
再然後 , 在例項化 Vue物件時加入 store 物件 :
new Vue({
el: '#app',
router,
store,//使用store
template: '<App/>',
components: { App }
})
完成到這一步 , 上述例子中的 $store.state.show
就可以使用了。
modules
前面為了方便 , 我們把 store 物件寫在了 main.js 裡面 , 但實際上為了便於日後的維護 , 我們分開寫更好 , 我們在 src
目錄下 , 新建一個 store
資料夾 , 然後在裡面新建一個 index.js
:
import Vue from 'vue'
import vuex from 'vuex'
Vue.use(vuex);
export default new vuex.Store({
state:{
show:false
}
})
那麼相應的 , 在 main.js 裡的程式碼應該改成 :
//vuex
import store from './store'
new Vue({
el: '#app',
router,
store,//使用store
template: '<App/>',
components: { App }
})
這樣就把 store 分離出去了 , 那麼還有一個問題是 : 這裡 $store.state.show
無論哪個元件都可以使用 , 那元件多了之後 , 狀態也多了 , 這麼多狀態都堆在 store 資料夾下的 index.js
不好維護怎麼辦 ?
我們可以使用 vuex 的 modules
, 把 store 資料夾下的 index.js
改成 :
import Vue from 'vue'
import vuex from 'vuex'
Vue.use(vuex);
import dialog_store from '../components/dialog_store.js';//引入某個store物件
export default new vuex.Store({
modules: {
dialog: dialog_store
}
})
這裡我們引用了一個 dialog_store.js
, 在這個 js 檔案裡我們就可以單獨寫 dialog 元件的狀態了 :
export default {
state:{
show:false
}
}
做出這樣的修改之後 , 我們將之前我們使用的 $store.state.show
統統改為 $store.state.dialog.show
即可。
如果還有其他的元件需要使用 vuex , 就新建一個對應的狀態檔案 , 然後將他們加入 store 資料夾下的 index.js 檔案中的 modules
中。
modules: {
dialog: dialog_store,
other: other,//其他元件
}
mutations
前面我們提到的對話方塊例子 , 我們對vuex 的依賴僅僅只有一個 $store.state.dialog.show
一個狀態 , 但是如果我們要進行一個操作 , 需要依賴很多很多個狀態 , 那管理起來又麻煩了 !
mutations
登場 , 問題迎刃而解 :
export default {
state:{//state
show:false
},
mutations:{
switch_dialog(state){//這裡的state對應著上面這個state
state.show = state.show?false:true;
//你還可以在這裡執行其他的操作改變state
}
}
}
使用 mutations 後 , 原先我們的父元件可以改為 :
<template>
<div id="app">
<a href="javascript:;" @click="$store.commit('switch_dialog')">點選</a>
<t-dialog></t-dialog>
</div>
</template>
<script>
import dialog from './components/dialog.vue'
export default {
components:{
"t-dialog":dialog
}
}
</script>
使用 $store.commit('switch_dialog')
來觸發 mutations
中的 switch_dialog
方法。
這裡需要注意的是:
mutations
中的方法是不分元件的 , 假如你在 dialog_stroe.js 檔案中的定義了switch_dialog
方法 , 在其他檔案中的一個switch_dialog
方法 , 那麼$store.commit('switch_dialog')
會執行所有的switch_dialog
方法。mutations
裡的操作必須是同步的。
你一定好奇 , 如果在 mutations
裡執行非同步操作會發生什麼事情 , 實際上並不會發生什麼奇怪的事情 , 只是官方推薦 , 不要在 mutationss
裡執行非同步操作而已。
actions
多個 state
的操作 , 使用 mutations
會來觸發會比較好維護 , 那麼需要執行多個 mutations 就需要用 action
了:
export default {
state:{//state
show:false
},
mutations:{
switch_dialog(state){//這裡的state對應著上面這個state
state.show = state.show?false:true;
//你還可以在這裡執行其他的操作改變state
}
},
actions:{
switch_dialog(context){//這裡的context和我們使用的$store擁有相同的物件和方法
context.commit('switch_dialog');
//你還可以在這裡觸發其他的mutations方法
},
}
}
那麼 , 在之前的父元件中 , 我們需要做修改 , 來觸發 action 裡的 switch_dialog 方法:
<template>
<div id="app">
<a href="javascript:;" @click="$store.dispatch('switch_dialog')">點選</a>
<t-dialog></t-dialog>
</div>
</template>
<script>
import dialog from './components/dialog.vue'
export default {
components:{
"t-dialog":dialog
}
}
</script>
使用 $store.dispatch('switch_dialog')
來觸發 action
中的 switch_dialog
方法。
官方推薦 , 將非同步操作放在 action 中。
getters
getters
和 vue 中的 computed
類似 , 都是用來計算 state 然後生成新的資料 ( 狀態 ) 的。
還是前面的例子 , 假如我們需要一個與狀態 show
剛好相反的狀態 , 使用 vue 中的 computed
可以這樣算出來 :
computed(){
not_show(){
return !this.$store.state.dialog.show;
}
}
那麼 , 如果很多很多個元件中都需要用到這個與 show 剛好相反的狀態 , 那麼我們需要寫很多很多個 not_show
, 使用 getters
就可以解決這種問題 :
export default {
state:{//state
show:false
},
getters:{
not_show(state){//這裡的state對應著上面這個state
return !state.show;
}
},
mutations:{
switch_dialog(state){//這裡的state對應著上面這個state
state.show = state.show?false:true;
//你還可以在這裡執行其他的操作改變state
}
},
actions:{
switch_dialog(context){//這裡的context和我們使用的$store擁有相同的物件和方法
context.commit('switch_dialog');
//你還可以在這裡觸發其他的mutations方法
},
}
}
我們在元件中使用 $store.state.dialog.show
來獲得狀態 show
, 類似的 , 我們可以使用 $store.getters.not_show
來獲得狀態 not_show
。
注意 : $store.getters.not_show
的值是不能直接修改的 , 需要對應的 state 發生變化才能修改。
mapState、mapGetters、mapActions
很多時候 , $store.state.dialog.show
、$store.dispatch('switch_dialog')
這種寫法又長又臭 , 很不方便 , 我們沒使用 vuex 的時候 , 獲取一個狀態只需要 this.show
, 執行一個方法只需要 this.switch_dialog
就行了 , 使用 vuex 使寫法變複雜了 ?
使用 mapState、mapGetters、mapActions
就不會這麼複雜了。
以 mapState 為例 :
<template>
<el-dialog :visible.sync="show"></el-dialog>
</template>
<script>
import {mapState} from 'vuex';
export default {
computed:{
//這裡的三點叫做 : 擴充套件運算子
...mapState({
show:state=>state.dialog.show
}),
}
}
</script>
相當於 :
<template>
<el-dialog :visible.sync="show"></el-dialog>
</template>
<script>
import {mapState} from 'vuex';
export default {
computed:{
show(){
return this.$store.state.dialog.show;
}
}
}
</script>
mapGetters、mapActions 和 mapState 類似 , mapGetters
一般也寫在 computed
中 , mapActions
一般寫在 methods
中。
弄懂上面這些 , 你可以去看vuex文件了 , 應該能看懂了。