亲宝软件园·资讯

展开

Vuex的store中的Module用法及说明

鸭梨的药丸哥 人气:0

Vuex的store中的Module

1.单一状态树

什么是单一状态树呢?单一状态树可以简单得理解成整个vuex中只有一个store对象。

这是官方对单一状态树的解释:

Vuex 使用单一状态树——是的,用一个对象就包含了全部的应用层级状态。至此它便作为一个“唯一数据源 (SSOT (opens new window))”而存在。这也意味着,每个应用将仅仅包含一个 store 实例。

单一状态树让我们能够直接地定位任一特定的状态片段,在调试的过程中也能轻易地取得整个当前应用状态的快照。

但是当我们全部状态数据都往一个store里面塞的时候,就会出现store过于臃肿,幸好Vuex允许将store分割成模块。单状态树和模块化并不冲突。

**为了反正store的过于臃肿,Vuex允许将store分割成模块。**由于使用单一状态树,应用的所有状态会集中到一个比较大的对象。当应用变得非常复杂时,store 对象就有可能变得相当臃肿。这时我们使用模块化,能有效解决store 臃肿的状况。

2.modules

在Vuex中使用modules字段声明模块。

store中能定义的属性在module都能实现,在module中可以像store一样定义:

//模块A
const moduleA = {
  state: () => ({ ... }),
  mutations: { ... },
  actions: { ... },
  getters: { ... }
}

//模块B
const moduleB = {
  state: () => ({ ... }),
  mutations: { ... },
  actions: { ... }
  //modules: {//模块中允许进行模块的镶嵌,但现实中很少用到}
}

const store = new Vuex.Store({
    //通过modules指定模块
  modules: {
    a: moduleA,
    b: moduleB
  }
})

store.state.a // -> moduleA 的状态
store.state.b // -> moduleB 的状态

3.模块内部的 mutation 和 getters

在modules中的mutation 和 getters其实和store并没有太大的异样,只不过modules中的getters可以多传入一个参数rootState,用于获取上一层的state。

const moduleA = {
  state: {
    count: 0
  },
  mutations: {
    increment (state) {
      // 这里的 `state` 对象是模块的局部状态(也就是moduleA的state)
      state.count++
    }
  },

  getters: {
    doubleCount (state) {
        // 这里的 `state` 对象是模块的局部状态(也就是moduleA的state)
      return state.count * 2
    }
  }
}

const store = new Vuex.Store({
  state: {
    rootcount: 0
  },
  mutations: {
    decrement (state) {
      // 这里的 `state` 对象是模块的局部状态(也就是moduleA的state)
      state.count--
    }
  },
  modules: {
    a: moduleA
  }
})

//-------------在其他组件中使用模块中的state需要指明模块
store.state   // -> moduleA 的状态
store.state.rootcount // -> store中的rootcount
store.state.a // -> moduleA 的状态
store.state.a.count  //moduleA中的count

//-------------其他组件中commit mutations时无需指定模块
this.$store.commit('increment')
this.$store.commit('decrement')
//-------------其他组件中使用模块中getters的时也是无需指定模块的
$store.getters.doubleCount

特别的,在模块中的getters可以传入三个参数state, getters, rootState,分别对应:

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

4.模块内部的 action

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

还是引用官方的案例:

const moduleA = {
  // ...
  actions: {
      //这里使用{ state, commit, rootState }来接收context中的三个对象
    incrementIfOddOnRootSum ({ state, commit, rootState }) {
      if ((state.count + rootState.count) % 2 === 1) {
        commit('increment')
      }
    }
  }
}

//-------------其他组件中dispatch到modular中的actions
this.$store.dispatch

5.命名空间

默认情况下,模块内部的 action、mutation 和 getter 是注册在全局命名空间的,也意味这我们可以在全局命名空间中直接使用我们的 action、mutation 和 getter。

回顾一下前面的例子:

//-------------其他组件中commit mutations时无需指定模块
this.$store.commit('increment')
this.$store.commit('decrement')

//-------------其他组件中使用模块中getters的时也是无需指定模块的
$store.getters.doubleCount

//-------------其他组件中dispatch到modular中的actions
this.$store.dispatch

为什么我们能直接访问到模块内部的 action、mutation 和 getter,那是因为在默认情况下,vuex模块内部的 action、mutation 和 getter 是注册在全局命名空间的,注册在全局命名空间自然能直接通过store来访问了。

为了模块更高的封装性

如果希望你的模块具有更高的封装度和复用性,你可以通过添加 namespaced: true 的方式使其成为带命名空间的模块。

当模块被注册后,它的所有 getter、action 及 mutation 都会自动根据模块注册的路径调整命名。

这里还是引用官方的例子:

const store = new Vuex.Store({
  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']
          }
        }
      }
    }
  }
})

官方的例子已经很明确了,如果还是不理解,我下面列出了上面例子的整个命名空间下的getters,actions,mutations(括号中是注册的):

store (空)

store/account

store/account/posts

解析:

​ 全局命名空间(store)中只定义了modules,所以为空,而模块account使用了namespaced声明了命名空间,所以有命名空间store/account 。

​ 而模块account中的myPage模块没有使用namespaced声明了命名空间,所以myPage模块的getters的profile会注册在上一层的命名空间,也就是store/account命名空间中。

​ 而模块account中的posts模块,使用了namespaced声明了命名空间,使用有命名空间store/account/posts,也正因如此posts模块的getters,actions,mutations被注册到自己的命名空间下。

使用:

commit('xxx')       //没多级路径的,是访问全局命名空间,也就是store中的
getters['account/isAdmin']    //访问命名空间account下
dispatch('account/login')
commit('account/login')
getters['account/profile']
getters['account/posts/popular']      //访问命名空间account/posts

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持。

加载全部内容

相关教程
猜你喜欢
用户评论