Vuex

2022/6/13 23:24:15

本文主要是介绍Vuex,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!

Vuex

1、概念

1.1Vuex是什么?

Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式 + 库。它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化。

简单俩说,它就是解决我们组件共享之间的vue插件!

1.2、那么什么是状态管理模式?

 const Counter = {
   // 状态
   data () {
     return {
       count: 0
     }
   },
   // 视图
   template: `
     <div>{{ count }}</div>
   `,
   // 操作
   methods: {
     increment () {
       this.count++
     }
   }
 }
 ​
 createApp(Counter).mount('#app')

这个状态自管理应用包含以下几个部分:

  • 状态,驱动应用的数据源;

  • 视图,以声明方式将状态映射到视图;

  • 操作,响应在视图上的用户输入导致的状态变化。

以下是一个表示“单向数据流”理念的简单示意:

但是,当我们的应用遇到多个组件共享状态时,单向数据流的简洁性很容易被破坏:

  • 多个视图依赖于同一状态。

  • 来自不同视图的行为需要变更同一状态。

 

在上面的图示,可以知道我们的数据都是放在state中的,然后供我们Vue组件使用,但是这里为什么要定义 Actions/ Mutations,

这里Actions / Mutations 都是对data数据的改变,但是Actions是对数据的间接改变,而Mutations是对数据的直接改变!

总结:

  • vue其实就是vue页面组件数据共享的一个插件!

  • 如果对vuex不理解的话,可以理解为Java中的session。可以共享数据。而这里的vuex共享的数据是给所有页面组件使用的。而Java中session共享的数据是给所有的类使用的!

1.3、什么情况下使用vuex?

Vuex 可以帮助我们管理共享状态,并附带了更多的概念和框架。这需要对短期和长期效益进行权衡。

如果您不打算开发大型单页应用,使用 Vuex 可能是繁琐冗余的。确实是如此——如果您的应用够简单,您最好不要使用 Vuex。一个简单的 store 模式就足够您所需了。但是,如果您需要构建一个中大型单页应用,您很可能会考虑如何更好地在组件外部管理状态,Vuex 将会成为自然而然的选择。

 

1.3、安装,项目搭建

在这里是基于vue3,基于vue-cli脚手架进行安装下载:

安装:

这里要确保已将安装了yarn,否则我们在使用yarn进行安装会报如下错误:Vue创建项目页面报错Cannot read properties of undefined (reading ‘indexOf‘)

参考博客:https://blog.csdn.net/D_Zhou_Sir/article/details/124946646

yarn global add @vue/cli

 npm install -g @vue/cli
 # OR
 yarn global add @vue/cli

创建一个项目:

 vue create my-project
 # OR
 vue ui

输入之后进入图行界面的页面:

这里创建选择vue3,然后输入名字,下一步即可!

然后就会生成如下界面:

当然就这样还是不够的,需要下载插件:(Plugins)

接下来我们就可以实现正常的使用了!点击sever运行服务即可正常访问!

在这里遇到一个坑那就是devtools插件,本来想着下载这个方便一点,但是导致程序报错,启动失败!(如果报错了,那么请去打开vscode删除对应的依赖!)

在使用vue ui进行页面的创建的时候,发现自己的版本不是基于vue3,然后进行创建vue2也不行,然后遇到这个问题!vue 创建项目 Cannot set property ‘context‘ of null,遇到的问题,参考博客:

https://blog.csdn.net/enkidu_gachi/article/details/123569042

 

对于store / index.js了解!

 import { createStore } from 'vuex'
 ​
 // 1:导入vuex的模块
 ​
 // 2:注册vuex插件到vue中,这里就是全局注册
 // 3:开始给vuex中定义响应式全局数据共享对象 this.$store
 ​
 export default createStore({
   // 4: 定义响应式的数据,就类似于data,只不过是全局
   state: {
     // 状态管理的数据!
     count: 0
   },
   // 5: 可以认为是 store 的计算属性,对state管理的一种过滤处理的机制!
   getters: {
   },
   // 6 :定义改变state数据的行为,可以直接修改state的数据
   mutations: {
     // 改变state的数据状态!
     increment (state) {
       state.count++
     }
   },
   // 7:actions是处理异步数据和提交mutations的机制。简介改变state
   // 注意:不能直接更改state的数据。更改的方式通过commit('mutations定义的事件')
   actions: {
     
   },
   // 8:模块化隔离的一种机制!
   modules: {
   }
 })

 

2、核心

2.1、state

1、定义state

遵循vue的语法一样的规则!

   state: {
     // 状态管理的数据!
     count: 0
   },

2、如何改变state

