选项网格

以双列预设卡片呈现数字或文字选项。

选项网格用于把常用的几项预设摊开,让用户一次点中。每张选项卡有主标题和副标题,数字和文字共用同一套布局;奇数项会留在左侧,右侧空着。

Rust
use aeris_ui::device::option_grid::{grid, OptionItem, OptionTitle};
基础用法
use aeris_ui::device::option_grid::{grid, OptionItem, OptionTitle};

unsafe {
    grid(
        root,
        8,
        [
            OptionItem {
                title: OptionTitle::Number(5),
                subtitle: c"minutes",
                data: 5,
            },
            OptionItem {
                title: OptionTitle::Text(c"Tea"),
                subtitle: c"3 min",
                data: 3,
            },
        ],
        on_select,
    );
}

主标题用 OptionTitle 区分数字和文字,副标题统一是 NUL 结尾的 CStr。data 是回调用的事件数据,建议显式编码选项含义,不要依赖排列顺序。

组件结构

组成说明
选项卡152 × 112 px 胶囊形卡面,双列排列。
主标题数字 40 px,文字 32 px,居中显示。
副标题24 px 强调色,位于主标题下方。
间距列间距 14 px,行距 14 px。
点击层整张选项卡可点,按下有缩放反馈。

网格总宽 318 px,在 336 px 页面里左右各留 9 px。前两项在同一行,第三项回到左列。

示例

四个预设

两行两列
use aeris_ui::device::option_grid::{grid, OptionItem, OptionTitle};

unsafe {
    grid(
        root,
        8,
        [
            OptionItem { title: OptionTitle::Number(5), subtitle: c"minutes", data: 5 },
            OptionItem { title: OptionTitle::Text(c"Tea"), subtitle: c"3 min", data: 3 },
            OptionItem { title: OptionTitle::Number(30), subtitle: c"seconds", data: 30 },
            OptionItem { title: OptionTitle::Text(c"Custom"), subtitle: c"Set a time", data: 42 },
        ],
        on_select,
    );
}

数字与文字混排

数字项优先使用组件库的数字字形图集,字形不可用时退回 40 px 标签;文字项使用 32 px 标签。两种标题的基线不同,但卡片和副标题位置一致。

用 data 识别选项

回调
extern "C" fn on_select(event: lv::Obj) {
    let data = unsafe { lvx_event_get_user_data(event) };
    match data {
        5 => app.set_minutes(5),
        30 => app.set_seconds(30),
        _ => app.open_custom(),
    }
}

同一个回调可以服务所有选项。data 是 usize,可以放索引、分钟数或自定义编号。

长文案

文字标题和副标题都只显示一行,超出部分省略。需要更长的说明时,把细节放到下一页,不要缩小字号硬塞。

接口参考

option_grid::grid

pub unsafe fn grid<'a>(
    panel: Obj,
    top: i32,
    items: impl IntoIterator<Item = OptionItem<'a>>,
    on_select: LvxEventCallback,
)
参数类型说明
panelObj网格挂载的父对象。
topi32第一行的纵向位置。
itemsOptionItem 迭代器任意数量,按两列自动换行。
on_selectLvxEventCallback点击回调,事件数据为该项的 data。

OptionItem

字段类型说明
titleOptionTitleNumber(u32) 或 Text(&CStr)。
subtitle&CStrNUL 结尾的副标题。
datausize回调事件数据。

尺寸

项目值说明
选项卡152 × 112 px圆角胶囊卡面。
列间距14 px固定。
行距14 px固定。
网格左边距9 px在 336 px 页面中居中。

主题与样式

  • 主标题使用 Color::PrimaryText,副标题使用 Color::Accent。
  • 选项卡使用短胶囊素材,颜色随素材和主题变化。
  • 数字字形来自 OPTION 图集,文字来自标签字体。
  • 副标题的强调色可以通过主题生成器调整。

交互与适配

  • 在 UI 线程创建;父对象负责销毁。
  • 固定双列,不支持单列或三列布局。
  • 选项过多时超出页面,需要放进滚动容器。
  • 每项独立绑定点击,data 不应依赖标题文本。
  • 数字标题支持 u32,超大数值会占满卡片宽度并被省略。

相关组件

设备端入口:device::option_grid::grid

大纲