显示一组条目,可以选中其中一项;条目多时可以滚动。
安装
组件以源码分发。把它和它依赖的文件拷进你的项目,再按需要改:
cargo run --release --bin amenui -- add list --to ../my-app拷贝的文件: src/widgets/list.rs, src/widgets/mod.rs
用法
use amenui::widgets::{list};
fn view() -> El<Msg> {
list("l1", &[("苹果", "3"), ("梨", "5"), ("桃", "1")], Some(1), 36.0, 140.0, Msg::Pick)
}接口
| 函数 | list |
|---|---|
| 参数 | key, rows (label, note) or count + row_of(i), selected, row_h, height, msg. |
| 文件 | src/widgets/list.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 |
键盘与无障碍
| 状态 | selected row highlighted; one focus stop; Up / Down / Home / End / Page keys move the selection. |
|---|---|
| 键盘与消息 | msg(i) with the row index; rows are keyed key:i. |
在网页上,每个控件都在页面里有一个带角色和名字的镜像元素,读屏软件和浏览器自己的焦点都看得到它(DESIGN.md §1.14)。
配方: 可选择的列表