主要通过mutation(直接改变)和actions(间接改变)

 // 在store/index.js定义如下
 // 可以改变state管理的数据
 // 执行的方式是 this.$store.commit('increment')
 mutations: {
     // 改变state的数据状态!
     increment (state) {
       state.count++
     }
   },
   // 注意:不能直接更改state的数据。更改的方式通过commit('mutations定义的事件')
   // 执行的方式是 this.$store.dispatch('increment')
   actions: {
     increment (context){
       context.commit("increment")
     }
   },

3、在Vue组件中获取vuex状态

那么我们如何在 Vue 组件中展示状态呢?由于 Vuex 的状态存储是响应式的,从 store 实例中读取状态最简单的方法就是在计算属性中返回某个状态:

我们如果想要 使用/变更 store中定义好的,应该怎么做呢?

  • 使用:this.$store.state.xxx(xxx就是你要使用的!)

  • 改变:this.$store.commit(“x”)(mutations中定义的方法,就是这里要使用的!)

只要在我们需要使用的页面进行如下操作!定义在computed中

   computed: {
     count (){
       return this.$store.state.count;
     }
   }

那么这里有一个问题,那就是我们不定义在这里难道不可以吗?

答案当然是可以的,只不过,如果我们不定义在这里的话,那么我们的数据就不是响应式的,可以实验下面的案例进行验证!

每当 store.state.count 变化的时候, 都会重新求取计算属性,并且触发更新相关联的 DOM。

store / index.js

 import { createStore } from 'vuex'
 ​
 // 1:导入vuex的模块
 ​
 // 2:注册vuex插件到vue中,这里就是全局注册
 // 3:开始给vuex中定义响应式全局数据共享对象 this.$store
 ​
 export default createStore({
   // 4: 定义响应式的数据,就类似于data,只不过是全局
   state: {
     // 状态管理的数据!
     count: 100
   },
   // 5: 可以认为是 store 的计算属性,对state管理的一种过滤处理的机制!
   getters: {
   },
   // 6 :定义改变state数据的行为,可以直接修改state的数据
   mutations: {
     // 改变state的数据状态!
     increment (state) {
       state.count++
     }
   },
   // 7:actions是处理异步数据和提交mutations的机制。简介改变state
   // 注意:不能直接更改state的数据。更改的方式通过commit('mutations定义的事件')
   actions: {
     increment (context){
       context.commit("increment")
     }
   },
   // 8:模块化隔离的一种机制!
   modules: {
   }
 })

例如在homeview中进行使用:

 <template>
   <div class="home">
     <img alt="Vue logo" src="../assets/logo.png">
     <HelloWorld msg="Welcome to Your Vue.js App"/>
     当前的数量为:{{count}}--{{zcount}}
     <button @click="addcount">按钮</button>
   </div>
 </template>
 ​
 <script>
 // @ is an alias to /src
 import HelloWorld from '@/components/HelloWorld.vue'
 ​
 export default {
   name: 'HomeView',
   components: {
     HelloWorld
   },
   data(){
     return{
       zcount:this.$store.state.count
     }
   },
   created(){
     console.log(this);
   },
   // 这里可以不定义在computed中吗?当然是可以的!只不过不定义在这里的话就不是响应式的!
   computed: {
     count (){
       return this.$store.state.count;
     }
   },
   // 事件定义的位置
   methods:{
     // 1. 定义count累加,改变vuex的状态!
     addcount(){
       this.$store.commit("increment")
     }
   }
 }
 </script>

 

mapState 辅助函数

当一个组件需要获取多个状态的时候,将这些状态都声明为计算属性会有些重复和冗余。为了解决这个问题,我们可以使用 mapState 辅助函数帮助我们生成计算属性,让你少按几次键:

 // 在单独构建的版本中辅助函数为 Vuex.mapState
 import { mapState } from 'vuex'
 ​
 export default {
   // ...
   computed: mapState({
     // 箭头函数可使代码更简练
     count: state => state.count,
 ​
     // 传字符串参数 'count' 等同于 `state => state.count`
     countAlias: 'count',
 ​
     // 为了能够使用 `this` 获取局部状态,必须使用常规函数
     countPlusLocalState (state) {
       return state.count + this.localCount
     }
   })
 }

当映射的计算属性的名称与 state 的子节点名称相同时,我们也可以给 mapState 传一个字符串数组。

 computed: mapState([
   // 映射 this.count 为 store.state.count
   'count'
 ])

对象展开运算符

