Angular 操作面板 | ng-hub-ui-action-sheet
由服务打开的 Angular 操作面板:带角色的操作、平铺或分组、可拒绝关闭的处理函数,以及通过背景、键盘或拖动关闭。
API 参考
这里是 action-sheet 的完整契约:你可以绑定、监听、投影和设置主题的一切,都集中在一处。接入你需要的部分,自定义你想要的样式——它是 standalone 的,且对 signal 友好。
输入
通过 10 个输入项精细调校 action-sheet。像绑定任意 Angular @Input 一样绑定它们。
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
buttons必填 | (HubActionSheetButton | HubActionSheetGroup)[] | — | 操作项,平铺或分组带标题。 |
header | string | — | 面板标题,同时作为无障碍名称。 |
subHeader | string | — | 标题下方的次要文字。 |
variant | string | — | 语义强调色,读作 --hub-sys-color-<variant>。 |
backdropDismiss | boolean | true | 点击背景关闭面板。 |
keyboard | boolean | true | Escape 关闭面板。 |
swipeToClose | boolean | true | 向下拖动超过阈值即关闭。 |
animation | boolean | true | 为进入与退出添加动画。在 prefers-reduced-motion 下忽略。 |
panelClass | string | string[] | — | 面板元素上的附加类,用于只定制某一个面板。 |
ariaLabel | string | — | 没有标题时的无障碍名称。 |
输出
尚未记录任何输出项。
方法
通过代码驱动 action-sheet——其编程接口提供 5 个方法。
| 名称 | 签名 | 返回值 | 描述 |
|---|---|---|---|
HubActionSheet.open | open<D>(options: HubActionSheetOptions<D>): HubActionSheetRef<D> | — | 把面板挂载到文档,并返回其结果的句柄。 |
HubActionSheetRef.result | result: Promise<HubActionSheetResult<D>> | — | 只解决一次:所选操作的角色与数据,或面板被关闭的方式。 |
HubActionSheetRef.closed$ | closed$: Observable<HubActionSheetResult<D>> | — | 与 result 相同的值,供使用流的调用方。 |
HubActionSheetRef.dismiss | dismiss(role?: 'backdrop' | 'escape' | 'swipe' | string): void | — | 从外部关闭面板,并报告给定角色。 |
provideHubActionSheet | provideHubActionSheet(config: Partial<HubActionSheetConfig>): EnvironmentProviders | — | 设置每个面板出发时的应用级默认值。 |
模板
尚未记录任何模板。