菜单

以卡片为锚点显示两行局部操作,并压暗周围内容。

卡片菜单用于“对这张卡片做什么”,比如编辑或删除。它把菜单放在卡片上方或下方,稍微压暗卡片周围,同时保留卡片本身可见,让用户知道操作对象是哪一条。

Rust
use aeris_ui::device::card_menu::CardMenu;
基础用法
use aeris_ui::device::card_menu::CardMenu;

let menu = unsafe {
    CardMenu::new(
        root,
        close_menu,
        [("Edit", 0xFFFFFF, edit), ("Remove", 0xFF8888, remove)],
    )
};
if let Some(menu) = menu {
    unsafe { menu.show(card) };
}

菜单在创建时就固定两行。调用 show 传入卡片对象后,它根据卡片位置自动决定显示在下方还是上方,并把菜单夹在页面内。

组件结构

组成说明
全屏遮罩透明点击层,覆盖整个页面,点按触发 outside。
四块阴影卡片四周各一块 50% 黑色遮罩,卡片本身保持原亮度。
菜单面板224 px 宽、137 px 高,圆角 20 px,深灰底。
分隔线两行之间的 1 px 横线。
操作行每行 68 px 高,左侧文字,整行可点。

菜单基于页面根对象定位,根对象必须覆盖整个设备页面,否则阴影和菜单可能显示不全。

示例

危险操作

第二行常用红色区分删除等不可逆操作:

编辑与删除
let menu = unsafe {
    CardMenu::new(
        root,
        close_menu,
        [("Edit", 0xFFFFFF, edit), ("Remove", 0xFF8888, remove)],
    )
};

颜色是 0xRRGGBB,不随主题变化。普通操作使用 0xFFFFFF,危险操作使用偏红的色值。

长按打开

列表卡片通常长按打开菜单,短按进入详情:

长按
use aeris_ui::device::lv;
use canopus_target_private::lvx_event_add;

unsafe {
    lvx_event_add(card, open_menu, 5, card as usize);
    lvx_event_add(card, open_timer, 4, card as usize);
}

extern "C" fn open_menu(event: lv::Obj) {
    let card = unsafe { lvx_event_get_user_data(event) } as lv::Obj;
    app.menu.show(card);
}

事件码 5 是长按,4 是短按。两者可以绑在同一张卡片上。

收起菜单

关闭
app.menu.hide();

点按菜单外的遮罩会调用创建时传入的 outside,由应用调用 hide。选中操作后也应由回调收起菜单。

更新行文案

改标题
app.menu.set_label(0, c"Rename");

index 为 0 或 1,传入的文本必须 NUL 结尾。

状态与交互

状态表现
收起遮罩隐藏,不拦截点击。
展开卡片周围压暗,菜单出现在卡片上方或下方。
点按行调用该行回调,菜单不会自动收起。
点按外部调用 outside,菜单不会自动收起。

接口参考

CardMenu::new

pub unsafe fn new(
    root: Obj,
    outside: LvxEventCallback,
    rows: [(&str, u32, LvxEventCallback); 2],
) -> Option<Self>
参数类型说明
rootObj覆盖整个页面的根对象。
outsideLvxEventCallback点按菜单外区域时调用。
rows两行数组每行提供标题、文字色和点击回调。

方法

方法说明
show(card)以卡片为锚点显示菜单,并压暗周围。
hide()立即隐藏遮罩和菜单。
set_label(index, text)更新指定行的标题,文本须 NUL 结尾。

尺寸

项目值说明
菜单宽度224 px固定。
菜单高度137 px两行 68 px 加 1 px 分隔线。
行高68 px整行可点。
圆角20 px面板圆角。
间距8 px菜单与卡片之间。

主题与样式

  • 面板使用固定深灰 0x242424,不随主题换色。
  • 行文字颜色由创建时传入,普通操作用白色,危险操作用红色。
  • 分隔线固定为 0x414141。
  • 遮罩是 50% 黑色,只压暗卡片周围,不压暗卡片本身。

交互与适配

  • 在 UI 线程创建;父对象负责销毁。
  • root 必须覆盖整个页面,否则菜单会被裁切。
  • 行数固定为两行;更多操作需要另做面板。
  • show 会先结束卡片上的按压动画,避免菜单与卡片反馈打架。
  • 菜单不会自动收起,应用要在行回调和外部回调里调用 hide。

相关组件

  • 卡片:菜单锚定的列表项。
  • 弹窗:需要阻断式确认时使用。
  • 计时卡:长按菜单的典型场景。

设备端入口:device::card_menu::CardMenu

大纲