用途:为 Umbraco 后台提供全局上下文实现指导。全局上下文在整个后台会话期间持续存在,用于在扩展之间共享状态、管理集中式服务或协调通信,与工作区上下文等作用域上下文相对。文档建议优先使用更具体的作用域上下文,Umbraco 本身对全局上下文的使用较为克制。
主要能力与用法:实施前应先用 WebFetch 获取最新官方文档(主文档、Context API、Foundation、扩展注册表)。随后确认需共享的状态与所需服务,并判断能否改用工作区上下文。生成内容包括上下文令牌、上下文实现和清单:令牌基于 @umbraco-cms/backoffice/context-api 的 UmbContextToken;实现类继承 @umbraco-cms/backoffice/class-api 的 UmbContextBase 并传入主机与令牌;清单在 umbraco-package.json 中以 type "globalContext" 声明,包含 alias、name 与 js 路径。消费端通过 UmbElementMixin 与 consumeContext 获取实例。
适用场景:后台扩展间共享状态、集中式服务管理、扩展通信协调。
限制:仅面向 Umbraco 后台扩展开发;需遵循官方文档最新版本,具体 API 与配置细节以文档为准;本资料未提供收费、价格、平台与效果信息。