mapState 函数返回的是一个对象。我们如何将它与局部计算属性混合使用呢?通常,我们需要使用一个工具函数将多个对象合并为一个,以使我们可以将最终对象传给 computed 属性。但是自从有了对象展开运算符,我们可以极大地简化写法:

 computed: {
   localComputed () { /* ... */ },
   // 使用对象展开运算符将此对象混入到外部对象中
   ...mapState({
     // ...
   })
 }

 

2.2、Mutations

更改 Vuex 的 store 中的状态的唯一方法是提交 mutation。Vuex 中的 mutation 非常类似于事件:每个 mutation 都有一个字符串的事件类型 (type)*和一个*回调函数 (handler)。这个回调函数就是我们实际进行状态更改的地方,并且它会接受 state 作为第一个参数:

 const store = createStore({
   state: {
     count: 1
   },
   mutations: {
     increment (state) {
       // 变更状态
       state.count++
     }
   }
 })

你不能直接调用一个 mutation 处理函数。这个选项更像是事件注册:“当触发一个类型为 increment 的 mutation 时,调用此函数。”要唤醒一个 mutation 处理函数,你需要以相应的 type 调用 store.commit 方法:

 store.commit('increment')

提交载荷(Payload)

你可以向 store.commit 传入额外的参数,即 mutation 的载荷(payload)

 // ...
 mutations: {
   increment (state, n) {
     state.count += n
   }
 }
 store.commit('increment', 10)

在大多数情况下,载荷应该是一个对象,这样可以包含多个字段并且记录的 mutation 会更易读:

 // ...
 mutations: {
   increment (state, payload) {
     state.count += payload.amount
   }
 }
 store.commit('increment', {
   amount: 10
 })

对象风格的提交方式

提交 mutation 的另一种方式是直接使用包含 type 属性的对象:

 store.commit({
   type: 'increment',
   amount: 10
 })

当使用对象风格的提交方式,整个对象都作为载荷传给 mutation 函数,因此处理函数保持不变:

 mutations: {
   increment (state, payload) {
     state.count += payload.amount
   }
 }

使用常量代替 Mutation事件类型

使用常量替代 mutation 事件类型在各种 Flux 实现中是很常见的模式。这样可以使 linter 之类的工具发挥作用,同时把这些常量放在单独的文件中可以让你的代码合作者对整个 app 包含的 mutation 一目了然:

 // mutation-types.js
 export const SOME_MUTATION = 'SOME_MUTATION'
 // store.js
 import { createStore } from 'vuex'
 import { SOME_MUTATION } from './mutation-types'
 ​
 const store = createStore({
   state: { ... },
   mutations: {
     // 我们可以使用 ES2015 风格的计算属性命名功能
     // 来使用一个常量作为函数名
     [SOME_MUTATION] (state) {
       // 修改 state
     }
   }
 })

Mutation 必须是同步函数

一条重要的原则就是要记住 mutation 必须是同步函数。为什么?请参考下面的例子:

 mutations: {
   someMutation (state) {
     api.callAsyncMethod(() => {
       state.count++
     })
   }
 }

现在想象,我们正在 debug 一个 app 并且观察 devtool 中的 mutation 日志。每一条 mutation 被记录,devtools 都需要捕捉到前一状态和后一状态的快照。然而,在上面的例子中 mutation 中的异步函数中的回调让这不可能完成:因为当 mutation 触发的时候,回调函数还没有被调用,devtools 不知道什么时候回调函数实际上被调用——实质上任何在回调函数中进行的状态的改变都是不可追踪的。

在组件中提交 Mutation

你可以在组件中使用 this.$store.commit('xxx') 提交 mutation,或者使用 mapMutations 辅助函数将组件中的 methods 映射为 store.commit 调用(需要在根节点注入 store)。

 import { mapMutations } from 'vuex'
 ​
 export default {
   // ...
   methods: {
     ...mapMutations([
       'increment', // 将 `this.increment()` 映射为 `this.$store.commit('increment')`
 ​
       // `mapMutations` 也支持载荷:
       'incrementBy' // 将 `this.incrementBy(amount)` 映射为 `this.$store.commit('incrementBy', amount)`
     ]),
     ...mapMutations({
       add: 'increment' // 将 `this.add()` 映射为 `this.$store.commit('increment')`
     })
   }
 }

 

2.3、Action

Action 类似于 mutation,不同在于:

  • Action 提交的是 mutation,而不是直接变更状态。

  • Action 可以包含任意异步操作。

 const store = createStore({
   state: {
     count: 0
   },
   mutations: {
     increment (state) {
       state.count++
     }
   },
   actions: {
     increment (context) {
       context.commit('increment')
     }
   }
 })

Action 函数接受一个与 store 实例具有相同方法和属性的 context 对象,因此你可以调用 context.commit 提交一个 mutation,或者通过 context.statecontext.getters 来获取 state 和 getters。

