Дизайнер меню

При создании нового проекта структура его главного меню сохраняется в файл menu.xml. Studio предоставляет визуальный дизайнер для настройки главного меню.

Эта функция свободно доступна для использования в небольших проектах с количеством сущностей и ролей до 10. В более крупных проектах она требует RAD или Enterprise подписки подписку.

Простой способ получить доступ к структуре главного меню - использовать дерево в Окне инструментов Jmix.

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

Если вы решите сохранить унаследованные пункты меню, их структура будет скопирована в проект и их можно будет настраивать. Если позже вы решите переключить главное меню обратно в режим Composite, обратите внимание, что вам нужно будет вручную удалить все дублирующиеся меню и пункты из конфигурации проекта. В противном случае меню будет сломано, так как структура меню не допускает дублирования элементов.

Добавление пунктов меню

Чтобы добавить пункт меню, нажмите кнопку "плюс" в дизайнере. Откроется окно Create Menu Item.

menu create item

Возможно создать следующие типы пунктов меню:

  • View - пункт меню, открывающий экран приложения.

  • Menu - пункт меню, содержащий другие пункты. См. подробную информацию об атрибутах меню.

  • Bean - пункт меню, который вызывает метод управляемого бина.

  • Separator - горизонтальная линия, разделяющая пункты меню.

См. описания атрибутов пунктов типов View и Bean.

После создания пункта меню для открытия экрана можно настроить набор свойств для передачи публичным сеттерам экрана.