>(AbilityServiceSignal);
abilityService.update([
{ action: 'create', subject: 'Post', reason: 'You can create posts' },
{
inverted: true,
action: 'delete',
subject: 'Post',
reason: 'Only administrators can delete posts'
}
]);
abilityService.whyCan('create', 'Post'); // { reason: 'You can create posts' }
abilityService.whyCan('delete', 'Post'); // null
abilityService.whyCannot('delete', 'Post'); // { reason: 'Only administrators can delete posts' }
abilityService.whyCan('update', 'Post'); // null
abilityService.whyCannot('update', 'Post'); // { reason: undefined }
abilityService.whyCannot('create', 'Post'); // null
```
将这些方法显示为模板,与 `can` 像这样使用它们:
```html
@if (whyCannot('delete', 'Post'); as forbidden) {
{{ forbidden.reason || 'You cannot delete posts' }}
} @else {
}
```
无故匹配倒置规则返回对象 `reason: undefined` 当方法的条件得到满足时。 即便没有任何解释,这仍然使否认真相.
### 创建权限信号 `defer*` 方法
这个 `defer*` 方法返回计算出的信号。 每个参数(动作,主题,或可选字段)都可以是一个平面值或信号. 返回的信号在能力规则或任何信号参数发生变化时会重新计算.
一次创建这些信号, 例如在组件字段初始化器中, 在模板中读取 :
```ts
import { Component, inject, input } from '@angular/core';
import { AbilityServiceSignal } from '@casl/angular';
import type { AppAbility } from './AppAbility';
@Component({
selector: 'post-action',
template: `
@if (whyCannotPerformAction(); as forbidden) {
{{ forbidden.reason || 'This action is forbidden' }}
} @else {
}
`
})
export class PostActionComponent {
private readonly abilityService = inject>(AbilityServiceSignal);
readonly action = input.required<'create' | 'delete'>();
protected readonly whyCannotPerformAction = this.abilityService.deferWhyCannot(this.action, 'Post');
}
```
例如,由父母提供动作 ``。当输入更改时,权限信号更新.
传递信号本身( P)`this.action`跟踪其变化。 传递其当前值( E)`this.action()`将这一参数固定在创建延迟检查时的数值上。 这个 `deferWhy*` 方法保存 `null` 和缺失的理由行为 `why*` 方法; 使用 `deferCan` 或者说 `deferCannot` 您只需检查布尔权限即可.
## 使用管道检查模板中的权限( 已过期)
检查您可以使用的任何模板的权限 `AblePipe`数字 :
```html
@if ('create' | able: 'Post') {
Add Post
}
```
## 类型脚本支持
这个软件包是用 TypeScript 写的, 这样可以警告您使用错误 .
在Angular app中使用应用程序特定能力可能有点乏味,因为你到处注射 `Ability` 您需要导入其通用参数:
```ts
import { Ability } from '@casl/ability';
import { Component } from '@angular/core';
import { AppAbilities } from '../services/AppAbility';
@Component({
selector: 'todo-item'
})
export class TodoItem {
constructor(
private ability: Ability
) {}
}
```
为了让生活变得容易,你可以使用 `AbilityClass` 类以使用伴星对象模式:
```ts
import { Ability, AbilityClass } from '@casl/ability';
type Actions = 'create' | 'read' | 'update' | 'delete';
type Subjects = 'Article' | 'User';
export type AppAbility = MongoAbility<[Actions, Subjects]>;
export const AppAbility = Ability as AbilityClass;
```
使用 `AppAbility` 在你的应用程序中 :
```ts
import { NgModule } from '@angular/core';
import { AppAbility } from './services/AppAbility';
@NgModule({
// other configuration
providers: [
{ provide: AppAbility, useValue: createMongoAbility() },
]
})
export class AppModule {}
```
## 想帮忙吗?
想要提交错误, 提供一些代码, 还是改进文档 ? 不错! 阅读指南 [捐款](https://github.com/stalniy/casl/blob/main/CONTRIBUTING.md)。 。 。 .
如果你想帮助我们 维持我们的社区和项目,考虑 [成为开放集体的出资人](https://opencollective.com/casljs/contribute)
> 见 [支助CASL](https://casl.js.org/v7/en/support-casljs) 详情
## 许可证
[MIT 许可证](http://www.opensource.org/licenses/MIT)
## 常见问题
### @casl/angular 是什么？
CASL 的角模块, 这使得在任意角应用程序中添加权限变得容易
### 如何安装 @casl/angular？
在项目目录运行 npm install @casl/angular，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：rxjs（^7\.5\.5）、tslib（^2\.0\.0）、@angular/core（^16\.0\.0 \|\| ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0 \|\| ^20\.0\.0 \|\| ^21\.0\.0 \|\| ^22\.0\.0）、@casl/ability（^7\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
### @casl/angular 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @casl/angular 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。
### @casl/angular 可以商用吗？
@casl/angular 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @casl/angular 的下载量有多少？
根据 npm 官方下载统计，@casl/angular 在 2026/10/09 – 2026/11/07 这 30 天内被下载 66,803 次，日均约 2,227 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @casl/angular 还在维护吗？
最新版本 10\.2\.0 发布于 2026/10/30（10 天前）；至今共发布 68 个版本，其中过去 12 个月发布了 8 个；首次发布于 2018/03/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。