Vuex
大约 5 分钟
Vuex
1. Vuex 概述
1.1. 组件之间共享数据的方式
父向子传值：v-bind 属性绑定
子向父传值：v-on 事件绑定
兄弟组件之间共享数据： EventBus
$on 接收数据的那个组件
$emit 发送数据的那个组件
1.2. Vuex 是什么
Vuex 是实现组件全局状态（数据）管理的一种机制，可以方便的实现组件之间数据的共享。
1.3.Vuex 的好处
实现组件之间的数据共享、同时集中管理数据，方便开发和维护
① 能够在 vuex 中集中管理共享的数据，易于开发和后期维护
② 能够高效地实现组件之间的数据共享，提高开发效率
③ 存储在 vuex 中的数据都是响应式的，能够实时保持数据与页面的同步
1.4. 什么样的数据适合存储到 Vuex 中
一般情况下，只有组件之间共享的数据，才有必要存储到 vuex 中；对于组件中的私有数据，依旧存储在组件 自身的 data 中即可
2. Vuex 的基本使用
2.1 安装 vuex 依赖包
npm install vuex --save
2.2 导入 vuex 包
import Vuex from 'vuex'
Vue.use(Vuex)
2.4 创建 store 对象
const store = new Vuex.Store({
// state 中存放的就是全局共享的数据
state: { count: 0 }
})
2.5 将 store 对象挂载到 vue 实例中
new Vue({
el: '#app',
render: h => h(app),
router,
// 将创建的共享数据对象，挂载到 Vue 实例中
// 所有的组件，就可以直接从 store 中获取全局的数据了
store
})
3. Vuex 的核心概念
3.1 Vuex 中的主要核心概念
- State [steɪt]
- Mutation [mjuːˈteɪʃ(ə)n]
- Action
- Getter
3.2 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'])
}
3.3 Mutation
Mutation 用于变更 Store中 的数据。 需要注意的是，在这里无法写异步方法
① 只能通过 mutation 变更 Store 数据，不可以直接操作 Store 中的数据。
② 通过这种方式虽然操作起来稍微繁琐一些，但是可以集中监控所有数据的变化。
3.3.1 通过 this.$store.commit( ) 变更数据
// 定义 Mutation
const store = new Vuex.Store({
state: {
count: 0
},
mutations: {
add(state) {
// 变更状态
state.count++
}
}
})
// 触发mutation
methods: {
handle1() {
// 触发 mutations 的第一种方式
this.$store.commit('add')
}
}
可以在触发 mutations 时传递参数：
// 定义Mutation
const store = new Vuex.Store({
state: {
count: 0
},
mutations: {
addN(state, step) {
// 变更状态
state.count += step
}
}
})
// 触发mutation
methods: {
handle2() {
// 在调用 commit 函数，
// 触发 mutations 时携带参数
this.$store.commit('addN', 3)
}
}
3.3.1 方式二
1.从 vuex 中按需导入 mapMutations 函数
import { mapMutations } from 'vuex'
通过刚才导入的 mapMutations 函数，将需要的 mutations 函数，映射为当前组件的 methods 方法：
// 2. 将指定的 mutations 函数，映射为当前组件的 methods 函数
methods: {
...mapMutations(['add', 'addN'])
}
使用案例
<template>
<div>
<!-- <h3>当前最新的count值为：{{count}}</h3> -->
<button @click="btnHandler1">-1</button>
<button @click="subN(3)">-N</button>
</div>
</template>
<script>
import { mapState,mapMutations } from 'vuex'
export default {
data() {
return {}
},
computed: {
...mapState(['count']),// 组件访问 State 中数据的第二种方式 也可以直接用this.$store.state.count
},
methods: {
...mapMutations(['sub', 'subN']),// 将指定的 mutations 函数，映射为当前组件的 methods 函数
btnHandler1() {
this.sub();// 直接使用 mutations 映射进来的方法
}
}
}
</script>
3.4 Action 触发 actions 异步任务时携带参数：
方式一：this.$store.dispatch
// 定义 Action
const store = new Vuex.Store({
// ...省略其他代码
mutations: {
addN(state, step) {
state.count += step
}
},
actions: {
addNAsync(context, step) {
setTimeout(() => {
context.commit('addN', step);// 调用的是 Mutation 中的 方法 来修改对象
}, 1000)
}
}
})
// 触发 Action
methods: {
handle() {
// 在调用 dispatch 函数，
// 触发 actions 时携带参数
this.$store.dispatch('addNAsync', 5)
}
}
方式二：
从 vuex 中按需导入 mapActions 函数
import { mapActions } from 'vuex'
通过刚才导入的 mapActions 函数，将需要的 actions 函数，映射为当前组件的 methods 方法：
// 2. 将指定的 actions 函数，映射为当前组件的 methods 函数
methods: {
...mapActions(['addASync', 'addNASync'])
}
<template>
<div>
<!-- <h3>当前最新的count值为：{{count}}</h3> -->
<h3>{{showNum}}</h3>
<button @click="btnHandler1">-1</button>
<button @click="subN(3)">-N</button>
<button @click="subAsync">-1 Async</button>
<button @click="subNAsync(5)">-N Async</button>
</div>
</template>
<script>
import { mapState, mapMutations, mapActions, mapGetters } from 'vuex'
export default {
data() {
return {}
},
computed: {
...mapState(['count']),
...mapGetters(['showNum'])
},
methods: {
...mapMutations(['sub', 'subN']),
...mapActions(['subAsync', 'subNAsync']),
btnHandler1() {
this.sub()
}
}
}
</script>
store.js
import Vue from 'vue'
import Vuex from 'vuex'
Vue.use(Vuex)
export default new Vuex.Store({
state: {
count: 0
},
// 只有 mutations 中定义的函数，才有权利修改 state 中的数据
mutations: {
add(state) {
// 不要在 mutations 函数中，执行异步操作
// setTimeout(() => {
// state.count++
// }, 1000)
state.count++
},
addN(state, step) {
state.count += step
},
sub(state) {
state.count--
},
subN(state, step) {
state.count -= step
}
},
actions: {
addAsync(context) {
setTimeout(() => {
// 在 actions 中，不能直接修改 state 中的数据；
// 必须通过 context.commit() 触发某个 mutation 才行
context.commit('add')
}, 1000)
},
addNAsync(context, step) {
setTimeout(() => {
context.commit('addN', step)
}, 1000)
},
subAsync(context) {
setTimeout(() => {
context.commit('sub')
}, 1000)
},
subNAsync(context, step) {
setTimeout(() => {
context.commit('subN', step)
}, 1000)
}
},
getters: {
showNum(state) {
return '当前最新的数量是【' + state.count + '】'
}
}
})
3.5 Getter
Getter 用于对 Store 中的数据进行加工处理形成新的数据。
① Getter 可以对 Store 中已有的数据加工处理之后形成新的数据(不会修改数据)，类似 Vue 的计算属性。
② Store 中数据发生变化，Getter 的数据也会跟着变化。
// 定义 Getter
const store = new Vuex.Store({
state: {
count: 0
},
getters: {
showNum: state => {
return '当前最新的数量是【'+ state.count +'】'
}
}
})
使用 getters 的第一种方式：
this.$store.getters.名称
使用 getters 的第二种方式：
import { mapGetters } from 'vuex'
computed: {
...mapGetters(['showNum'])
}
js 文件使用vuex
import store from '../../../store' // 引入
使用：
store.state.xxx
基于 Vuex 的案例
vue结合localStorage
const state = {
copyOffset:20, // 复制功能的偏移量，默认是20
checkTagList: (() => {
try {
const savedTags = localStorage.getItem("checkTagList");
return savedTags ? JSON.parse(savedTags) : [];
} catch (e) {
console.error("Failed to load checkTagList from localStorage", e);
return []; // 如果解析失败，返回空数组
}
})(), // 使用立即执行函数表达式 (IIFE) 确保初始值正确
}
const mutations = {
// 设置复制功能的偏移量，
setCopyOffset(state, handleType) {
if(handleType=='reset'){
state.copyOffset = 20;
}else{
state.copyOffset += 20;
}
},
setCheckTagList(state, tagList){
state.checkTagList = tagList;
localStorage.setItem("checkTagList", JSON.stringify(tagList));
}
}