键盘(已弃用)

在腕上编辑简短备注的全屏键盘,已弃用。

键盘组件提供一块全屏输入页:顶部是输入预览,中间是小写字母键面,底部是空格、删除和完成。它已经弃用,新页面不要再使用;现有页面需要维护时,注意它只支持小写拉丁字母。

Rust
use aeris_ui::device::keyboard::{Keyboard, Labels};
基础用法
use aeris_ui::device::keyboard::{Keyboard, Labels};

let mut keyboard = unsafe {
    Keyboard::<32>::new(
        root,
        Labels {
            title: "Note\0",
            space: "Space",
            delete: "Delete",
            done: "Done\0",
        },
        on_key,
        on_done,
        on_back,
    )
};

if let Some(keyboard) = keyboard.as_mut() {
    keyboard.load(b"tea");

    // on_key 中调用 keyboard.handle_key(event)。
    let note = keyboard.text();
}

Keyboard<N> 会自己创建一块全屏页面根对象,不需要外层页面。N 是字节容量,包含结尾的 NUL,至少为 2。

组件结构

组成说明
输入预览顶部 328 × 98 px 卡片,文字过长时循环滚动。
字母键面三行小写字母,键宽 31 px、高 42 px。
空格与删除底部一行,空格 210 px,删除 112 px。
完成按钮395 px 处的整宽主按钮。
标题栏带返回按钮,标题由 Labels.title 提供。

键位是固定的 qwertyuiop / asdfghjkl / zxcvbnm,不包含大写、数字、标点或中文。

示例

编辑已有文本

载入
keyboard.load(b"tea");

load 会复制到容量上限,并在末尾补 NUL。超过 N - 1 的部分被丢弃。

处理按键

按键回调
extern "C" fn on_key(event: lv::Obj) {
    app.keyboard.handle_key(event);
}

事件数据是字符字节;0 表示删除。组件会自己维护长度和预览文本,不需要应用再拼字符串。

保存与返回

完成与返回
extern "C" fn on_done(_event: lv::Obj) {
    let note = app.keyboard.text();
    app.save_note(note);
}

extern "C" fn on_back(_event: lv::Obj) {
    // 由应用决定是否丢弃未保存内容。
}

text() 返回当前文本的 &str,只在实例存活期间有效。保存后是否关闭页面由应用决定。

容量

32 字节
Keyboard::<32>::new(...)

容量包含 NUL,所以最多输入 31 个 ASCII 字符。中文等多字节文本不在键面支持范围内。

接口参考

Keyboard::new

pub unsafe fn new(
    parent: Obj,
    labels: Labels<'_>,
    on_key: LvxEventCallback,
    on_done: LvxEventCallback,
    on_back: LvxEventCallback,
) -> Option<Self>
参数类型说明
parentObj键盘页面的父对象。
labelsLabels标题、空格、删除和完成文案。
on_keyLvxEventCallback字母、空格和删除键。
on_doneLvxEventCallback完成按钮。
on_backLvxEventCallback返回按钮。

N < 2 或页面创建失败时返回 None。

Labels

字段说明
title标题,需 NUL 结尾。
space空格键文案。
delete删除键文案。
done完成按钮文案,需 NUL 结尾。

方法

方法返回值说明
load(text)—载入文本,超出容量时截断。
handle_key(event)—转交按键事件,更新文本与预览。
text()&str读取当前文本。
rootObj键盘页面的根对象。

主题与样式

  • 字母键使用固定深灰 0x1F1F1F,文字白色。
  • 完成按钮使用 LargePrimary 胶囊,随主题主色变化。
  • 输入预览卡片使用标准卡面,文字白色。
  • 标题使用强调色,与普通标题栏一致。

交互与适配

  • 已弃用,新页面应改用其他输入方案。
  • 只支持小写拉丁字母、空格和删除,不支持数字、标点、大写和中文。
  • 键盘创建自己的全屏页面,不能再嵌进普通页面内容区。
  • 输入长度受 N 限制,容量包含 NUL。
  • 在 UI 线程创建;父对象负责销毁。

相关组件

设备端入口:device::keyboard::Keyboard

大纲