单选

在卡片右侧显示圆形选中标记,适合互斥选项。

单选把选中状态放在卡片右侧的圆形标记里,文字区域和开关相同。它只表达“这一项被选中”,不负责维护一组选项的互斥关系;多选项管理交给单选列表。

Rust
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
参数类型说明
cardObj承载标记的卡片对象。
title&str主标题。
subtitle&str副标题,可为空字符串。
selectedbool初始选中状态。

方法

方法返回值说明
set_selected(selected)—立即切换画面。
animate_to(selected)—从当前进度过渡到目标状态。
draw(now)bool推进动画,返回是否还需要下一帧。

常量

常量值说明
cards::WIDTH328卡片宽度。
card::TRANSITION_MS220过渡时长。

主题与样式

  • 标题使用 Color::PrimaryText,副标题使用 Color::SecondaryText。
  • 选中圆点使用组件内置的蓝色 0x3488FF,不随 Color::Accent 改变。
  • 未选中标记是白色低透明度圆面,深色底上对比稳定。
  • 卡片底面和开关共用同一张卡面素材。

交互与适配

  • 在 UI 线程创建;父对象负责销毁。
  • 整张卡片是点击热区,事件数据可携带选项索引。
  • 组件不自动取消同组其他项,互斥逻辑由应用负责。
  • 动画只在 draw 时推进,页面不可见时停止调用即可。
  • 需要单选列表的统一同步时,用 ChoiceList::select。

相关组件

  • 开关:同一张卡片上的布尔切换。
  • 复选框:三态或独立多选。
  • 单选列表:一组互斥选项的统一管理。

设备端入口:device::cards::Choice::radio

大纲