MenuConfig

id - уникальный идентификатор элемента.

caption - заголовок элемента меню. Если он не задан, заголовок будет определяться в соответствии с правилом, описанным ниже.

description - текст, отображаемый в виде всплывающей подсказки при наведении курсора мыши. Вы можете использовать локализованные сообщения из пакета сообщений.

icon - значок элемента menu. Подробнее см. в разделе Значки.

insertBefore, insertAfter - определяют, должен ли элемент быть вставлен до или после определенного элемента или пункта меню с указанным идентификатором. Эти атрибуты используются для вставки элемента в соответствующее место в меню, определенном в файлах дополнений. Не используйте атрибуты insertBefore и insertAfter одновременно.

stylename - определяет название стиля для пункта меню. Подробнее см. в разделе Темы.

expanded - определяет, должен ли элемент menu быть развернут при открытии главного экрана. Значение по умолчанию - false.

id - уникальный идентификатор элемента. Если атрибуты screen, bean, class не определены, id используется для указания на экран с тем же id. Когда пользователь нажимает на пункт меню, на главном экране открывается соответствующий экран.

<item id="User.browse"/>

caption - заголовок элемента item. Если значение не задано, заголовок будет определяться в соответствии с правилом, описанным ниже.

<item screen="sample_CustomerScreen"
      caption="msg://ui.ex2.screen.customer/customerScreen.caption"/>

description - текст, который отображается в виде всплывающей подсказки при наведении курсора мыши. Вы также можете использовать локализованные сообщения из пакета сообщений.

screen - идентификатор экрана. Его можно использовать для многократного включения одного экрана в меню. Когда пользователь нажимает на пункт меню, на главном экране открывается соответствующий экран.

<item screen="sample_City.browse" id="cities"/>
<item screen="sample_City.browse" id="cities2"/>

bean - имя бина. Должен использоваться вместе с beanMethod. Метод бина вызывается, когда пользователь нажимает на пункт меню.

<item bean="sample_MenuBean"
      beanMethod="showCityBrowse"
      caption="Show Cities"/>

@Component("sample_MenuBean")
public class MenuBean {
    @Autowired
    private ScreenBuilders screenBuilders;

    public void showCityBrowse(){
        final Screen frameOwner = AppUI.getCurrent()
                .getTopLevelWindowNN().getFrameOwner();
        screenBuilders.screen(frameOwner)
                .withScreenClass(CityBrowse.class)
                .build()
                .show();
    }
}

<item bean="sample_MenuBean" beanMethod="openLink"
      id="openBeanWithParams" caption="OpenBeanWithParams">
    <properties>
        <property name="url" value="https://jmix.io"/>
    </properties>
</item>

@Component("sample_MenuBean")
public class MenuBean {

    @Autowired
    private ObjectProvider<WebBrowserTools> webBrowserToolsProvider;

    public void openLink(Map<String, Object> parameters) {
        String url = (String) parameters.get("url");
        if (url == null) {
            return;
        }

        webBrowserToolsProvider.getObject().showWebPage(
                url, ParamsMap.of("target", "_blank"));
    }
}

class - полное имя класса, который реализует интерфейс MenuItemRunnable. Когда пользователь нажимает на пункт меню, создается экземпляр указанного класса и вызывается его метод.

<item class="ui.ex2.app.CustomMenu" id="jmix" caption="Open page"/>

public class CustomMenu implements MenuItemRunnable, ApplicationContextAware {

    private ApplicationContext applicationContext;

    public void openLink(String url) {
        applicationContext.getBean(WebBrowserTools.class)
                .showWebPage(url, ParamsMap.of("target", "_blank"));
    }

    @Override
    public void run(FrameOwner origin, MenuItem menuItem) {
        if (menuItem.getId().equals("jmix")) {
            openLink("https://jmix.io");
        } else {
            openLink("https://google.com");
        }
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext)
            throws BeansException {
        this.applicationContext = applicationContext;
    }
}

shortcut - сочетание клавиш для данного пункта меню. Возможные модификаторы - ALT, CTRL, SHIFT - разделяются знаком “-”. Например:

<item screen="sample_City.browse"
      id="cities3"
      shortcut="ALT-C"/>

<item screen="sample_City.browse"
      id="cities4"
      shortcut="${sample.menu.city}"/>

sample.menu.city=ALT-CTRL-C

Атрибут openMode определяет, как будет открываться экран. Он соответствует перечислению OpenMode со значениями: NEW_TAB, DIALOG, NEW_WINDOW. Значение по умолчанию - NEW_TAB.

<item screen="sample_City.browse"
      id="cities5"
      openMode="DIALOG"/>

icon - значок элемента item. Подробнее см. в Значки.

insertBefore, insertAfter - определяют, должен ли элемент быть вставлен до или после определенного элемента или пункта меню с указанным идентификатором.

resizable - относится только к режиму открытия окна DIALOG. Управляет возможностью изменения размера окна. Возможные значения − true, false. По умолчанию главное меню не влияет на возможность изменять размер диалоговых окон.

stylename - определяет название стиля для пункта меню. Подробнее см. в Темы.

name - название свойства.

value - значение property для свойств, не являющихся сущностями.

entityClass - класс свойства сущности.

entityId - идентификатор свойства сущности.

entityFetchPlan - необязательный фетч-план для загрузки свойства сущности.