码迷,mamicode.com
首页 > Windows程序 > 详细

API~vuex

时间:2018-04-09 00:15:23      阅读:269      评论:0      收藏:0      [点我收藏+]

标签:console   back   订阅   boolean   错误   option   state   commit   完成后   

Vuex.Store

import Vuex from ‘vuex‘

const store = new Vuex.Store({ ...options })

Vuex.Store 构造器选项

state

类型: Object | Function

Vuex store 实例的根 state 对象。详细介绍

如果你传入返回一个对象的函数,其返回的对象会被用作根 state。这在你想要重用 state 对象,尤其是对于重用 module 来说非常有用。详细介绍

mutations

类型: { [type: string]: Function }

在 store 上注册 mutation,处理函数总是接受 state 作为第一个参数(如果定义在模块中,则为模块的局部状态),payload 作为第二个参数(可选)。

详细介绍

actions

类型: { [type: string]: Function }

在 store 上注册 action。处理函数总是接受 context 作为第一个参数,payload 作为第二个参数(可选)。

context 对象包含以下属性:

{
  state,      // 等同于 `store.state`,若在模块中则为局部状态
  rootState,  // 等同于 `store.state`,只存在于模块中
  commit,     // 等同于 `store.commit`
  dispatch,   // 等同于 `store.dispatch`
  getters,    // 等同于 `store.getters`
  rootGetters // 等同于 `store.getters`,只存在于模块中
}

同时如果有第二个参数 payload 的话也能够接收。

详细介绍

getters

类型: { [key: string]: Function }
在 store 上注册 getter,getter 方法接受以下参数:

  state,     // 如果在模块中定义则为模块的局部状态
  getters,   // 等同于 store.getters

当定义在一个模块里时会特别一些:

  state,       // 如果在模块中定义则为模块的局部状态
  getters,     // 等同于 store.getters
  rootState    // 等同于 store.state
  rootGetters  // 所有 getters

注册的 getter 暴露为 store.getters。

详细介绍

modules

类型: Object

包含了子模块的对象,会被合并到 store,大概长这样:

{
  key: {
    state,
    namespaced?,
    mutations,
    actions?,
    getters?,
    modules?
  },
  ...
}

与根模块的选项一样,每个模块也包含 state 和 mutations 选项。模块的状态使用 key 关联到 store 的根状态。模块的 mutation 和 getter 只会接收 module 的局部状态作为第一个参数,而不是根状态,并且模块 action 的 context.state 同样指向局部状态。

详细介绍

plugins

类型: Array

一个数组,包含应用在 store 上的插件方法。这些插件直接接收 store 作为唯一参数,可以监听 mutation(用于外部地数据持久化、记录或调试)或者提交 mutation (用于内部数据,例如 websocket 或 某些观察者)

详细介绍

strict

类型: Boolean
默认值: false

使 Vuex store 进入严格模式,在严格模式下,任何 mutation 处理函数以外修改 Vuex state 都会抛出错误。

详细介绍

Vuex.Store 实例属性

state

类型: Object

根状态,只读。

getters

类型: Object

暴露出注册的 getter,只读。

Vuex.Store 实例方法

commit(type: string, payload?: any, options?: Object)

commit(mutation: Object, options?: Object)

提交 mutation。options 里可以有 root: true,它允许在命名空间模块里提交根的 mutation。详细介绍

dispatch(type: string, payload?: any, options?: Object)

dispatch(action: Object, options?: Object)

分发 action。options 里可以有 root: true,它允许在命名空间模块里分发根的 action。返回一个解析所有被触发的 action 处理器的 Promise。详细介绍

replaceState(state: Object)

替换 store 的根状态,仅用状态合并或时光旅行调试。

watch(fn: Function, callback: Function, options?: Object): Function

响应式地侦听 fn 的返回值,当值改变时调用回调函数。fn 接收 store 的 state 作为第一个参数,其 getter 作为第二个参数。最后接收一个可选的对象参数表示 Vue 的 vm.$watch 方法的参数。

要停止侦听,调用此方法返回的函数即可停止侦听。

subscribe(handler: Function): Function

订阅 store 的 mutation。handler 会在每个 mutation 完成后调用,接收 mutation 和经过 mutation 后的状态作为参数:

store.subscribe((mutation, state) => {
  console.log(mutation.type)
  console.log(mutation.payload)
})

要停止订阅,调用此方法返回的函数即可停止订阅。

通常用于插件。详细介绍

subscribeAction(handler: Function): Function

2.5.0 新增

订阅 store 的 action。handler 会在每个 action 分发的时候调用并接收 action 描述和当前的 store 的 state 这两个参数:

store.subscribeAction((action, state) => {
  console.log(action.type)
  console.log(action.payload)
})

要停止订阅,调用此方法返回的函数即可停止订阅。

该功能常用于插件。详细介绍

registerModule(path: string | Array

注册一个动态模块。详细介绍

options 可以包含 preserveState: true 以允许保留之前的 state。用于服务端渲染。

unregisterModule(path: string | Array

卸载一个动态模块。详细介绍

hotUpdate(newOptions: Object)

热替换新的 action 和 mutation。详细介绍

组件绑定的辅助函数

mapState(namespace?: string, map: Array

为组件创建计算属性以返回 Vuex store 中的状态。详细介绍

第一个参数是可选的,可以是一个命名空间字符串。详细介绍

mapGetters(namespace?: string, map: Array

为组件创建计算属性以返回 getter 的返回值。详细介绍

第一个参数是可选的,可以是一个命名空间字符串。详细介绍

mapActions(namespace?: string, map: Array

创建组件方法分发 action。详细介绍

第一个参数是可选的,可以是一个命名空间字符串。详细介绍

mapMutations(namespace?: string, map: Array

创建组件方法提交 mutation。详细介绍

第一个参数是可选的,可以是一个命名空间字符串。详细介绍

createNamespacedHelpers(namespace: string): Object

创建基于命名空间的组件绑定辅助函数。其返回一个包含 mapState、mapGetters、mapActions 和 mapMutations 的对象。它们都已经绑定在了给定的命名空间上。详细介绍

API~vuex

标签:console   back   订阅   boolean   错误   option   state   commit   完成后   

原文地址:https://www.cnblogs.com/qq3279338858/p/8747902.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!