从底边升起的面板:按把手或正文拖动,停在几档高度之间;往下甩就收起。
松手时的速度交给弹簧,停在哪一档由这个速度能把它带到哪里决定;拉过最高一档会越拉越难;正文里的滚动到顶以后再往下拉就变成拖面板。Esc 收起。面板升起和拖动时在场图里留下尾迹(El::stirr,强弱由预设定)。
安装
组件以源码分发。把它和它依赖的文件拷进你的项目,再按需要改:
cargo run --release --bin amenui -- add bottom_sheet --to ../my-app拷贝的文件: src/widgets/bottom_sheet.rs, src/gesture.rs, src/widgets/mod.rs
用法
use amenui::widgets::{bottom_sheet};
fn view() -> El<Msg> {
let sheet = Sheet::resting(260.0, 0);
let body = col().gap(8.0).child(text("一行内容", 14.0, Paint::TEXT)).child(text("另一行", 14.0, Paint::TEXT));
layers([col().fill_width().fill_height(), bottom_sheet("bs1", &sheet, "分享到", body, Msg::Sheet)])
.width(260.0).height(260.0).radius(16.0).border(1.0, Paint::DIM).clip()
}示例
拉到最高一档
fn view() -> El<Msg> {
let mut sheet = Sheet::default();
sheet.detents = vec![0.3, 0.8];
let sheet = sheet.rest_on(260.0, 1);
layers([col().fill_width().fill_height(), bottom_sheet("bs2", &sheet, "筛选", text("拖动把手或正文", 14.0, Paint::DIM), Msg::Sheet)])
.width(260.0).height(260.0).radius(16.0).border(1.0, Paint::DIM).clip()
}接口
| 函数 | bottom_sheet |
|---|---|
| 参数 | key, sheet (Sheet: detents, dismiss_velocity, projection_decel, backdrop, spring, rubber, height), title, body, msg. |
| 文件 | src/widgets/bottom_sheet.rs, src/gesture.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, presenting, resting on a detent, dragged (captured until release), springing to a detent or away; Esc dismisses; role dialog. |
|---|---|
| 键盘与消息 | msg(SheetMsg) for every drag step, Esc and a press on the backdrop; the application calls Sheet::update with it and Sheet::step on every tick while Sheet::moving(). |
在网页上,每个控件都在页面里有一个带角色和名字的镜像元素,读屏软件和浏览器自己的焦点都看得到它(DESIGN.md §1.14)。
配方: 手势:底部面板和浮动框