用途:该技能介绍 Umbraco 后台(backoffice)中的通知机制,属于基础概念。通知通过 UMB_NOTIFICATION_CONTEXT 提供用户反馈,需借助 Context API 消费,调用 peek() 方法显示临时 toast 式提示,提示会自动消失,适合操作确认与错误信息。
主要能力:支持三种通知类型——positive(成功,绿色)、danger(错误,红色)、warning(警告,橙/黄色)。通知数据包含可选的 headline(加粗标题)和必填的 message(正文)。可在 Lit 元素、控制器(UmbControllerBase)、菜单动作处理器(UmbMenuItemAction)以及异步操作、表单校验等场景中使用。
使用方式:在元素中通过 consumeContext(UMB_NOTIFICATION_CONTEXT, callback) 订阅上下文;在控制器或动作处理器中通过 await this.getContext(UMB_NOTIFICATION_CONTEXT) 一次性获取。随后调用 context?.peek('positive', { data: { message: '...' } }),可附带 headline。实现前应先用 WebFetch 获取官方最新文档:Context API、Consume Context、Foundation 三个链接。
适用场景:保存确认、错误提示、校验警告、动作反馈、操作状态展示。
限制:资料未提供收费、价格、平台支持范围等信息;通知为临时自动消失,未说明可配置持续时间或持久化方式。实现时应始终获取最新文档并保持示例最小化。