feat(sdk): 结构化列表控件 W_LISTVIEW (agent-186) — MEOW_APP_SDK §5.5 A②落地: 图标(内置folder/file符号或img)+标题+副标题+右侧操作(arrow/switch/check/more), 单选/多选/禁态, 行右1/3操作区命中, 视口裁剪, 全语义色; meow_ui_img_scaled 弱引用防二进制膨胀; files App 自绘列表完整迁移(长按留App层)
meow_ui.a ece0ecdb→4335c33a; hello 07b1ee37→07c0c5a5; files 6f6b0a6d→22b6b606 宿主: widgets(含4条listview新断言)/p1p2p3/ime_fix/test_fsx 全 PASS
This commit is contained in:
MeowOS committed
1 parent
3f57d7fd4f
commit
243148e440
8 files changed
+667
-155
No files matched your search
@@ -567,6 +567,78 @@ typedef void (*meow_list_tap_fn)(int idx, void *ctx);
|
||||
void meow_list_set_on_tap(meow_widget *w, meow_list_tap_fn cb, void *ctx); /* 命中行→回调 */
|
||||
int meow_list_tap_at(meow_widget *w, int x, int y); /* 命中行：置选中+回调，返回 idx/-1 */
|
||||
|
||||
/* ============================================================ */
|
||||
/* §5.5 设计模板 A② 结构化列表（W_LISTVIEW）：行=图标+标题+副标题+右侧操作 + 选中
|
||||
* ------------------------------------------------------------
|
||||
* 在既有「label-only」列表（meow_list_create/lazycolumn，行为不变）之上做**结构化扩展**：
|
||||
* 行数据源回调逐行给出 meow_list_item（图标 / 标题 / 副标题 / 右侧操作 / 可选中），容器负责
|
||||
* 绘制/滚动/选中/命中；支持单选/多选/无选择。向后兼容：既有 meow_list_* 全部保留不动。
|
||||
* 颜色全部取 meow_theme_get() 语义色（日/夜/style 自动），不硬编码。
|
||||
* 命中：meow_listview_hit 返回行号（含滚动换算 + 禁用行不响应）；行右 1/3 为右侧操作区
|
||||
* （meow_listview_hit_op 另判）。抬手用最新坐标（goodix 免疫，参照既有 W_LIST 习惯）。 */
|
||||
/* ============================================================ */
|
||||
|
||||
/* 选中模式：无（纯入口列表）/ 单选 / 多选。 */
|
||||
typedef enum { MEOW_LIST_SEL_NONE = 0, MEOW_LIST_SEL_SINGLE, MEOW_LIST_SEL_MULTI } meow_list_sel;
|
||||
|
||||
/* 行图标：meow_img*（MEOW_LIST_ICON_IMG）或内置符号（FOLDER/FILE，无图 App 用）。 */
|
||||
typedef enum {
|
||||
MEOW_LIST_ICON_NONE = 0, /* 无图标 */
|
||||
MEOW_LIST_ICON_IMG, /* 用 item->icon（meow_img*） */
|
||||
MEOW_LIST_ICON_FOLDER, /* 内置目录符号（填充矩形+页签） */
|
||||
MEOW_LIST_ICON_FILE, /* 内置文件符号（空心矩形+折角） */
|
||||
} meow_list_icon_kind;
|
||||
|
||||
/* 行右侧操作类型：无 / 箭头 / 开关 / 复选 / 详情钮（⋯）。 */
|
||||
typedef enum {
|
||||
MEOW_LIST_RIGHT_NONE = 0, /* 无右侧操作 */
|
||||
MEOW_LIST_RIGHT_ARROW, /* 箭头 › */
|
||||
MEOW_LIST_RIGHT_SWITCH, /* 开关（on/off = item->on） */
|
||||
MEOW_LIST_RIGHT_CHECK, /* 复选标记 */
|
||||
MEOW_LIST_RIGHT_MORE, /* ⋯ 详情钮 */
|
||||
} meow_list_right;
|
||||
|
||||
/* 单行数据（回调填充到栈上，容器不长期持有）。title 必填；subtitle 可空。 */
|
||||
typedef struct meow_list_item {
|
||||
const meow_img *icon; /* 可选（icon_kind==MEOW_LIST_ICON_IMG 时用） */
|
||||
int icon_kind; /* MEOW_LIST_ICON_*（NONE=无图标） */
|
||||
const char *title; /* 主文本（必填，NULL 视为空行） */
|
||||
const char *subtitle; /* 副文本，可空 */
|
||||
int right; /* MEOW_LIST_RIGHT_* 右侧操作类型 */
|
||||
int on; /* right==SWITCH 时开关态（0/1） */
|
||||
int enabled; /* 1=可选中/可交互；0=变淡不响应命中 */
|
||||
} meow_list_item;
|
||||
|
||||
/* 行数据源回调：idx 有效时填充 out 并返回 1；越界返回 0。每行轻量填充（不做 IO，§5.5）。 */
|
||||
typedef int (*meow_list2_source)(int idx, meow_list_item *out, void *ctx);
|
||||
|
||||
/* 创建：视口(x,y,w,h) + 行数 count + 行数据源 + 选中模式。行高默认 56（可用 set_item_h 改）。 */
|
||||
meow_widget *meow_listview_create(int x, int y, int w, int h, int count,
|
||||
meow_list2_source src, void *ctx, meow_list_sel mode);
|
||||
/* 行高（固定；越界/<=0 忽略）。 */
|
||||
int meow_listview_set_item_h(meow_widget *lv, int item);
|
||||
/* 行数（搜索过滤/懒加载/目录切换时动态更新）：截断 sel 到新范围 + clamp scroll。 */
|
||||
void meow_listview_set_count(meow_widget *lv, int count);
|
||||
/* 滚动：set 越界 clamp 到 [0, max_scroll]；by 相对滚动（App on_swipe/touch_move 用）。 */
|
||||
void meow_listview_set_scroll(meow_widget *lv, int offset);
|
||||
void meow_listview_scroll_by(meow_widget *lv, int dy);
|
||||
int meow_listview_scroll(meow_widget *lv);
|
||||
int meow_listview_max_scroll(meow_widget *lv); /* max(0, count*item_h - viewport_h) */
|
||||
/* 选中集（mode 语义）：
|
||||
* NONE ：忽略；SINGLE：set_sel(idx) 设/清（idx<0 清除）；MULTI：set_sel(idx) 翻转 idx。
|
||||
* get_sel 把当前选中下标写入 out[0..max)，返回写入数；sel_count 返回选中总数。 */
|
||||
void meow_listview_set_sel(meow_widget *lv, int idx);
|
||||
int meow_listview_get_sel(meow_widget *lv, int *out, int max);
|
||||
int meow_listview_sel_count(meow_widget *lv);
|
||||
/* 命中：返回行号（含滚动换算；禁用行/越界返回 -1）；行右 1/3 = 右侧操作区（另判）。 */
|
||||
int meow_listview_hit(meow_widget *lv, int x, int y);
|
||||
int meow_listview_hit_op(meow_widget *lv, int x, int y); /* 1=点在行右 1/3 操作区 */
|
||||
/* 行点击回调（idx=行号；op：0=行体，1=右侧操作区）。 */
|
||||
typedef void (*meow_listview_tap_fn)(int idx, int op, void *ctx);
|
||||
void meow_listview_set_on_tap(meow_widget *lv, meow_listview_tap_fn cb, void *ctx);
|
||||
/* 命中行：置选中 + 回调（若设）+ 返回 idx；未命中返回 -1。 */
|
||||
int meow_listview_tap_at(meow_widget *lv, int x, int y);
|
||||
|
||||
/* ============================================================ */
|
||||
/* §5.8.6 模态（App 层，非系统叠加）：Dialog / BottomSheet
|
||||
* 复用 §5.6 B③ 弹窗 / §5.7 B④ 底部面板模板（与 launcher s_dd_modal 同构），控件化。
|
||||
|
||||
Reference in new issue
Block a user