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

文档 / 组件 / 反馈 / 底部面板 文档 / 组件 / 反馈 /

底部面板

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

从底边升起的面板:按把手或正文拖动,停在几档高度之间;往下甩就收起。

松手时的速度交给弹簧,停在哪一档由这个速度能把它带到哪里决定;拉过最高一档会越拉越难;正文里的滚动到顶以后再往下拉就变成拖面板。Esc 收起。面板升起和拖动时在场图里留下尾迹(El::stirr,强弱由预设定)。

由 amenui 绘制打开 ↗

安装

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

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

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

用法

rust
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()
}

示例

拉到最高一档

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

配方: 手势:底部面板和浮动框