菜单设计器

新建项目时,主菜单的 结构 保存在 menu.xml 文件中。Studio 提供可视化设计器用于配置主菜单。

此功能需要快速开发版或企业版 订阅。如果没有订阅,请尝试 试用版

访问主菜单结构的一个简单方法是双击 Jmix 工具窗口Main Menu

menu open

Structure 标签页,可以查看并配置菜单,Text 标签页包含 XML 代码。

menu designer

在可视化设计器中,可以将树中的菜单项拖放至新的位置。

默认情况下,使用 Composite mode。这种模式下,会包含所有来自应用程序 menu.xml 中的菜单,以及所有扩展组件和继承自框架中的菜单。其中继承的菜单项不能编辑。

menu composite

当从 Composite mode 切换至 Single mode 时,Studio 会建议保留从框架和扩展组件继承的菜单项:

menu suggest

Single mode 中,Studio 可以添加项目中包含的扩展组件菜单。左侧的面板展示可用的组件菜单,拖拽到右侧即可添加到自定义菜单中。

menu single

如果决定保留继承的菜单项,则将复制其结构至你的项目中,然后可以自定义编辑。如果以后决定将主菜单切换回复合模式,注意,需要手动从项目配置中删除所有重复的菜单项。否则,由于菜单结构不允许重复的菜单项,会导致菜单出错。

添加菜单项

如需添加菜单项,点击设计器中的加号按钮打开 Create Menu Item 窗口。

menu create item

支持创建下列类型的菜单项:

  • View - 打开应用程序视图的菜单项。

  • Menu - 包含其他菜单项的菜单。菜单的属性详细信息请参阅 MenuConfig

  • Bean - 调用 bean 方法的菜单项。

  • Separator - 菜单项的水平分隔符。

关于使用视图、Bean 菜单项的更多信息,请参阅 MenuConfig菜单项属性 部分。

在打开视图的菜单项创建完成后,还支持配置一组 菜单属性 用于传递参数给视图的公共 setter。