Vuex入门实例教程

Vuex

Vuex入门

Vuex概述

Vuex是实现组件全局状态（数据）管理的一种机制，可以方便的实现组件之间数据的共享

使用Vuex统一管理状态的好处

• 能够在vuex中集中管理共享的数据，易于开发和后期维护
• 能够高效地实现组件之间的数据共享，提高开发效率
• 存储在vuex中的数据都是响应式的，能够实时保持数据与页面的同步

什么样的数据适合存储在Vuex中

一般情况下，只有组件之间共享的数据，才有必要存储到vuex中；对于组件中的私有数据，依旧存储在组件自身的data中即可

Vuex的基本使用

一、安装vuex依赖包

npm install vuex --save

二、导入vuex包

import Vuex from 'vuex'
Vue.use(Vuex)

三、创建store对象

const store = new Vuex.Store({
    //state中存放的就是全局共享的数据
    state:{count:0}
})

四、将store对象挂载到vue实例中

new Vue({
    el:'#app',
    render:h => (app),
    router,
    //将创建的共享数据对象，挂载到vue实例中
    //所有的组件，就可以直接从store中获取全局的数据了
    store
})

Vuex测核心概念

vuex中的主要核心概念如下

• State
• Mutation
• Action
• Getter

State

State提供唯一的公共数据源，所有共享的数据都要统一放到Store的State中进行存储

//创建store数据源，提供唯一公共数据
const store = new Vuex.Store({
    state:{count:0}
})

组件中访问State中数据的第一种方式：

this.$store.state.全局数据名称

组件访问State中数据的第二种方式：

//1、从vuex中按需导入mapState函数
import { mapState } from 'vuex'

通过刚才导入的mapState函数，将当前组件需要的全局数据，映射为当前组件的computed计算属性

//2、将全局数据，映射为当前组件的计算属性
computed: {
    ...mapState(['count']) //展开运算符
}

注意：在vuex中，我们是不允许在组件中直接修改store中的数据的。如需修改，使用mutation

Mutation

Mutation用于变更Store中的数据

• 只能通过mutation变更Store数据，不可以直接操作Store中的数据
• 通过mutation这种方式虽然操作起来稍微麻烦一些，但是可以集中监控所有数据的变化

// 在Mutation中定义add函数
const store = new Vuex.Store({
    state:{
        count:0
    },
    //定义Mutation
    mutations:{
        add(state){
            //变更状态
            state.count++
        }
    }
})

//调用Mutation中的add函数
methods:{
    handler1(){
        //触发mutations的第一种方式,commit的作用就是调用某个mutation函数
        this.$store.commit('add')
    }
}

切记：只有mutation中的函数才有权利去修改state中的数据！！！

可以在触发mutation时传递参数

const store = new Vuex.Store({
    state:{
        count:0
    },
    //定义Mutation
    mutations:{
        //接受参数,第一个参数必须是state
        addN(state,step){
            state.count += step
        }
    }
})

//调用Mutation中的add函数
methods:{
    handler2(){
        this.$store.commit('addN',3)
    }
}

触发mutation的第二种方式

this.$store.commit( ) 是触发mutation的第一种方式

//1、从vuex中按需导入mapMutations函数
import { mapMutations } from 'vuex'

通过刚才导入的mapMutations函数，将需要的mutations函数，映射为当前组件的methods方法：

//2、将指定的mutations函数，映射为当前组件的methods函数
methods:{
    ...mapMutations(['sub']),
    //直接调用上面映射的方式咯
    btnHandler1(){
      this.sub()
    }
}

注意：不要在mutation中执行异步操作！！！

Action

Action用于处理异步任务

如果通过异步操作变更数据，必须通过Action，而不能使用Mutation。但是在Action中还是要通过触发Mutation的方式间接变更数据

//定义actions
const store = new Vuex.Store({
    state: {
    count:0
  },
mutations: {
    add(state){
      state.count++
    }
  },
actions: {
    //执行异步操作,在action中不能直接修改state中的数据，只有mutations中的函数才能修改state的数据
    addAsync(context){
      setTimeout(() => {
        context.commit('add')
      }, 1000);
    }
  }
})

//触发actions，调用dispatch()函数
methods:{
      handler(){
        this.$store.dispatch('addAsync')
      }
  }

触发actions异步任务时携带参数

const store = new Vuex.Store({
    state: {
    count:0
  },
mutations: {
    addN(state,step){
      state.count += step
    }
  },
actions: {
    //执行异步操作,在action中不能直接修改state中的数据，只有mutations中的函数才能修改state的数据
    addAsync(context,step){
      setTimeout(() => {
        context.commit('addN',step)
      }, 1000);
    }
  }
})

//触发actions，调用dispatch()函数
methods:{
      handler(){
        this.$store.dispatch('addAsync',5)
      }
  }

触发actions的第二种方式

this.$store.dispatch( ) 是触发action的第一种方式

//1、从vuex中按需导入mapActions函数
import { mapActions } from 'vuex'

通过刚才导入的mapActions函数，将需要的actions函数映射为当前组件的methods方法

methods:{
    ...mapActions(['addAsync','addNAsync'])
}

Getter

