用途:该技能用于在 Umbraco 后台实现预览应用提供程序(Preview App Provider)。它向 Umbraco 的预览窗口菜单添加自定义条目,当内容编辑者预览内容时,这些应用会出现在预览菜单中,可提供设备模拟、无障碍检查、SEO 分析等与预览相关的附加功能。
主要能力:可注册类型为 previewApp 的扩展清单,并实现自定义元素作为预览菜单项 UI;文档中给出设备模拟器示例,通过按钮切换设备宽度并派发 preview-resize 自定义事件来调整预览。
使用方式:实现前应先用 WebFetch 获取最新官方文档,包括 Foundation、Extension Registry 和 Umbraco Element 相关页面;向用户确认需要什么预览功能和 UI;然后根据最新文档生成清单文件(manifests.ts)与元素实现文件;最后说明创建内容及如何测试。清单使用 ManifestPreviewAppProvider 类型,元素需继承 Umbriaco 的 UmbLitElement,并默认导出元素类。相关基础技能包括 umbraco-umbraco-element(UI 组件基类)和 umbraco-context-api(访问预览状态)。
最佳实践:UI 应保持紧凑以适配菜单显示;提供清晰的启用/禁用状态;考虑预览上下文和可用的 iframe;使用合适的图标便于识别。
限制:资料未提供安装命令、收费信息、支持的 Umbraco 版本范围以及具体 API 的完整参数说明;实现需以官方最新文档为准。