DEV Community
·
在 Umbraco 14 中为树添加实体操作
内容提要
文章介绍了在Umbraco 14中通过侧边栏上下文菜单为树添加操作。通过创建ManifestEntityAction清单并指定forEntityTypes属性，可以自动渲染菜单按钮。操作逻辑在API类中实现，并通过事件通知其他组件更新树结构。还讨论了如何处理操作结果和监听事件以重新渲染树项目。
关键要点
-
文章介绍了在Umbraco 14中通过侧边栏上下文菜单为树添加操作。
-
使用内置的实体操作自动渲染侧边栏上下文菜单中的按钮。
-
注册操作需要创建ManifestEntityAction清单，并指定forEntityTypes属性。
-
操作逻辑在API类中实现，通过重写execute方法来定义功能。
-
可以通过事件通知其他组件更新树结构，使用UmbRequestReloadStructureForEntityEvent事件。
-
操作完成后，树不会自动刷新，需要监听事件以重新渲染结构。
-
使用?showChildren属性可以在刷新后保持树项目的打开状态。
延伸解读
实体操作的注册与实现
在Umbraco 14中，注册实体操作需要创建ManifestEntityAction清单，并指定forEntityTypes属性。这一过程确保了操作与特定实体类型的关联，便于在侧边栏上下文菜单中自动渲染相应的按钮。开发者需注意，操作逻辑的实现依赖于API类中的execute方法，确保功能的正确执行。
事件监听与树结构更新
操作完成后，树结构不会自动刷新，开发者需要通过监听UmbRequestReloadStructureForEntityEvent事件来手动更新树。这一机制确保了用户在执行操作后，能够及时看到最新的树结构，提升了用户体验。使用?showChildren属性可以在刷新后保持树项目的打开状态，避免用户的操作被打断。
延伸问答
如何在Umbraco 14中为树添加操作？
可以通过创建ManifestEntityAction清单并指定forEntityTypes属性来为树添加操作。
ManifestEntityAction清单的作用是什么？
ManifestEntityAction清单用于注册操作并定义可用的实体类型。
如何实现操作逻辑？
操作逻辑在API类中实现，通过重写execute方法来定义功能。
操作完成后，如何更新树结构？
可以通过监听UmbRequestReloadStructureForEntityEvent事件来更新树结构。
如何保持树项目的打开状态？
使用?showChildren属性可以在刷新后保持树项目的打开状态。
在Umbraco 14中，如何处理操作结果？
操作结果可以通过监听事件并重新渲染树项目来处理。
