单选
在卡片右侧显示圆形选中标记,适合互斥选项。
单选把选中状态放在卡片右侧的圆形标记里,文字区域和开关相同。它只表达“这一项被选中”,不负责维护一组选项的互斥关系;多选项管理交给单选列表。
use aeris_ui::device::{cards::Choice, lv};use aeris_ui::device::{cards::Choice, lv};
let card = unsafe { lv::card(root, 4, 108) };
let mut radio = unsafe { Choice::radio(card, "Reminder", "Tap to select", false) };
lv::bind(card, on_select, 0);
// 应用确认选择后更新标记。
radio.set_selected(true);初始值只决定首帧画面。点击不会自动改变标记,应用要在回调里更新状态,再调用 set_selected 或 animate_to。
组件结构
| 组成 | 说明 |
|---|---|
| 卡片底面 | 328 × 98 px 圆角卡片,承担点击和按压反馈。 |
| 标题 | 25 px 中等字重,主文字色。 |
| 副标题 | 25 px 常规字重,次文字色,位于标题下方 1 px。 |
| 圆面 | 40 px 圆形标记,位于右侧,距右边 18 px。 |
| 内点 | 选中时出现的 22 px 白色圆点,从中心缩放。 |
文字列宽 224 px,比开关多出右侧标记占用的空间。
示例
受控单选
fn select_reminder() {
app.reminder = true;
app.radio.animate_to(true);
}推荐由应用持有选中状态,组件只负责把画面过渡到目标值。这样列表、持久化和界面不会出现两个真相。
立即同步
app.radio.set_selected(true);恢复设置或首次进入页面时可以直接落位,不播放过渡。
取消选中
app.radio.animate_to(false);单选标记允许回到未选状态。需要“一组里必须有一项”时,由应用阻止取消,或者改用单选列表。
一组互斥选项
use aeris_ui::device::choice_list::ChoiceList;
let mut choices = unsafe {
ChoiceList::<3>::new(
root, 14, 102,
[("Soft", "One pulse"), ("Standard", "Two pulses"), ("Strong", "Three pulses")],
Some(0),
on_select,
)
};
choices.select(1);状态与动效
| 状态 | 表现 |
|---|---|
| 未选 | 白色低透明度圆面。 |
| 选中 | 蓝色圆面淡入,中心白色圆点放大到 22 px。 |
| 过渡中 | 蓝色圆面与内点尺寸在 220 ms 内连续变化。 |
| 重复点按 | 从当前尺寸反向,不会先跳回起点。 |
过渡使用三次缓出曲线,时长来自 card::TRANSITION_MS。
接口参考
Choice::radio
pub unsafe fn radio(card: Obj, title: &str, subtitle: &str, selected: bool) -> Self| 参数 | 类型 | 说明 |
|---|---|---|
card | Obj | 承载标记的卡片对象。 |
title | &str | 主标题。 |
subtitle | &str | 副标题,可为空字符串。 |
selected | bool | 初始选中状态。 |
方法
| 方法 | 返回值 | 说明 |
|---|---|---|
set_selected(selected) | — | 立即切换画面。 |
animate_to(selected) | — | 从当前进度过渡到目标状态。 |
draw(now) | bool | 推进动画,返回是否还需要下一帧。 |
常量
| 常量 | 值 | 说明 |
|---|---|---|
cards::WIDTH | 328 | 卡片宽度。 |
card::TRANSITION_MS | 220 | 过渡时长。 |
主题与样式
- 标题使用
Color::PrimaryText,副标题使用Color::SecondaryText。 - 选中圆点使用组件内置的蓝色
0x3488FF,不随Color::Accent改变。 - 未选中标记是白色低透明度圆面,深色底上对比稳定。
- 卡片底面和开关共用同一张卡面素材。
交互与适配
- 在 UI 线程创建;父对象负责销毁。
- 整张卡片是点击热区,事件数据可携带选项索引。
- 组件不自动取消同组其他项,互斥逻辑由应用负责。
- 动画只在
draw时推进,页面不可见时停止调用即可。 - 需要单选列表的统一同步时,用
ChoiceList::select。
相关组件
设备端入口:device::cards::Choice::radio