实践中,我们会经常用到 ES2015 的参数解构来简化代码(特别是我们需要调用 commit 很多次的时候):

 actions: {
   increment ({ commit }) {
     commit('increment')
   }
 }

 

分发Action

Action 通过 store.dispatch 方法触发:

 store.dispatch('increment')

乍一眼看上去感觉多此一举,我们直接分发 mutation 岂不更方便?实际上并非如此,还记得 mutation 必须同步执行这个限制么?Action 就不受约束!我们可以在 action 内部执行异步操作:

 actions: {
   incrementAsync ({ commit }) {
     setTimeout(() => {
       commit('increment')
     }, 1000)
   }
 }

Actions 支持同样的载荷方式和对象方式进行分发:

 // 以载荷形式分发
 store.dispatch('incrementAsync', {
   amount: 10
 })
 ​
 // 以对象形式分发
 store.dispatch({
   type: 'incrementAsync',
   amount: 10
 })

来看一个更加实际的购物车示例,涉及到调用异步 API分发多重 mutation

 actions: {
   checkout ({ commit, state }, products) {
     // 把当前购物车的物品备份起来
     const savedCartItems = [...state.cart.added]
     // 发出结账请求
     // 然后乐观地清空购物车
     commit(types.CHECKOUT_REQUEST)
     // 购物 API 接受一个成功回调和一个失败回调
     shop.buyProducts(
       products,
       // 成功操作
       () => commit(types.CHECKOUT_SUCCESS),
       // 失败操作
       () => commit(types.CHECKOUT_FAILURE, savedCartItems)
     )
   }
 }

注意我们正在进行一系列的异步操作,并且通过提交 mutation 来记录 action 产生的副作用(即状态变更)。

 

在组件中分发Action

你在组件中使用 this.$store.dispatch('xxx') 分发 action,或者使用 mapActions 辅助函数将组件的 methods 映射为 store.dispatch 调用(需要先在根节点注入 store):

 import { mapActions } from 'vuex'
 ​
 export default {
   // ...
   methods: {
     ...mapActions([
       'increment', // 将 `this.increment()` 映射为 `this.$store.dispatch('increment')`
 ​
       // `mapActions` 也支持载荷:
       'incrementBy' // 将 `this.incrementBy(amount)` 映射为 `this.$store.dispatch('incrementBy', amount)`
     ]),
     ...mapActions({
       add: 'increment' // 将 `this.add()` 映射为 `this.$store.dispatch('increment')`
     })
   }
 }

 

组合 Action

Action 通常是异步的,那么如何知道 action 什么时候结束呢?更重要的是,我们如何才能组合多个 action,以处理更加复杂的异步流程?

首先,你需要明白 store.dispatch 可以处理被触发的 action 的处理函数返回的 Promise,并且 store.dispatch 仍旧返回 Promise:

 actions: {
   actionA ({ commit }) {
     return new Promise((resolve, reject) => {
       setTimeout(() => {
         commit('someMutation')
         resolve()
       }, 1000)
     })
   }
 }

现在你可以:

 store.dispatch('actionA').then(() => {
   // ...
 })

在另外一个 action 中也可以:

 actions: {
   // ...
   actionB ({ dispatch, commit }) {
     return dispatch('actionA').then(() => {
       commit('someOtherMutation')
     })
   }
 }

最后,如果我们利用 async / await,我们可以如下组合 action:

 // 假设 getData() 和 getOtherData() 返回的是 Promise
 ​
 actions: {
   async actionA ({ commit }) {
     commit('gotData', await getData())
   },
   async actionB ({ dispatch, commit }) {
     await dispatch('actionA') // 等待 actionA 完成
     commit('gotOtherData', await getOtherData())
   }
 }

一个 store.dispatch 在不同模块中可以触发多个 action 函数。在这种情况下,只有当所有触发函数完成后,返回的 Promise 才会执行。

 

案例:

