amenui
en·中 github ↗ v0.0.1
01文档 02组件 03实验室 04作品
en·中github ↗
×

文档 / 组件 / 导航 / 多级菜单 文档 / 组件 / 导航 /

多级菜单

04.32
本页内容 ▾
  1. 安装
  2. 用法
  3. 接口
  4. 键盘与无障碍

行可以打开子菜单的菜单,按指针往哪里去来决定:指针在“上一处位置到子菜单两个近角”的三角形里朝子菜单移动时,经过的兄弟行不会接管(每次移动重新等 close_delay_ms,默认 200 ms);在三角形外,停在一行上 submenu_delay_ms(默认 120 ms)后它接管。

方向键、Enter、Esc;可以把三角形画出来(标注层)。

由 amenui 绘制打开 ↗

安装

组件以源码分发。把它和它依赖的文件拷进你的项目,再按需要改:

sh
cargo run --release --bin amenui -- add nested_menu --to ../my-app

拷贝的文件: src/widgets/nested_menu.rs, src/widgets/mod.rs

用法

rust
use amenui::widgets::{nested_menu};

fn view() -> El<Msg> {
    let mut m = Menu::new(vec![
        MenuItem::sub("新建", vec![MenuItem::leaf("文档"), MenuItem::leaf("表格"), MenuItem::leaf("文件夹")]),
        MenuItem::sub("打开最近", vec![MenuItem::leaf("报告"), MenuItem::leaf("草稿")]),
        MenuItem::leaf("关闭"),
    ]);
    m.update(MenuMsg::Press(0, 0), 0.0);
    nested_menu("nm1", &m, Msg::Menu)
}

接口

函数nested_menu
参数key, menu (Menu: items, submenu_delay_ms, close_delay_ms, row_h, width, show_safe_zone), msg.
文件src/widgets/nested_menu.rs
依赖base
对波前的响应nudge (a control: pushed as one piece by fronts, held and condensing at most to Look::legible_cap)
重组keyed labels recompose when their text changes

键盘与无障碍

状态closed, open (a row hot, submenus open along a path), a switch pending (after submenu_delay_ms, or close_delay_ms while the pointer is inside the safe zone); role menu, rows menuitem.
键盘与消息msg(MenuMsg) for pointer moves over the menu, presses on rows and keys; the application calls Menu::update (which returns the path of a chosen item) and Menu::step on every tick while Menu::waiting().

在网页上,每个控件都在页面里有一个带角色和名字的镜像元素,读屏软件和浏览器自己的焦点都看得到它(DESIGN.md §1.14)。

配方: 带子菜单和安全区的菜单