M5Menu

M5Menu 是一个用于在用户界面中创建多级菜单的组件。

UiFlow2 示例

MicroPython 示例

菜单事件

本示例创建了一个多级菜单。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
import m5ui
import lvgl as lv


page0 = None
menu0 = None
Label1 = None
Label2 = None
Page_2 = None
Page2_Label1 = None
Page2_Label2 = None
Page_3 = None
Page3_Label = None
Page3_Switch = None


import random


def Page3_Switch_checked_event(event_struct):  # noqa: N802
    global \
        page0, \
        menu0, \
        Label1, \
        Label2, \
        Page_2, \
        Page2_Label1, \
        Page2_Label2, \
        Page_3, \
        Page3_Label, \
        Page3_Switch

    Page3_Label.set_text_color(random.randint(0x000000, 0xFFFFFF), 255, 0)


def Page3_Switch_unchecked_event(event_struct):  # noqa: N802
    global \
        page0, \
        menu0, \
        Label1, \
        Label2, \
        Page_2, \
        Page2_Label1, \
        Page2_Label2, \
        Page_3, \
        Page3_Label, \
        Page3_Switch

    Page3_Label.set_text_color(random.randint(0x000000, 0xFFFFFF), 255, 0)


def Page3_Switch_event_handler(event_struct):  # noqa: N802
    global \
        page0, \
        menu0, \
        Label1, \
        Label2, \
        Page_2, \
        Page2_Label1, \
        Page2_Label2, \
        Page_3, \
        Page3_Label, \
        Page3_Switch
    event = event_struct.code
    obj = event_struct.get_target_obj()
    if event == lv.EVENT.VALUE_CHANGED:
        if obj.has_state(lv.STATE.CHECKED):
            Page3_Switch_checked_event(event_struct)
        else:
            Page3_Switch_unchecked_event(event_struct)
    return


def setup():
    global \
        page0, \
        menu0, \
        Label1, \
        Label2, \
        Page_2, \
        Page2_Label1, \
        Page2_Label2, \
        Page_3, \
        Page3_Label, \
        Page3_Switch

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    menu0 = m5ui.M5Menu(x=0, y=0, w=320, h=240, parent=page0)
    menu0.set_page(menu0.main_page)
    Label1 = menu0.add_label("Label1")
    Label2 = menu0.add_label("Label2")
    menu0.set_mode_root_back_button(lv.menu.ROOT_BACK_BUTTON.ENABLED)
    menu0.set_mode_header(lv.menu.HEADER.TOP_FIXED)

    page0.screen_load()
    Label2.set_style_text_font(lv.font_montserrat_24, lv.PART.MAIN | lv.STATE.DEFAULT)
    Label2.set_text(str("Click me!!!!!!!!"))
    Page_2 = lv.menu_page(menu0, "Page2")
    menu0.set_load_page_event(Label2.cont, Page_2)
    Page2_Label1 = menu0.add_label("Label1", parent=Page_2)
    Page2_Label2 = menu0.add_label(
        "Label2 (Click me)",
        text_c=0xFF0000,
        text_opa=255,
        bg_c=0xFFFFFF,
        bg_opa=255,
        font=lv.font_montserrat_24,
        parent=Page_2,
    )
    Page_3 = lv.menu_page(menu0, "Page3")
    menu0.set_load_page_event(Page2_Label2.cont, Page_3)
    Page3_Label = menu0.add_label("A Label", parent=Page_3)
    Page3_Label.set_style_text_font(lv.font_montserrat_24, lv.PART.MAIN | lv.STATE.DEFAULT)
    Page3_Switch = menu0.add_switch(
        "A Switch",
        w=80,
        h=40,
        bg_c=0xE7E3E7,
        bg_opa=255,
        bg_c_checked=0x2196F3,
        bg_c_checked_opa=255,
        circle_c=0xFF9966,
        circle_opa=255,
        parent=Page_3,
    )
    Page3_Switch.add_event_cb(Page3_Switch_event_handler, lv.EVENT.ALL, None)