在这里我们假如要有一个登录请求:

 import { createStore } from 'vuex'
 ​
 // 1:导入vuex的模块
 ​
 // 2:注册vuex插件到vue中,这里就是全局注册
 // 3:开始给vuex中定义响应式全局数据共享对象 this.$store
 ​
 export default createStore({
   // 4: 定义响应式的数据,就类似于data,只不过是全局
   state: {
     // 状态管理的数据!
     count: 100,
     user: {
       nickName:"",
       password:""
     }
   },
   // 5: 可以认为是 store 的计算属性,对state管理的一种过滤处理的机制!
   getters: {
   },
   // 6 :定义改变state数据的行为,可以直接修改state的数据
   mutations: {
     // 改变state的数据状态!
     increment (state) {
       state.count++
     },
     changeuser(state,params){
       state.user.nickName = params.nickName
       state.user.password = params.password
     }
   },
   // 7:actions是处理异步数据和提交mutations的机制。简介改变state
   // 注意:不能直接更改state的数据。更改的方式通过commit('mutations定义的事件')
   actions: {
     // 改变state的数据状态,车间
     // increment (context){
     //  移除处理
     //   context.commit("increment")
     // }
 ​
     increment({commit}){
       // 异步处理
       commit("increment")
     },
 ​
     //登录逻辑
     login({commit},params){
       commit('changeuser',params);
     }
     
   },
   // 8:模块化隔离的一种机制!
   modules: {
   }
 })

然后进行使用:

 <template>
   <div class="home">
     <img alt="Vue logo" src="../assets/logo.png">
     <HelloWorld msg="Welcome to Your Vue.js App"/>
     当前的数量为:{{count}}--{{zcount}}
     <button @click="addcount">按钮</button>
     当前用户为:{{user.nickName}}
   </div>
 </template>
 ​
 <script>
 // @ is an alias to /src
 import HelloWorld from '@/components/HelloWorld.vue'
 ​
 export default {
   name: 'HomeView',
   components: {
     HelloWorld
   },
   data(){
     return{
       zcount:this.$store.state.count
     }
   },
   created(){
     console.log(this);
   },
   // 这里可以不定义在computed中吗?当然是可以的!只不过不定义在这里的话就不是响应式的!
   computed: {
     count (){
       return this.$store.state.count;
     },
     user(){
       return this.$store.state.user;
     }
   },
   // 事件定义的位置
   methods:{
     // 1. 定义count累加,改变vuex的状态!
     addcount(){
       // this.$store.commit("increment")
       var nickName = "admin";
       var password = "123456";
 ​
       this.$store.dispatch('login', {nickName,password})
     }
   }
 }
 </script>
 ​

这里是单页面的测试!试想一下,如果我们有很多页面都要进行使用呢?那么不是要写很多吗?所以这种情况下我们就要把他抽取出来定义一个Login.vue,方便我们多个页面之间进行复用!

 

2.4、Getter

有时候我们需要从 store 中的 state 中派生出一些状态,例如对列表进行过滤并计数:

 computed: {
   doneTodosCount () {
     return this.$store.state.todos.filter(todo => todo.done).length
   }
 }

如果有多个组件需要用到此属性,我们要么复制这个函数,或者抽取到一个共享函数然后在多处导入它——无论哪种方式都不是很理想。

Vuex 允许我们在 store 中定义“getter”(可以认为是 store 的计算属性)。

Getter 接受 state 作为其第一个参数:

 const store = createStore({
   state: {
     todos: [
       { id: 1, text: '...', done: true },
       { id: 2, text: '...', done: false }
     ]
   },
   getters: {
     doneTodos (state) {
       return state.todos.filter(todo => todo.done)
     }
   }
 })

通过属性访问

Getter 会暴露为 store.getters 对象,你可以以属性的形式访问这些值:

 store.getters.doneTodos // -> [{ id: 1, text: '...', done: true }]

Getter 也可以接受其他 getter 作为第二个参数:

 getters: {
   // ...
   doneTodosCount (state, getters) {
     return getters.doneTodos.length
   }
 }
 store.getters.doneTodosCount // -> 1

我们可以很容易地在任何组件中使用它:

 computed: {
   doneTodosCount () {
     return this.$store.getters.doneTodosCount
   }
 }

注意,getter 在通过属性访问时是作为 Vue 的响应式系统的一部分缓存其中的。

通过方法访问

你也可以通过让 getter 返回一个函数,来实现给 getter 传参。在你对 store 里的数组进行查询时非常有用。

 getters: {
   // ...
   getTodoById: (state) => (id) => {
     return state.todos.find(todo => todo.id === id)
   }
 }
 store.getters.getTodoById(2) // -> { id: 2, text: '...', done: false }

注意,getter 在通过方法访问时,每次都会去进行调用,而不会缓存结果。

mapGetters 辅助函数

mapGetters 辅助函数仅仅是将 store 中的 getter 映射到局部计算属性:

 import { mapGetters } from 'vuex'
 ​
 export default {
   // ...
   computed: {
   // 使用对象展开运算符将 getter 混入 computed 对象中
     ...mapGetters([
       'doneTodosCount',
       'anotherGetter',
       // ...
     ])
   }
 }

如果你想将一个 getter 属性另取一个名字,使用对象形式:

 ...mapGetters({
   // 把 `this.doneCount` 映射为 `this.$store.getters.doneTodosCount`
   doneCount: 'doneTodosCount'
 })

 

