用途:在 Umbraco 后台(backoffice)的集合工具栏中添加按钮,对集合整体执行操作,例如“新建”或导出。它不处理单个条目,针对单个条目的操作属于 Entity Bulk Actions。
主要能力:操作可执行代码,或通过 getHref() 返回 URL 进行导航;可通过模态框管理器打开对话框;meta 支持 label(按钮文本,必填)、href(静态 URL)、additionalOptions(为 true 时显示下拉指示,配合 hasAdditionalOptions())。用 conditions 控制显示时机,常用集合别名有 Umb.Collection.Document、Umb.Collection.Media、Umb.Collection.Member、Umb.Collection.User、Umb.Collection.DataType。
使用方式:先获取官方文档,再创建 manifest 与操作类。manifest 类型为 collectionAction,包含 alias、name、api 动态导入、meta 和 conditions;操作类继承 UmbCollectionActionBase,实现 execute(),链接式操作实现 getHref()。相关技能可参考 umbraco-context-api、umbraco-modals、umbraco-conditions。
适用场景:需要为集合添加工具栏级动作、导航入口或弹窗交互的后台扩展。
限制:资料仅提供文档链接与示例,未说明版本要求、构建配置与测试方式;实现前应获取最新官方文档。