用途:在 Umbraco 后台(backoffice)界面中实现菜单扩展。菜单是扩展组件,可出现在侧边栏和按钮弹出层中,作为导航与操作分组的容器;菜单项单独配置,可加入已有菜单或自定义菜单。
主要能力:创建自定义菜单容器与菜单项;向 Umbraco 内置菜单添加条目;用 weight 控制排序(值越大越靠后);用 kind 指定菜单项类型(如 link)。常见内置菜单别名包括 Umb.Menu.Help(页头帮助菜单)、Umb.Menu.Content、Umb.Menu.Media、Umb.Menu.Settings。
使用方式:先通过 WebFetch 获取官方最新文档再实现,顺序为菜单文档、菜单项文档、教程(扩展帮助菜单)、Foundation、Extension Registry。随后确认需求:新菜单还是扩展现有菜单、包含哪些条目、显示在何处。再生成菜单与菜单项的 manifest 文件,最后说明创建内容与测试方式。自定义菜单可在 umbraco-package.json 中声明 type、alias、name;菜单项可用 manifest.ts 导出 manifests 数组,包含 type、kind、alias、name、weight 与 meta(menus、label、icon、href)。也可从 @umbraco-cms/backoffice/help 导入 UMB_HELP_MENU_ALIAS 等常量。
关键属性:type 为 menu(容器)或 menuItem;alias 唯一标识;menus 为该条目所属菜单别名的数组;weight 控制顺序;kind 为菜单项类型。
限制:本身未提供收费、价格、平台或效果信息;实现前应以官方最新文档为准。