状态卡

用固定的底色和右侧素材呈现成功、警告和错误。

状态卡给用户看一条状态结论,而不是让用户操作。它由一块带右侧素材的卡面和两行文字组成,成功、警告、错误各自使用不同的底色与副标题色。

Rust
use aeris_ui::device::{assets, cards};
基础用法
use aeris_ui::device::{assets, cards};

unsafe {
    cards::status_card(root, 8, "Success", "Ready");
    cards::status_card_with(
        root, 114, "Warning", "Check settings",
        assets::CARD_STATUS_WARNING, 0xFFE2B3,
    );
}

status_card 使用内置的成功素材和浅青色副标题。其他状态用 status_card_with,同时传入底图路径和副标题色值。

预览示例使用 gallery 构建导出的警告和错误素材。模块使用 aeris-ui/band-10-pro 时,这两个常量不可用,请通过 status_card_with 传入项目自己的位图路径。

组件结构

组成说明
卡面整张状态位图,包含背景、右侧插画和圆角。
标题25 px 中等字重,主文字色,位于左上 22, 16。
副标题25 px 常规字重,颜色随状态,位于 22, 49。
右侧素材状态插画占用的区域,文字列宽因此缩短到 176 px。

状态卡不是卡片加图标拼出来的,而是一张完整位图。换状态就是换整张底图,文字区域的位置保持一致。

示例

三种状态

成功、警告与错误
use aeris_ui::device::{assets, cards};

unsafe {
    cards::status_card(root, 8, "Success", "Ready");
    cards::status_card_with(
        root, 114, "Warning", "Check settings",
        assets::CARD_STATUS_WARNING, 0xFFE2B3,
    );
    cards::status_card_with(
        root, 220, "Error", "Try again",
        assets::CARD_STATUS_ERROR, 0xFFD1D1,
    );
}
状态副标题色
成功0xC3E5E1
警告0xFFE2B3
错误0xFFD1D1

自定义底图

使用项目位图
unsafe {
    cards::status_card_with(
        root, 8, "Synced", "All changes saved",
        b"my-status-synced.bin", 0xBFE8FF,
    );
}

路径按 LVGL 资源规则解析;相对路径从当前模块的数据目录开始。

让状态卡可点击

状态卡默认不拦截点击。确实需要打开详情时,由调用方添加可点击标记并绑定回调:

点击打开详情
use aeris_ui::device::lv;
use canopus_target_private::lvx_object_add_flag;

let card = unsafe { cards::status_card(root, 8, "Warning", "Check settings") };
if !card.is_null() {
    unsafe { lvx_object_add_flag(card, lv::CLICKABLE) };
    lv::bind(card, open_details, 0);
}

按压反馈和跳转箭头不会自动出现,需要的话自行补上。

接口参考

cards::status_card

pub unsafe fn status_card(parent: Obj, y: i32, title: &str, subtitle: &str) -> Obj
参数类型说明
parentObj状态卡挂载的父对象。
yi32纵向位置,横向固定为 4 px。
title&str主标题。
subtitle&str副标题。

cards::status_card_with

pub unsafe fn status_card_with(
    parent: Obj,
    y: i32,
    title: &str,
    subtitle: &str,
    art: &[u8],
    secondary: u32,
) -> Obj
参数类型说明
art&[u8]状态卡底图路径。
secondaryu32副标题的 0xRRGGBB 色值。

返回卡面对象;底图创建失败时返回空指针。

主题与样式

  • 标题使用 Color::PrimaryText,不随状态变化。
  • 副标题颜色由调用方传入,成功卡默认使用浅青色。
  • 卡面是完整位图,颜色和插画一起更换,不能单独染背景。
  • 预览中的警告和错误素材只在 gallery 构建中导出;模块使用 aeris-ui/band-10-pro 时,请通过 status_card_with 传入自己的位图。

交互与适配

  • 状态卡默认只做信息展示,不接收点击。
  • 如需点击,由调用方添加 CLICKABLE 并绑定事件,同时补上按压反馈。
  • 文字列宽只有 176 px,标题和副标题都应保持简短。
  • 在 UI 线程创建;父对象负责销毁。
  • 同一屏不要堆叠多个高饱和状态卡,成功状态可以更克制。

相关组件

  • 卡片:可点击的普通列表卡片。
  • 确认浮层:操作完成后的全屏结果反馈。
  • 进度环:需要展示过程时使用。

设备端入口:device::cards::{status_card, status_card_with}

大纲