SuperAPI AI 工具集

umbraco-controllers

通用与其它

查看项目

更新于 10-15 21:05

技能介绍

用途:介绍 Umbraco 后台(backoffice)中的控制器概念,帮助理解并创建控制器。控制器是独立类,用于在元素间包含或复用逻辑,同时保持与元素生命周期的连接。控制器被分配给宿主元素(Host Element),支持生命周期方法 hostConnected、hostDisconnected、destroy,用于管理副作用、定时器、订阅与清理。控制器还可承载其他控制器,实现功能组合与复用。

主要能力:扩展 UmbControllerBase 可自动注册与注销;支持生命周期回调;可通过 getContext() 与 consumeContext() 访问上下文;可组合嵌套控制器。典型用例包括管理订阅与清理、处理定时器与间隔、协调副作用、跨元素复用逻辑、管理 API 调用与数据获取。

使用方式:实现前应先获取最新文档(主文档、编写自定义控制器、Foundation 页面)。工作流为:获取文档、询问需求(是否需要自定义控制器、哪些生命周期事件、需要何种清理)、基于最新文档生成扩展 UmbControllerBase 的代码、解释创建内容及如何宿主。最小示例包括基础自定义控制器、定时器控制器、在元素中宿主控制器、手动注册(不推荐)、带上下文访问的控制器。

限制与注意:手动注册需自行调用 addUmbController 与 removeUmbController,不推荐。从控制器发起 API 调用时,切勿使用原始 fetch(),应使用配置了 Umbraco 认证上下文的生成式 OpenAPI 客户端,参见 umbraco-openapi-client 技能。具体版本要求、安装命令与收费信息暂未提供。