Document_zh

Vuez入门

Vuez是一个简单但强大的Vue.js项目状态管理库。

Vuez目前正在开发的初始阶段，以下文档会随着代码版本更新而及时更新。任何关于Vuez的改进意见和建议，欢迎提交Issue，PR，或者直接邮件跟我联系。非常感谢：）

安装

您可以在您的项目中，使用npm或者yarn安装Vuez。

npm install vuez --save

或者

yarn add vuez

在您的项目里，需要显式地调用用Vue.use()来安装Vuez，如下:

import Vue from 'vue'
import Vuez from 'vuez'

Vue.use(Vuez)

基本用法

简短地说，Vuez是一个在整个Vue项目中全局可访问的，集中监控整个项目中的"被观察对象"的一个中心"store"。在您的组件里，可以使用this.$store来访问这个中心"store"对象。

这个"store"的概念非常简单，您只需要对要监控的对象起一个字符串name作为监控的标志，用observe声明这个对象和这个标志的联系，然后关于标志声明一个或者多个action表示当这个对象变化时要做的事情，之后每次调用observe，如果对象值发生了改变，这些action就会自动触发。

Vuez只有observe/unobserve和action两个API，

1. observe/unobserve

   • store.observe(name, observing_object), 接受两个参数，监控标志和监控对象。初次调用时，Vuez会建立起关于这个标志的监控，之后每次调用，当且仅当这个标志对应的对象值发生了改变时，和这个监控标志相关的所有action会自动触发。

   • store.unobserve(name) 用来取消关于某个标志的监控。

2. action
   • store.action(name, action_function), 接受两个参数，监控标志和行动函数。行动函数的参数是这个对象的当前值。之后满足条件时，调用observe就会触发该函数。

在您的项目里使用这两个API，即可建立起整个项目内的一个事件监控集合，用来处理包括组件之间的沟通，监控数据变化，处理异步请求等等的场景需求

在一个Vue项目中使用Vuez的完整例子

关于使用Vuez的一个完整的Vue项目的例子，请参考Todo List。