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

文档 / 组件 / 数据 / 列表 文档 / 组件 / 数据 /

列表

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

显示一组条目,可以选中其中一项;条目多时可以滚动。

由 amenui 绘制打开 ↗

安装

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

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

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

用法

rust
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)。

配方: 可选择的列表