胶囊按钮

用三片式胶囊承载常规或主要操作,宽度随内容区伸缩。

胶囊按钮把左右端帽固定、中段拉伸,所以同一个按钮可以放进 240 px 的卡片,也可以铺满页面宽度。它有三种高度:常规、Large 和 LargePrimary,分别用于普通操作、强调操作和主操作。

Rust
use aeris_ui::{capsule::CapsuleKind, device::page};
基础用法
use aeris_ui::{capsule::CapsuleKind, device::page};

unsafe {
    page::button(root, 8, "Regular\0", CapsuleKind::Regular, on_regular);
    page::button(root, 84, "Large\0", CapsuleKind::Large, on_large);
    page::button(root, 172, "Primary\0", CapsuleKind::LargePrimary, on_primary);
}

按钮标签是 NUL 结尾的字节串。page::button 按页面宽度创建,并在两侧各内缩 3 px;需要自定义宽度时改用 button_in。

组件结构

组成说明
左端帽固定 80 px 宽,保留圆角和高光。
中段拉伸填充剩余宽度,素材原始宽度 170 px。
右端帽固定 80 px 宽,与左端帽镜像。
标签26 px,垂直居中,颜色随按钮类型变化。

组件按目标宽度重新计算三片位置,并裁掉切片四角的黑底。宽度小于 160 px 时,左右端帽会各占一半,中段变为 0。

示例

三种类型

常规、Large 与主按钮
use aeris_ui::{capsule::CapsuleKind, device::page};

unsafe {
    page::button(root, 8, "Regular\0", CapsuleKind::Regular, on_regular);
    page::button(root, 84, "Large\0", CapsuleKind::Large, on_large);
    page::button(root, 172, "Primary\0", CapsuleKind::LargePrimary, on_primary);
}
类型高度用途
Regular70 px常规次级操作。
Large82 px需要更大点击面积的常规操作。
LargePrimary82 px页面主操作,使用主色底和前景色文字。

自定义宽度和位置

指定区域
use aeris_ui::{capsule::CapsuleKind, device::page, geometry::Rect};

let button = unsafe {
    page::button_in(
        root,
        Rect::new(12, 120, 312, 82),
        "Start\0",
        CapsuleKind::LargePrimary,
        on_start,
        3,
    )
};

button_in 会在传入矩形两侧各内缩 3 px,得到 306 px 的按钮。不要在外面再扣一次,否则按钮会比预期窄。矩形高度小于按钮高度时返回空指针。

携带事件数据

列表中的按钮
let button = unsafe {
    page::button_with_data(
        root, 320, "Delete\0", CapsuleKind::Large, on_action, index,
    )
};

回调里用 lvx_event_get_user_data(event) 读取 index,不需要为每一行写一个专用回调。

状态与交互

状态表现
默认端帽和中段完整显示。
按下整体缩小到约 96%,中心作为缩放轴。
松开240 ms 内回弹到原尺寸。
取消按压指针滑出按钮时同样回弹。

按压反馈由 anim 模块处理,按钮本身只负责布局和标签。

接口参考

page::button_in

pub unsafe fn button_in(
    parent: Obj,
    bounds: Rect,
    title: &str,
    kind: CapsuleKind,
    action: LvxEventCallback,
    data: usize,
) -> Obj
参数类型说明
parentObj按钮挂载的父对象。
boundsRect可用矩形,组件在两侧各内缩 3 px。
title&strNUL 结尾的标签。
kindCapsuleKind三种高度与素材组。
actionLvxEventCallback点击回调。
datausize回调附带的数据。

相关入口

函数说明
button(parent, y, title, kind, action)使用页面宽度和 0 数据。
button_with_data(parent, y, title, kind, action, data)使用页面宽度并携带数据。
lv::capsule(parent, x, y, width, kind)只创建胶囊底面,标签自行添加。

尺寸

常量值说明
CAPSULE_SLICE_WIDTH80左右端帽宽度。
CAPSULE_HEIGHT70Regular 高度。
CAPSULE_LARGE_HEIGHT82Large 与 LargePrimary 高度。
最小可用宽度160更窄时端帽各占一半,中段为 0。

主题与样式

  • LargePrimary 的标签使用 theme::primary_button_foreground(),随主色和前景色调整。
  • 常规和 Large 使用 Color::PrimaryText 作为标签色。
  • 三组端帽和中段是独立位图;主按钮素材会按主题染色。
  • 标签不自动换行,长文案需要缩字号或改成更短的词。

交互与适配

  • 在 UI 线程创建;父对象负责销毁。
  • bounds 的高度必须不小于按钮高度,否则返回空指针。
  • 宽度过大时中段会被拉伸,端帽保持比例,不会变扁。
  • 图标按钮不要用胶囊,改用图标按钮。
  • 主操作一屏只保留一个,多个 LargePrimary 会互相抢注意力。

相关组件

设备端入口:device::page::button_in

大纲