docs: global api

docs/api/_sidebar.md

@@ -6,6 +6,7 @@
   * [生命周期](api/lifecycle.md)
   * [应用级事件](api/application.md)
   * [拦截器](api/interceptor.md)
+  * [全局API](api/global.md)
 * 网络
   * [发起请求](api/request/request.md)
   * [上传、下载](api/request/network-file.md)

docs/api/global.md

+## uniIDHasRole
+
+新增于`HBuilderX 3.1.15-alpha`，判断当前用户是否拥有某角色。
+
+> 需要在token内缓存角色权限才可使用，请参考：[缓存角色权限](https://uniapp.dcloud.net.cn/uniCloud/uni-id?id=cachepermissionintoken)
+
+**在模板内使用**
+
+```html
+<template>
+  <view v-if="uniIDHasRole('admin')">仅管理员可见</view>
+</template>
+```
+
+**在页面/组件js代码中使用**
+
+```html
+<template>
+  <view>xxx</view>
+</template>
+<script>
+  export default {
+    onLoad(){
+      console.log('当前用户是否拥有管理员角色：', this.uniIDHasRole('admin'))
+    }
+  }
+</script>
+```
+
+## uniIDHasPermission
+
+新增于`HBuilderX 3.1.15-alpha`，判断当前用户是否拥有某权限，注意：admin角色的用户拥有所有权限
+
+> 需要在token内缓存角色权限才可使用，请参考：[缓存角色权限](https://uniapp.dcloud.net.cn/uniCloud/uni-id?id=cachepermissionintoken)
+
+**在模板内使用**
+
+```html
+<template>
+  <view v-if="uniIDHasPermission('edit')">拥有编辑权限时可见</view>
+</template>
+```
+
+**在页面/组件js代码中使用**
+
+```html
+<template>
+  <view>xxx</view>
+</template>
+<script>
+  export default {
+    onLoad(){
+      console.log('当前用户是否拥有编辑权限：', this.uniIDHasPermission('edit'))
+    }
+  }
+</script>
+```
\ No newline at end of file