docs: 文档更新(二)

Author: Littly

Diff for: docs/apis/about/desc.md

@@ -0,0 +1,26 @@
+---
+title: API 说明
+---
+
+Taro 的 API 包括 Taro 内置提供的 API 以及对小程序的端能力 API 的封装。
+
+其中对小程序的端能力 API 的封装，主要会基于微信小程序的 API 规范，对于其他小程序类似的 API，会在 Taro 中适配为小程序 API 的规范格式，并且都挂载在 `Taro` 命名空间下。
+
+例如，支付宝小程序中，`my.alert` 用于弹出一个警告的模态框，而微信小程序中没有这一 API，与之类似的有 `wx.showModal`，所以在 Taro 中会将支付宝的 `my.alert` 统一为 `Taro.showModal`，从而减少一些跨平台兼容代码的书写。
+
+而对于微信小程序中没有，而某些小程序平台特有的 API，可以先尝试用 `Taro.` + API 名称来进行调用，如果出现未定义，则使用对应小程序平台的命名空间（如 `my`、`swan`、`tt` 等）来进行调用，并反馈给我们。
+
+当然，由于各个小程序平台的迭代非常快速，Taro 要不断跟进小程序的更新，有时候难免有些 API 没有加入 Taro 适配，你可以通过提 PR 或者 issue，来获得帮助。
+
+同时，为了方便代码书写，Taro 默认对小程序的异步 API 进行了 `promisify` 化，你可以像使用 Promise 那样进行调用，例如
+
+```js
+import Taro from '@tarojs/taro'
+
+Taro.request(url).then(function (res) {
+  console.log(res)
+})
+```
+
+
+

Diff for: docs/apis/about/env.md

@@ -0,0 +1,21 @@
+---
+title: 环境判断
+---
+
+## Taro.ENV_TYPE
+
+`ENV_TYPE.WEAPP` 微信小程序环境
+
+`ENV_TYPE.SWAN` 百度小程序环境
+
+`ENV_TYPE.ALIPAY` 支付宝小程序环境
+
+`ENV_TYPE.TT` 字节跳动小程序环境
+
+`ENV_TYPE.WEB` WEB(H5)环境
+
+`ENV_TYPE.RN` ReactNative 环境
+
+## Taro.getEnv()
+
+获取当前环境值，具体值如上 `Taro.ENV_TYPE`

Diff for: docs/apis/about/events.md

@@ -0,0 +1,46 @@
+---
+title: 消息机制
+---
+
+Taro 提供了 `Taro.Events` 来实现消息机制，使用时需要实例化它，如下
+
+```jsx
+import Taro, { Events } from '@tarojs/taro'
+
+const events = new Events()
+
+// 监听一个事件，接受参数
+events.on('eventName', (arg) => {
+  // doSth
+})
+
+// 监听同个事件，同时绑定多个 handler
+events.on('eventName', handler1)
+events.on('eventName', handler2)
+events.on('eventName', handler3)
+
+// 触发一个事件，传参
+events.trigger('eventName', arg)
+
+// 触发事件，传入多个参数
+events.trigger('eventName', arg1, arg2, ...)
+
+// 取消监听一个事件
+events.off('eventName')
+
+// 取消监听一个事件某个 handler
+events.off('eventName', handler1)
+
+// 取消监听所有事件
+events.off()
+```
+
+同时 Taro 还提供了一个全局消息中心 `Taro.eventCenter` 以供使用，它是 `Taro.Events` 的实例
+
+```jsx
+import Taro from '@tarojs/taro'
+
+Taro.eventCenter.on
+Taro.eventCenter.trigger
+Taro.eventCenter.off
+```