From d21f6a166ed20034f5d23a7f7eb510fb1354969e Mon Sep 17 00:00:00 2001
From: wangyaqi <wangyaqi988@163.com>
Date: Thu, 20 May 2021 21:18:24 +0800
Subject: [PATCH] docs: global api

---
 docs/api/_sidebar.md |  1 +
 docs/api/global.md   | 57 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 docs/api/global.md

diff --git a/docs/api/_sidebar.md b/docs/api/_sidebar.md
index a7e042cc7..a40196e45 100644
--- a/docs/api/_sidebar.md
+++ b/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)
diff --git a/docs/api/global.md b/docs/api/global.md
new file mode 100644
index 000000000..af8160e68
--- /dev/null
+++ b/docs/api/global.md
@@ -0,0 +1,57 @@
+## 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
-- 
GitLab