用途:该技能用于在 Umbraco 后台(backoffice)中实现自定义搜索结果项,控制搜索结果列表中单条结果的视觉呈现,例如为特定实体类型显示附加信息、自定义图标、徽章等元素。
主要能力:可创建 searchResultItem 类型的扩展清单与自定义元素;通过 forEntityTypes 指定生效的实体类型;支持基于 UmbSearchResultItemModel 渲染名称、图标、链接等;支持扩展数据字段(如 description、status、updatedDate);还支持 pickerSearchResultItem 类型以自定义内容/媒体选择器的搜索结果。模型属性包括 entityType、unique、name、icon、href。
使用方式:实现前应先获取最新文档(Extension Types、Foundation、Extension Registry 链接)。工作流为:使用 WebFetch 拉取文档、确认实体类型与需展示的信息、依据最新文档生成 manifest 与 element 文件、说明创建内容及测试方式。manifest 使用 type、alias、name、element、forEntityTypes 字段;元素基于 @umbraco-cms/backoffice/external/lit、@umbraco-cms/backoffice/lit-element 与 @umbraco-cms/backoffice/search 实现。
适用场景:需要为特定实体类型定制后台搜索结果外观、在结果中展示额外元数据、或统一选择器搜索结果样式时适用。
限制:资料未提供收费、价格、平台要求等信息;属性与 API 以官方最新文档为准,实现前须重新获取文档,不可依赖固定版本。示例代码仅为最小参考,不应视为完整实现。