行可以打开子菜单的菜单,按指针往哪里去来决定:指针在“上一处位置到子菜单两个近角”的三角形里朝子菜单移动时,经过的兄弟行不会接管(每次移动重新等 close_delay_ms,默认 200 ms);在三角形外,停在一行上 submenu_delay_ms(默认 120 ms)后它接管。
方向键、Enter、Esc;可以把三角形画出来(标注层)。
安装
组件以源码分发。把它和它依赖的文件拷进你的项目,再按需要改:
cargo run --release --bin amenui -- add nested_menu --to ../my-app拷贝的文件: src/widgets/nested_menu.rs, src/widgets/mod.rs
用法
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)。
配方: 带子菜单和安全区的菜单