用途:在 Umbraco 后台(backoffice)中配置和呈现对话框与侧边栏。模态框是带焦点锁定的弹出层,会压暗周围区域。
主要能力:模态框可通过路由打开以支持深链,也可在运行时通过 Modal Manager Context 打开;使用基于 token 的类型安全通信机制。模态类型包括 Dialog(屏幕居中)和 Sidebar(从右侧滑入)。
使用方式:实现前先获取最新官方文档(主文档、Custom Modals、Route Registration、Foundation、Extension Registry 等链接)。工作流为:抓取文档、询问模态用途与数据流向、生成文件、说明如何打开。核心由三部分组成:Modal Token(用 UmbModalToken 定义数据类型与返回值)、Modal Element(继承 UmbLitElement 并实现 UmbModalExtensionElement,通过 modalContext.updateValue 与 submit 回传结果)、Manifest(type 为 modal,含 alias、name、element)。打开时通过 consumeContext 获取 UMB_MODAL_MANAGER_CONTEXT,调用 open 方法并传入 token 与 data。
参考示例:源码中 custom-modal 展示基础自定义模态框,modal-routed 展示路由深链模态框。相关基础技能包括 umbraco-context-api、umbraco-umbraco-element、umbraco-state-management。
限制:资料未提供具体版本要求、兼容性或收费信息;实现须以最新官方文档为准。