---
order: 1
title: 使用指令
type: Documents
---

### 1. 基于权限的控制
```html

<!-- 四种控制逻辑 -->
<div *ac="['app.view', 'app.edit']">同时拥有 ['app.view', 'app.edit'] 权限时可见</div>
<div *acAny="['app.view', 'app.edit']">拥有 ['app.view', 'app.edit'] 中任意一个权限时可见</div>
<div *ace="['app.view', 'app.edit']">同时 ['app.view', 'app.edit'] 权限都缺失时可见</div>
<div *aceAny="['app.view', 'app.edit']">缺失 ['app.view', 'app.edit'] 中任意一个权限时可见</div>

<!-- 支持字符串 -->
<div *ac="'app.view'">必须拥有 app.view 权限时可见</div>
```


### 2. 基于角色控制
跟基于权限的控制逻辑一样，除了需要使用 `isRole` 参数标记

```html
<ng-template [ac]="['superadmin']" [isRole]="true">
  <div>必须是超级管理员角色时可见</div>
</ng-template>
```

### API
| 指令名称 | 描述 | 类型 | 默认值 |
| ------- | --- | --- | ----- |
| `ac`       | 拥有所有    | `string | string[]` | - |
| `acAny`    | 拥有任意一个    | `string | string[]` | - |
| `ace`      | 所有都缺失    | `string | string[]` | - |
| `aceAny`   | 缺失任意一个    | `string | string[]` | - |
| `isRole`   | 使用角色进行控制 | `boolean`       | `false`