SuperAPI AI 工具集

ui5-best-practices-accessibility

通用与其它

查看项目

更新于 10-15 23:41

技能介绍

用途:该技能面向 SAP UI5 应用开发者,用于审计、检查、审查或改进应用层的无障碍性。UI5 的无障碍由框架与应用两层构成,本技能聚焦应用开发者仍需显式补充的部分。

主要能力:按八个主题检查代码缺口——1) 地标:DynamicPage、Page、Panel、ObjectPage、FlexibleColumnLayout 缺少 landmarkInfo 或 accessibleRole,或设置了地标角色却缺少对应标签;2) 标签:Input 缺少 Label labelFor(SimpleForm 内除外)、Table 缺少 ariaLabelledBy、纯图标 Button 缺少 tooltip、独立 Icon 缺少 alt 且未标记为装饰性、Image 设 decorative=false 却无 alt、Dialog 设 showHeader:false 却无 ariaLabelledBy;3) 标题层级:Title 未显式指定 level、视图内标题层级跳跃;4) 焦点与键盘:Dialog/Popover 需要特定起始元素却无 initialFocus、需要 sap-ui-fastnavgroup CustomData 的复合区域、渲染 HTML 中 tabindex 大于 0;5) 键盘快捷键:保存、删除等操作按钮使用普通 press 却无 CommandExecution;6) 隐形消息:保存确认、错误、筛选结果等动态状态变化仅视觉可见,处理函数中无 InvisibleMessage.announce();7) 阅读顺序:CSS/布局视觉重排但 XML 顺序不符、ariaDescribedBy 指向 DOM 中靠后的 ID;8) 目标尺寸:交互容器内的 Link、ObjectIdentifier、ObjectStatus、ObjectNumber、ObjectMarker、ObjectAttribute 缺少 reactiveAreaMode 或密集布局中缺少间距。

使用方式:若参数列出具体文件则只审查这些文件;否则自动发现 .view.xml、.fragment.xml、.controller.js 源文件(排除 node_modules、dist、test、resources)。发现超过 15 个文件时通过 AskUserQuestion 让用户选择全部审查或聚焦特定目录。逐文件对照八个主题检查,发现缺口时先读取对应主题参考文件再写修复。报告按主题分组,每条包含问题、影响等级(critical/serious/moderate/minor)、原因与最小修复片段,最后按影响等级汇总计数;无缺口则明确说明。

适用场景:UI5 应用的无障碍代码审查与修复。限制:仅覆盖应用层需显式提供的无障碍内容,不替代框架层能力;具体参考文件内容与完整 API 细节以官方资料为准,本资料未提供。