SuperAPI AI 工具集

mobile-report-tables

通用与其它

查看项目

更新于 10-16 09:51

技能介绍

用途:面向移动端报表界面的一条强制 UI 规则——当报表数据可能超过 25 行时,必须渲染为表格,而不是卡片列表,以避免滚动疲劳并保持业务数据的可扫读性,同时适用于 Android(Jetpack Compose)与 iOS(SwiftUI)。适用对象包括报表、分析列表、财务汇总、库存报表、审计日志等可能超过 25 行的数据集;数据保证不超过 25 行或更需用卡片表达状态的高度可视化汇总则不适用。

主要能力:提供表格与卡片的决策矩阵(如单据类 5-20 项、每日汇总 7 天可用卡片;分销商、产品、发票、欠款清单、Top 100 排行必须用表格);给出 Android 可复用的 ReportTable<T>(TableColumn 定义表头、权重、取值 lambda,内置每页 25 条的客户端分页、表头背景、空态)与 iOS ReportTableView<T>(表头、分页按钮、点击回调)模式;强制日期可读化,API 传来的 yyyy-MM-dd 仅用于传输,界面显示须转为 d MMM yyyy,空值显示 -,图表轴可用更短格式;强制所有展示报表或统计的页面支持下拉刷新,Android 用 PullToRefreshBox 且 ViewModel 需暴露 reload()/refresh(),iOS 用 .refreshable;给出竖屏列数限制(3-4 列)与列宽权重建议,5 列以上改为横向滚动;表头文本须用本地化字符串资源,不得硬编码。

使用方式:先读 SKILL.md,再按需加载引用的深入文件;按有序指引、检查清单与决策规则执行,不要只挑零散代码片段;产出需带假设、风险与后续事项。Android 报表页用可滚动 Column(ReportTable 非懒加载组件)包在 PullToRefreshBox 中;分页默认客户端 25 条/页,超过约 1000 行改用服务端 offset/limit。

限制:报告表格密度审计的产出物为 Markdown 文档,示例路径为 docs/mobile/report-table-audit.md;资料未提供收费、价格、平台支持范围及其他功能细节。