菜单设计器

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

此功能可在最多 10 个实体和角色的小项目中免费使用。在大项目中,需要快速开发版或企业版 订阅^

访问主菜单结构的一个简单方法是双击 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。