2.5、Module

由于使用单一状态树,应用的所有状态会集中到一个比较大的对象。当应用变得非常复杂时,store 对象就有可能变得相当臃肿。

为了解决以上问题,Vuex 允许我们将 store 分割成模块(module)。每个模块拥有自己的 state、mutation、action、getter、甚至是嵌套子模块——从上至下进行同样方式的分割:

 const moduleA = {
   state: () => ({ ... }),
   mutations: { ... },
   actions: { ... },
   getters: { ... }
 }
 ​
 const moduleB = {
   state: () => ({ ... }),
   mutations: { ... },
   actions: { ... }
 }
 ​
 const store = createStore({
   modules: {
     a: moduleA,
     b: moduleB
   }
 })
 ​
 store.state.a // -> moduleA 的状态
 store.state.b // -> moduleB 的状态

模块的局部状态

对于模块内部的 mutation 和 getter,接收的第一个参数是模块的局部状态对象

 const moduleA = {
   state: () => ({
     count: 0
   }),
   mutations: {
     increment (state) {
       // 这里的 `state` 对象是模块的局部状态
       state.count++
     }
   },
   getters: {
     doubleCount (state) {
       return state.count * 2
     }
   }
 }

同样,对于模块内部的 action,局部状态通过 context.state 暴露出来,根节点状态则为 context.rootState

 const moduleA = {
   // ...
   actions: {
     incrementIfOddOnRootSum ({ state, commit, rootState }) {
       if ((state.count + rootState.count) % 2 === 1) {
         commit('increment')
       }
     }
   }
 }

对于模块内部的 getter,根节点状态会作为第三个参数暴露出来:

 const moduleA = {
   // ...
   getters: {
     sumWithRootCount (state, getters, rootState) {
       return state.count + rootState.count
     }
   }
 }

命名空间

默认情况下,模块内部的 action 和 mutation 仍然是注册在全局命名空间的——这样使得多个模块能够对同一个 action 或 mutation 作出响应。Getter 同样也默认注册在全局命名空间,但是目前这并非出于功能上的目的(仅仅是维持现状来避免非兼容性变更)。必须注意,不要在不同的、无命名空间的模块中定义两个相同的 getter 从而导致错误。

如果希望你的模块具有更高的封装度和复用性,你可以通过添加 namespaced: true 的方式使其成为带命名空间的模块。当模块被注册后,它的所有 getter、action 及 mutation 都会自动根据模块注册的路径调整命名。例如:

 const store = createStore({
   modules: {
     account: {
       namespaced: true,
 ​
       // 模块内容(module assets)
       state: () => ({ ... }), // 模块内的状态已经是嵌套的了,使用 `namespaced` 属性不会对其产生影响
       getters: {
         isAdmin () { ... } // -> getters['account/isAdmin']
       },
       actions: {
         login () { ... } // -> dispatch('account/login')
       },
       mutations: {
         login () { ... } // -> commit('account/login')
       },
 ​
       // 嵌套模块
       modules: {
         // 继承父模块的命名空间
         myPage: {
           state: () => ({ ... }),
           getters: {
             profile () { ... } // -> getters['account/profile']
           }
         },
 ​
         // 进一步嵌套命名空间
         posts: {
           namespaced: true,
 ​
           state: () => ({ ... }),
           getters: {
             popular () { ... } // -> getters['account/posts/popular']
           }
         }
       }
     }
   }
 })

启用了命名空间的 getter 和 action 会收到局部化的 getterdispatchcommit。换言之,你在使用模块内容(module assets)时不需要在同一模块内额外添加空间名前缀。更改 namespaced 属性后不需要修改模块内的代码。

