SuperAPI AI 工具集

ui5-best-practices-tables

通用与其它

查看项目

更新于 10-15 23:39

技能介绍

用途:在生成、审查或排查 UI5 自由式应用的表格代码时提供规范指引,基线为 SAPUI5 1.136+ LTS。

主要能力:按参考资料分文件覆盖 sap.m.Table(ResponsiveTable)、sap.ui.table.Table(GridTable)、sap.ui.table.TreeTable、sap.ui.comp.smarttable.SmartTable、sap.ui.mdc.Table,以及拖放、列个性化、单元格模板与对齐、数据类型绑定等主题。

使用方式:先依据选型矩阵确定表格类型,再加载对应参考文件,不要凭记忆作业。sap.ui.table.* 使用 rows 聚合,sap.m.Table 使用 items,不可互换;个性化统一用 sap.m.p13n.Engine,禁止自建对话框;每个表格设置 ariaLabelledBy 指向标题控件;按数据类型对齐内容(数字与日期 hAlign="End",文本与链接左对齐);sap.ui.table.* 使用 rowMode 聚合(1.119+),需要总数时向后端请求 $count=true。

选型:移动/响应式、JSON 模型、少于 100 行用 sap.m.Table;桌面、1000+ 行、需虚拟化用 sap.ui.table.Table;层级数据用 TreeTable;OData V2 注解驱动的自动列用 SmartTable;OData V4 自由式在排除 Fiori elements 后用 sap.ui.mdc.Table。

限制与禁止:不用全局变量,改用 sap.ui.define 或 ES6 导入;sap.ui.table.* 单元格禁止文本换行(破坏虚拟化);使用 sap.ui.export.Spreadsheet 前先检测库是否可用;移动优先场景不用 sap.ui.table.Table;1000+ 行且需虚拟化时不用 sap.m.Table;一个单元格不放多个交互元素;格式化器不返回枚举对象;ColumnListItem 高亮不用格式化器;不混用类型命名空间(JSON 用 sap.ui.model.type.,OData V2 用 sap.ui.model.odata.type.,V4 用 sap.ui.model.odata.v4.type.*)。文档另列出常见错误现象与修复、有效与无效容器结构、性能反模式及无障碍检查清单。未提供收费、价格与许可信息。