def loop():
    global \
        page0, \
        menu0, \
        Label1, \
        Label2, \
        Page_2, \
        Page2_Label1, \
        Page2_Label2, \
        Page_3, \
        Page3_Label, \
        Page3_Switch
    M5.update()


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            m5ui.deinit()
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

None

API参考

M5Menu

class m5ui.menu.M5Menu(*args, **kwargs)

基类：menu

创建一个列表对象。

参数:

x (int) – 菜单的 x 坐标位置。
y (int) – 菜单的 y 坐标位置。
w (int) – 菜单的宽度。
h (int) – 菜单的高度。
page_name (str) – 菜单主页的名称。
parent (lv.obj) – 要附加菜单的父对象。如果未指定，菜单会附加到默认屏幕。

UiFlow2 代码块：

None

MicroPython 代码块：

from m5ui import M5Menu
import lvgl as lv

m5ui.init()
menu0 = M5Menu(x=120, y=80, w=60, h=30, parent=page0)

set_page(page)

为菜单设置主页面。

参数:: page (lv.obj) – 主页面对象。

UiFlow2 代码块：

MicroPython 代码块：

menu0.set_page(menu0.main_page)

set_mode_header(mode)

设置菜单的模式头部。

参数:: mode (int) – 模式头部文本。选项：- lv.menu.HEADER.TOP_FIXED - lv.menu.HEADER.TOP_UNFIXED - lv.menu.HEADER.BOTTOM_FIXED

UiFlow2 代码块：

MicroPython 代码块：

menu0.set_mode_header(lv.menu.HEADER.TOP_FIXED)

set_pos(x, y)

设置菜单的位置。

参数:

x (int) – 菜单的 x 坐标。
y (int) – 菜单的 y 坐标。

UiFlow2 代码块：

MicroPython 代码块：

menu0.set_pos(100, 100)

set_size(width, height)

设置菜单的尺寸。

参数:

width (int) – 菜单的宽度。
height (int) – 菜单的高度。

UiFlow2 代码块：

MicroPython 代码块：

menu0.set_size(100, 50)

add_label(text, text_c=2171169, text_opa=255, bg_c=16777215, bg_opa=255, font=lvgl.font_montserrat_14, parent=None)

向菜单添加一个标签。

参数:

text (str) – 标签上要显示的文本。
text_c (int) – 标签的文本颜色。
bg_c (int) – 标签的背景颜色。
bg_opa (int) – 标签背景的不透明度。
font (lv.font_t) – 标签的字体。
parent (lv.obj) – 要附加标签的父对象。如果未指定，标签将附加到菜单的主页面。

返回:

创建的标签对象。

返回类型:

m5ui.M5Label UiFlow2 代码块：

MicroPython 代码块：

label0 = menu0.add_label("Hello, World!", text_c=0x212121, bg_c=0xFFFFFF, bg_opa=255, font=lv.font_montserrat_14, parent=menu0.main_page)

add_switch(text, w=50, h=20, bg_c=15197159, bg_opa=255, bg_c_checked=166139, bg_c_checked_opa=255, circle_c=16777215, circle_opa=255, parent=None)

向菜单添加一个开关。

参数:

text (str) – 开关旁显示的文本。
w (int) – 开关的宽度。
h (int) – 开关的高度。
bg_c (int) – 开关未选中时的背景颜色。
bg_c_checked (int) – 开关选中时的背景颜色。
circle_c (int) – 开关圆圈的颜色。
parent (lv.obj) – 要附加开关的父对象。如果未指定，开关将附加到菜单的主页面。

返回:

创建的开关对象。

返回类型:

m5ui.M5Switch

UiFlow2 代码块：

MicroPython 代码块：

switch_0 = menu0.add_switch("Switch 1", w=50, h=20, bg_c=0xE7E3E7, bg_c_checked=0x0288FB, circle_c=0xFFFFFF, parent=menu0.main_page)