在带命名空间的模块内访问全局内容(Global Assets

如果你希望使用全局 state 和 getter,rootStaterootGetters 会作为第三和第四参数传入 getter,也会通过 context 对象的属性传入 action。

若需要在全局命名空间内分发 action 或提交 mutation,将 { root: true } 作为第三参数传给 dispatchcommit 即可。

 modules: {
   foo: {
     namespaced: true,
 ​
     getters: {
       // 在这个模块的 getter 中,`getters` 被局部化了
       // 你可以使用 getter 的第四个参数来调用 `rootGetters`
       someGetter (state, getters, rootState, rootGetters) {
         getters.someOtherGetter // -> 'foo/someOtherGetter'
         rootGetters.someOtherGetter // -> 'someOtherGetter'
         rootGetters['bar/someOtherGetter'] // -> 'bar/someOtherGetter'
       },
       someOtherGetter: state => { ... }
     },
 ​
     actions: {
       // 在这个模块中, dispatch 和 commit 也被局部化了
       // 他们可以接受 `root` 属性以访问根 dispatch 或 commit
       someAction ({ dispatch, commit, getters, rootGetters }) {
         getters.someGetter // -> 'foo/someGetter'
         rootGetters.someGetter // -> 'someGetter'
         rootGetters['bar/someGetter'] // -> 'bar/someGetter'
 ​
         dispatch('someOtherAction') // -> 'foo/someOtherAction'
         dispatch('someOtherAction', null, { root: true }) // -> 'someOtherAction'
 ​
         commit('someMutation') // -> 'foo/someMutation'
         commit('someMutation', null, { root: true }) // -> 'someMutation'
       },
       someOtherAction (ctx, payload) { ... }
     }
   }
 }

在带命名空间的模块注册全局 action

若需要在带命名空间的模块注册全局 action,你可添加 root: true,并将这个 action 的定义放在函数 handler 中。例如:

 {
   actions: {
     someOtherAction ({dispatch}) {
       dispatch('someAction')
     }
   },
   modules: {
     foo: {
       namespaced: true,
 ​
       actions: {
         someAction: {
           root: true,
           handler (namespacedContext, payload) { ... } // -> 'someAction'
         }
       }
     }
   }
 }

带命名空间的绑定函数

当使用 mapStatemapGettersmapActionsmapMutations 这些函数来绑定带命名空间的模块时,写起来可能比较繁琐:

 computed: {
   ...mapState({
     a: state => state.some.nested.module.a,
     b: state => state.some.nested.module.b
   }),
   ...mapGetters([
     'some/nested/module/someGetter', // -> this['some/nested/module/someGetter']
     'some/nested/module/someOtherGetter', // -> this['some/nested/module/someOtherGetter']
   ])
 },
 methods: {
   ...mapActions([
     'some/nested/module/foo', // -> this['some/nested/module/foo']()
     'some/nested/module/bar' // -> this['some/nested/module/bar']()
   ])
 }

对于这种情况,你可以将模块的空间名称字符串作为第一个参数传递给上述函数,这样所有绑定都会自动将该模块作为上下文。于是上面的例子可以简化为:

 computed: {
   ...mapState('some/nested/module', {
     a: state => state.a,
     b: state => state.b
   }),
   ...mapGetters('some/nested/module', [
     'someGetter', // -> this.someGetter
     'someOtherGetter', // -> this.someOtherGetter
   ])
 },
 methods: {
   ...mapActions('some/nested/module', [
     'foo', // -> this.foo()
     'bar' // -> this.bar()
   ])
 }

而且,你可以通过使用 createNamespacedHelpers 创建基于某个命名空间辅助函数。它返回一个对象,对象里有新的绑定在给定命名空间值上的组件绑定辅助函数:

 import { createNamespacedHelpers } from 'vuex'
 ​
 const { mapState, mapActions } = createNamespacedHelpers('some/nested/module')
 ​
 export default {
   computed: {
     // 在 `some/nested/module` 中查找
     ...mapState({
       a: state => state.a,
       b: state => state.b
     })
   },
   methods: {
     // 在 `some/nested/module` 中查找
     ...mapActions([
       'foo',
       'bar'
     ])
   }
 }

给插件开发者的注意事项

如果你开发的插件提供了模块并允许用户将其添加到 Vuex store,可能需要考虑模块的空间名称问题。对于这种情况,你可以通过插件的参数对象来允许用户指定空间名称:

 // 通过插件的参数对象得到空间名称
 // 然后返回 Vuex 插件函数
 export function createPlugin (options = {}) {
   return function (store) {
     // 把空间名字添加到插件模块的类型(type)中去
     const namespace = options.namespace || ''
     store.dispatch(namespace + 'pluginAction')
   }
 }

模块动态注册

在 store 创建之后,你可以使用 store.registerModule 方法注册模块:

 import { createStore } from 'vuex'
 ​
 const store = createStore({ /* 选项 */ })
 ​
 // 注册模块 `myModule`
 store.registerModule('myModule', {
   // ...
 })
 ​
 // 注册嵌套模块 `nested/myModule`
 store.registerModule(['nested', 'myModule'], {
   // ...
 })

之后就可以通过 store.state.myModulestore.state.nested.myModule 访问模块的状态。

模块动态注册功能使得其他 Vue 插件可以通过在 store 中附加新模块的方式来使用 Vuex 管理状态。例如,vuex-router-sync 插件就是通过动态注册模块将 Vue Router 和 Vuex 结合在一起,实现应用的路由状态管理。

你也可以使用 store.unregisterModule(moduleName) 来动态卸载模块。注意,你不能使用此方法卸载静态模块(即创建 store 时声明的模块)。

注意,你可以通过 store.hasModule(moduleName) 方法检查该模块是否已经被注册到 store。需要记住的是,嵌套模块应该以数组形式传递给 registerModulehasModule,而不是以路径字符串的形式传递给 module。

保留 state

在注册一个新 module 时,你很有可能想保留过去的 state,例如从一个服务端渲染的应用保留 state。你可以通过 preserveState 选项将其归档:store.registerModule('a', module, { preserveState: true })

当你设置 preserveState: true 时,该模块会被注册,action、mutation 和 getter 会被添加到 store 中,但是 state 不会。这里假设 store 的 state 已经包含了这个 module 的 state 并且你不希望将其覆写。

模块重用

有时我们可能需要创建一个模块的多个实例,例如:

  • 创建多个 store,他们公用同一个模块 (例如当 runInNewContext 选项是 false'once' 时,为了在服务端渲染中避免有状态的单例)

  • 在一个 store 中多次注册同一个模块

如果我们使用一个纯对象来声明模块的状态,那么这个状态对象会通过引用被共享,导致状态对象被修改时 store 或模块间数据互相污染的问题。

实际上这和 Vue 组件内的 data 是同样的问题。因此解决办法也是相同的——使用一个函数来声明模块状态(仅 2.3.0+ 支持):

 const MyReusableModule = {
   state: () => ({
     foo: 'bar'
   }),
   // mutation、action 和 getter 等等...
 }

 

mapXXX

vuex中提供的mapxxx机制:

记住它仅仅只是一种就简化获取state和执行mutations和actions行为的方式,不用显示的区通过commit和dispatch去触发。他的思想就是借助:es6的对象解构。mapXXX就是一个对象。

 <template>
 <div>
   id:{{user.nickName}}
 </div>
 </template>
 ​
 <script>
 import { mapState } from 'vuex'
 ​
 export default {
   name: 'Login',
   props: {
     msg: String
   },
   // // 1.原生的写法
   //  computed: {
   //   user(){
   //     return this.$store.state.user;
   //   }
   // },
   // 2、用对象获取state数据,好处是可以随便更改名字
   //   computed:mapState({
   //   // key= count就是computed的计算属性,value="count"是vuex中state的属性key
   //   count:"count",
   //   user:"user"
   // }),
 ​
   // // 3:用数组的方式获取state的数据
   // computed:mapState(['count','user'])
 ​
   // 4:解构mapstate,为什么需要他?因为在实际的开发中,除了有vuex状态需要响应的属性之外还有
   // 我们页面当前页面需要控制的计算属性,所以使用解构来完成更好!
   computed:{
     ...mapState({
       user:'user'
     })
   }
 ​
 }
 </script>
 ​

在这里我们会遇到一个问题,那就是如何进行传参呢?

 <template>
   <div class="home">
     <img alt="Vue logo" src="../assets/logo.png">
     <HelloWorld msg="Welcome to Your Vue.js App"/>
     <Login></Login>
     当前的数量为:{{count}}
     <button @click="addcount">按钮</button>
     <button @click="toLogin">登录</button>
     <button @click="Login({nickName:'admin',password:'123456'})">登录</button>
 ​
 ​
   </div>
 </template>
 ​
 <script>
 // @ is an alias to /src
 import HelloWorld from '@/components/HelloWorld.vue'
 import Login from '@/components/Login.vue'
 import { mapActions } from 'vuex'
 ​
 export default {
   name: 'HomeView',
   components: {
     HelloWorld,
     Login
   },
   // computed:{
   //   count(){
   //     return this.$store.state.count
   //   },
   //   user(){
   //     return this.$store.state.user
   //   }
   // },
 ​
 ​
 ​
   // 事件定义的位置
   methods:{
     // 1. 定义count累加,改变vuex的状态!
     // addcount(){
     //   // this.$store.commit("increment")
     //   var nickName = "admin";
     //   var password = "123456";
 ​
     //   this.$store.dispatch('login', {nickName,password})
     // }
 ​
 ​
     // 1.用对象的方式解构actions的函数
     ...mapActions({login:'login'}),
     toLogin(){
       var nickName = "vuex admin"
       var password = "vuex 123456"
       this.login({nickName,password})
     }
   }
 }
 </script>

这里我们方式一:就是在输入框中进行赋值,可以定义在data中,也可以显示定义!

还有一种就是我们所推荐的:再次定义一个方法,进行获取!

 

 

 

 



这篇关于Vuex的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!


扫一扫关注最新编程教程