feat(sdk): 控件库第二批 Material 子集(agent-152)
- 新增控件: Button五型(filled/tonal/outlined/text/elevated)/TextField(接IME: round外框idle-outline/focused-primary+占位+光标)/Card/Divider/Badge/Checkbox/Radio/ProgressBar(线圆, value=-1不定)/FAB/TopAppBar(标题+‹返回+动作)/NavigationBar(TabBar pageSwitcher)+TabBar(下划线)/LazyColumn/LazyRow(虚拟化+scroll clamp) - Dialog(B③同构阻塞模态)/BottomSheet(B④), meow_ui_dialog.c - meow_gfx 新增 fill_circle/line/ring_arc(无-lm, COS90象限查表) - 结构体尾缀(对外opaque/calloc归零), 旧字段与create签名零破坏; meow_widget 类型扩到W_TEXTFIELD..W_FAB(17种) - meow_ui.a=18c21da5 hello=5e31d919 launcher=4952261d(重编重链无回归); build_sdk 0warning; 宿主 test_meow_ui_widgets 全PASS+test_sb_collapse PASS+PPM目检正确 - 与 §5.8/§5.2-5.7 一致; 遗留真机观感/性能
This commit is contained in:
MeowOS committed
1 parent
2cb6a7c16f
commit
9c733fcf73
10 files changed
+1360
-24
No files matched your search
@@ -403,6 +403,120 @@ void meow_layout_arrange(meow_widget *layout);
|
||||
/* 固定尺寸空白（也作撑余量；不可见，hit 恒 0）。 */
|
||||
meow_widget *meow_layout_spacer(int w, int h);
|
||||
|
||||
/* ============================================================ */
|
||||
/* §5.8.6 Material 3 组件子集（第二批，基于第一批基座：Options + 状态机 + MD3 色板 + 布局）
|
||||
* 每个组件 = 新增 meow_widget 类型或组合既有模板的便捷函数；复用主题语义色（th->primary /
|
||||
* surfaceContainer / outline / ...）+ 风格参数（radius/radius_card/spacing/stroke_w）+ 通用
|
||||
* Options（meow_widget_set_opts 对它们同样生效）+ 状态机（enabled/selected/pressed/focused）。
|
||||
* 向后兼容：既有 create 签名一字不改；本批只在其上扩展。 */
|
||||
/* ============================================================ */
|
||||
|
||||
/* ---- Button 五型（meow_btn 扩展；既有 meow_btn_create = FILLED）---- */
|
||||
enum {
|
||||
MEOW_BTN_FILLED = 0, /* primary 底 / onPrimary 文 */
|
||||
MEOW_BTN_TONAL = 1, /* secondaryContainer 底 / onSecondaryContainer 文 */
|
||||
MEOW_BTN_OUTLINED = 2, /* 透明底 / primary 文 / primary 描边 */
|
||||
MEOW_BTN_TEXT = 3, /* 透明底 / primary 文 / 无描边 */
|
||||
MEOW_BTN_ELEVATED = 4, /* surfaceContainerLow 底 / primary 文 */
|
||||
};
|
||||
meow_widget *meow_btn_create_variant(int x, int y, int w, int h, const char *label, int variant);
|
||||
int meow_btn_set_variant(meow_widget *w, int variant); /* 越界 clamp；0=成功 */
|
||||
|
||||
/* ---- TextField（单行文本输入，接 IME §5.1）---- */
|
||||
/* placeholder=提示文案；buf=App 持有的文本缓冲（组件不回拷，只绘制/编辑其上）；maxlen=含 NUL 预算 */
|
||||
meow_widget *meow_textfield_create(int x, int y, int w, int h, const char *placeholder,
|
||||
char *buf, int maxlen, meow_ime_mode mode);
|
||||
void meow_textfield_set_placeholder(meow_widget *w, const char *placeholder);
|
||||
/* 聚焦并打开**阻塞** IME（同 meow_ui_text_input 内层轮询）；返回 1=确认 0=取消；buf 已回填 */
|
||||
int meow_textfield_activate(meow_widget *w);
|
||||
const char *meow_textfield_text(meow_widget *w);
|
||||
|
||||
/* ---- Card（圆角容器卡片；surfaceContainerLow 底 + 可选描边/状态层）---- */
|
||||
meow_widget *meow_card_create(int x, int y, int w, int h);
|
||||
/* 内容子控件：绘制时递归绘到卡片内（卡片 hit 仍为矩形；子控件独立命中） */
|
||||
void meow_card_set_content(meow_widget *card, meow_widget *child);
|
||||
|
||||
/* ---- Divider（分隔线；vertical=1 纵向）---- */
|
||||
meow_widget *meow_divider_create(int x, int y, int len, int vertical);
|
||||
|
||||
/* ---- Badge（角标；count=0 红点 / >0 数字 / <0 隐藏；cx,cy=锚点=角标中心）---- */
|
||||
meow_widget *meow_badge_create(int cx, int cy);
|
||||
void meow_badge_set(meow_widget *w, int count);
|
||||
|
||||
/* ---- Checkbox / Radio（勾选态走 meow_widget_set_selected/meow_widget_selected）---- */
|
||||
meow_widget *meow_checkbox_create(int x, int y);
|
||||
meow_widget *meow_radio_create(int x, int y);
|
||||
|
||||
/* ---- ProgressBar（线性/圆形；value=0-100 确定性，-1=不定）---- */
|
||||
meow_widget *meow_progress_create(int x, int y, int w, int h, int value); /* 线性 */
|
||||
meow_widget *meow_progress_circular_create(int cx, int cy, int r, int value); /* 圆形 */
|
||||
void meow_progress_set(meow_widget *w, int value); /* -1=不定 */
|
||||
|
||||
/* ---- FloatingActionButton（悬浮按钮；圆角胶囊，无投影仅状态层近似）---- */
|
||||
meow_widget *meow_fab_create(int x, int y, int size, const char *label);
|
||||
|
||||
/* ---- TopAppBar（顶部标题栏：标题 + 返回 + 动作）---- */
|
||||
meow_widget *meow_topappbar_create(int x, int y, int w, int h, const char *title);
|
||||
void meow_topappbar_set_title(meow_widget *w, const char *title);
|
||||
void meow_topappbar_set_back(meow_widget *w, int on); /* 1=显示返回箭头 */
|
||||
int meow_topappbar_add_action(meow_widget *w, const char *label); /* 返回动作下标 */
|
||||
#define MEOW_TOPBAR_BACK (-2)
|
||||
int meow_topappbar_hit(meow_widget *w, int x, int y); /* MEOW_TOPBAR_BACK=返回 idx>=0=动作 -1=无 */
|
||||
|
||||
/* ---- NavigationBar（底部导航栏）---- */
|
||||
meow_widget *meow_navigationbar_create(int x, int y, int w, int h);
|
||||
int meow_navigationbar_add_item(meow_widget *w, const char *label);
|
||||
void meow_navigationbar_set_selected(meow_widget *w, int idx);
|
||||
int meow_navigationbar_selected(meow_widget *w);
|
||||
int meow_navigationbar_hit(meow_widget *w, int x, int y); /* 返回项下标/-1 */
|
||||
|
||||
/* ---- TabBar（顶部分页页签；swipe 联动 §5.2 由 App 在 on_swipe 驱动）---- */
|
||||
meow_widget *meow_tabbar_create(int x, int y, int w, int h);
|
||||
int meow_tabbar_add_tab(meow_widget *w, const char *label);
|
||||
void meow_tabbar_set_selected(meow_widget *w, int idx);
|
||||
int meow_tabbar_hit(meow_widget *w, int x, int y); /* 返回页签下标/-1 */
|
||||
|
||||
/* ---- 列表容器（LazyColumn/LazyRow：数据源回调 + 可见区虚拟化；复用 meow_list_source）
|
||||
* meow_lazycolumn_create=纵向（item_h=行高）；meow_lazyrow_create=横向（item_w=列宽）。
|
||||
* 滚动由 App 在 on_swipe 里用 meow_list_scroll_by/set_scroll 驱动。 */
|
||||
meow_widget *meow_lazycolumn_create(int x, int y, int w, int h, int item_h, int count,
|
||||
meow_list_source src, void *ctx);
|
||||
meow_widget *meow_lazyrow_create(int x, int y, int w, int h, int item_w, int count,
|
||||
meow_list_source src, void *ctx);
|
||||
void meow_list_set_scroll(meow_widget *w, int offset); /* clamp 到 [0, max_scroll] */
|
||||
int meow_list_scroll(meow_widget *w);
|
||||
int meow_list_max_scroll(meow_widget *w); /* max(0, count*item - viewport) */
|
||||
void meow_list_scroll_by(meow_widget *w, int dy); /* 相对滚动（App on_swipe 用） */
|
||||
int meow_list_set_item_h(meow_widget *w, int item); /* 改行高/列宽 */
|
||||
int meow_list_hit_index(meow_widget *w, int x, int y); /* 命中项下标（含滚动换算）；-1=未命中项/越界 */
|
||||
|
||||
/* ============================================================ */
|
||||
/* §5.8.6 模态（App 层，非系统叠加）：Dialog / BottomSheet
|
||||
* 复用 §5.6 B③ 弹窗 / §5.7 B④ 底部面板模板（与 launcher s_dd_modal 同构），控件化。
|
||||
* 阻塞式（内层 meow_input_pop 轮询，与 meow_ui_text_input 同构）；打开前排空残留触摸。
|
||||
* 关闭途径：点卡片内选项=确认、点卡片外=取消、左缘返回手势=取消。不压状态栏（y 钳制）。 */
|
||||
/* ============================================================ */
|
||||
|
||||
/* ---- Dialog（弹窗：确认/选择/输入/信息）---- */
|
||||
typedef enum { MEOW_DLG_CONFIRM, MEOW_DLG_SELECT, MEOW_DLG_INPUT, MEOW_DLG_INFO } meow_dlg_t;
|
||||
typedef struct meow_dialog meow_dialog;
|
||||
meow_dialog *meow_dialog_create(meow_dlg_t t, const char *title);
|
||||
void meow_dialog_set_items(meow_dialog *d, const char *const *item, int n, int cur); /* SELECT 型 */
|
||||
void meow_dialog_set_ime(meow_dialog *d, meow_ime_ctx *ime); /* INPUT 型 */
|
||||
void meow_dialog_show(meow_dialog *d); /* 阻塞到确认/取消 */
|
||||
int meow_dialog_result(meow_dialog *d); /* SELECT=选项下标；CONFIRM/INFO 确认=1、取消=0 */
|
||||
void meow_dialog_close(meow_dialog *d); /* 程序化关闭（App 亦可驱动） */
|
||||
void meow_dialog_free(meow_dialog *d);
|
||||
/* CONFIRM 型便捷：点「确定」返回 1，取消/遮罩=0 */
|
||||
int meow_dialog_confirm(meow_dialog *d);
|
||||
|
||||
/* ---- BottomSheet（底部面板：标题 + 选项列表；open 阻塞返回选中 idx/-1）---- */
|
||||
typedef struct meow_sheet meow_sheet;
|
||||
meow_sheet *meow_sheet_create(const char *title, int h);
|
||||
int meow_sheet_add_item(meow_sheet *s, const char *label); /* 返回项下标 */
|
||||
int meow_sheet_open(meow_sheet *s); /* 阻塞；返回选中 idx / -1=取消 */
|
||||
void meow_sheet_free(meow_sheet *s);
|
||||
|
||||
/* ============================================================ */
|
||||
/* §9 应用日志（统一日志 API，M2.51 最小可用版） */
|
||||
/* ============================================================ */
|
||||
|
||||
Reference in new issue
Block a user