Sub-menu item

The sub-menu item is a menu item that opens a new menu screen when selected. It is used to create a hierarchical menu structure with multiple levels of navigation.

This can be useful for organizing menu items into categories or sub-menus, making it easier for users to navigate through the menu system.

A sub-menu item can be created using the following syntax:

You first need to define the sub-menu screen with the desired menu items:

MENU_SCREEN(subMenuScreen, subMenuItems,
    ITEM_BASIC("Sub-item 1"),
    ITEM_BASIC("Sub-item 2"),
    ITEM_BASIC("Sub-item 3"),
    ITEM_BASIC("Sub-item 4"));

Then you can create a sub-menu item entry that links to the sub-menu screen in the parent menu:

// ... More menu items
ITEM_SUBMENU("Sub-menu 1", subMenuScreen)
// ... More menu items

When the Sub-menu 1 menu item is selected, the sub-menu screen will be displayed, showing the list of sub-items.

You can create multiple levels of sub-menus by nesting sub-menu items within other sub-menu screens.

After a sub-menu screen is created, you can add items to it using MenuScreen::addItem() or remove items using MenuScreen::removeItem(), MenuScreen::removeLastItem() on runtime. This allows you to dynamically update the sub-menu items based on user input or other conditions, an example of this can be a settings menu where the user can choose a WiFi network to connect to, and the list of available networks is updated based on the scan results. See the dynamic menu example for more information.

You can also update the screen that is displayed when the sub-menu item is selected by using the ItemSubMenu::setScreen() function on runtime.

Find more information about the sub-menu item in the API reference.