Getter用于对Store中的数据进行加工处理形成新的数据，不会修改Store中的原数据

• 类似Vue的计算属性
• Store中数据发生变化，Getter的数据也会跟着变化

//定义Getter
const store = new Vuex.Store({
    state:{
        count:0
    },
    getters:{
        showNum:state => {
            return '当前最新的数据是'+state.count
        }
    }
})

//第一种触发方式
this.$store.getters.名称

//第二种触发方式
import { mapGetters } from 'vuex'
computed:{
    ...mapGetters(['showNum'])
}

小案例

app.vue

<template>
  <div id="app">
    <a-input placeholder="请输入任务" class="my_ipt" :value="inputValue" @change="handleInputChange"/>
    <a-button type="primary" @click="addItemToList">添加事项</a-button>

    <a-list bordered :dataSource="list" class="dt_list">
      <a-list-item slot="renderItem" slot-scope="item">
        <!-- 复选框 -->
        <a-checkbox :checked="item.done" @change="(e) => {cbstatusChanged(e,item.id)}">{{item.info}}</a-checkbox>
        <!-- 删除链接 -->
        <a slot="actions" @click="removeItemById(item.id)">删除</a>
      </a-list-item>

      <!-- footer区域 -->
      <div slot="footer" class="footer">
        <!-- 未完成的任务个数 -->
        <span>{{unDoneLength}}条剩余</span>
        <!-- 操作按钮 -->
        <a-button-group>
          <a-button type="primary">全部</a-button>
          <a-button>未完成</a-button>
          <a-button>已完成</a-button>
        </a-button-group>
        <!-- 把已经完成的任务清空 -->
        <a>清除已完成</a>
      </div>
    </a-list>
  </div>
</template>

<script>
import { mapState,mapMutations,mapGetters } from 'vuex'

export default {
  name: 'app',
  data() {
    return {}
  },
  created(){
    this.$store.dispatch('getList')
  },
  computed:{
    ...mapState(['list','inputValue']),
    ...mapGetters(['unDoneLength'])
  },
  methods:{
    ...mapMutations(['setInputValue']),
    handleInputChange(e){
      console.log(e.target.value)
      this.setInputValue(e.target.value)
    },
    //向列表中新增
    addItemToList(){
      if(this.inputValue.trim().length <= 0){
        return this.$message.warning('文本框内容不能为空')
      }
      this.$store.commit('addItem')
    },
    //根据id删除
    removeItemById(id){
      console.log(id)
      this.$store.commit('removeItem',id)
    },
    //监听复选框选中状态变化的事件
    cbstatusChanged(e,id){
      //通过e.target.checked可以获取到最新的选中状态
      // console.log(e.target.checked)
      // console.log(id)

      const param = {
        id:id,
        status:e.target.checked
      }

      this.$store.commit('changeStatus',param)

    }
  }
}
</script>

<style scoped>
#app {
  padding: 10px;
}

.my_ipt {
  width: 500px;
  margin-right: 10px;
}

.dt_list {
  width: 500px;
  margin-top: 10px;
}

.footer {
  display: flex;
  justify-content: space-between;
  align-items: center;
}
</style>

store.js

import Vue from 'vue'
import Vuex from 'vuex'
import axios from 'axios'

Vue.use(Vuex)

export default new Vuex.Store({
  state: {
    //所有的任務列表
    list:[],
    //文本框的內容
    inputValue:'aaa',
    //下一个id
    nextId:5
  },
  mutations: {
    initList(state,list){
        state.list = list
    },
    //为store中inputValue赋值
    setInputValue(state,value){
      state.inputValue = value
    },
    addItem(state){
      const obj = {
        id:state.nextId,
        info:state.inputValue.trim(),
        done:false
      }
      console.log('obj------------------'+obj)
      state.list.push(obj)
      state.nextId++
      state.inputValue = ''
    },
    //根据id删除对应的数据
    removeItem(state,id){
      //根据id查找对应的索引
      const index = state.list.findIndex(x => x.id === id)
      //根据索引删除元素
      if(index !== -1){
        state.list.splice(index,1)
      }
    },
    //改变选中的状态
    changeStatus(state,param){
      const index = state.list.findIndex( x => x.id ===param.id);
      if(index !== -1){
        state.list[index].done = param.status
      }
    }
  },
  actions: {
    getList(context){
      axios.get('/list.json').then(({data}) => {
        console.log(data)
        context.commit('initList',data)
      })
    }
  },
  getters:{
    //统计未完成的任务的条数
    unDoneLength(state){
        return state.list.filter(x => x.done === false).length
    }
    //已完成的任务的条数
  },
  modules: {
  }
})

# list.json

[
    {
      "id": 0,
      "info": "Racing car sprays burning fuel into crowd.",
      "done": true
    },
    {
      "id": 1, 
      "info": "Japanese princess to wed commoner.", 
      "done": false
    },
    {
      "id": 2,
      "info": "Australian walks 100km after outback crash.",
      "done": true
    },
    { 
      "id": 3, 
      "info": "Man charged over missing wedding girl.", 
      "done": false
    },
    { 
      "id": 4, 
      "info": "Los Angeles battles huge wildfires.", 
      "done": false
    }
]