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

文档 / 组件 / 输入 / 数字 文档 / 组件 / 输入 /

数字

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

精确设置一个数值:获得焦点后直接键入,或用方向键和两侧的按钮按步长改;在数值上横向拖动可以连续调。

由 amenui 绘制打开 ↗

安装

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

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

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

用法

rust
use amenui::widgets::{number};

fn view() -> El<Msg> {
    number("n1", "份数", 3.0, Spec { min: 0.0, max: 9.0, step: 1.0, decimals: 0, unit: "" }, None, Msg::Num).width(320.0)
}

示例

带单位

rust
fn view() -> El<Msg> {
    number("n2", "宽度", 12.5, Spec { min: 0.0, max: 64.0, step: 0.5, decimals: 1, unit: "px" }, None, Msg::Num).width(320.0)
}

接口

函数number
参数key, label, value, spec: Spec (min, max, step, decimals, unit), draft (what is being typed), msg.
文件src/widgets/number.rs
依赖base
对波前的响应nudge (a control: pushed as one piece by fronts, held and condensing at most to Look::legible_cap)
重组its value text ({key}/shown) recomposes when the value changes

键盘与无障碍

状态rest, focused, typing (ink border, accent caret), disabled; a new value recomposes its digits ({key}/shown).
键盘与消息msg(Edit::Draft(s)) while typing, Edit::Set(v) on Enter / steps / arrows / scrub, Edit::Cancel on Esc or blur.

在网页上,每个控件都在页面里有一个带角色和名字的镜像元素,读屏软件和浏览器自己的焦点都看得到它(DESIGN.md §1.14)。

配方: 表单