SuperAPI AI 工具集

ui5-best-practices-smart-controls

通用与其它

查看项目

更新于 10-16 01:06

技能介绍

用途:在自由式应用中使用 OData V2 服务时,为生成、审查或排查 UI5 smart control 代码提供规范。UI5 版本基线为 SAPUI5 1.136+ LTS。

主要能力:按主题提供参考文档,包括 SmartField、SmartForm、SmartFilterBar、SmartChart、SmartLink、SmartMultiInput、FilterBar、ValueHelpDialog;并给出选择矩阵(何时使用/不使用各控件)与常见错误症状、原因、修复对照。

必要规则:Smart 控件必须指定 entitySet 或继承可解析实体类型的绑定上下文;SmartFilterBar 字段覆盖在 XML 中用 ControlConfiguration(control type、filter type、index),运行时仅可改 visible、label、visibleInAdvancedArea;层级为 SmartForm > Group > GroupElement > SmartField,不得将 SmartField 直接放入 SmartForm;程序访问内部控件需等 initialise 事件;OData V2 绑定须用 sap.ui.model.odata.type.,不得用 sap.ui.model.type.;SmartFilterBar 与 SmartChart 需设 ariaLabelledBy 指向可见标题;提交前用 SmartForm.check() 做必填校验;用 get_api_reference 核对 API,用 run_ui5_linter 校验代码。

禁止项:Smart 控件不用于 OData V4(改用 sap.ui.mdc);不在 SmartField value 上设自定义 formatter;不在 SmartField 上用复合绑定 parts:[...];不在初始化时同步调用 getChart()(用 initialise 事件或 getChartAsync());不直接改 SmartChart/SmartTable 内部控件;不硬编码字段标签(用 sap:label 或 @Common.Label);不使用内联样式或脚本(CSP);不使用全局访问(用 sap.ui.define 或 ES6 import)。

限制:资料未提供安装命令、收费、平台或效果说明;相关功能与 API 以 SAPUI5 1.136+ LTS 为准。