SuperAPI AI 工具集

accessibility

通用与其它

查看项目

更新于 10-15 22:33

技能介绍

用途:为 UI5 Web Components 应用补充无障碍上下文。组件在 shadow DOM 内已内置 ARIA 角色、键盘导航、屏幕阅读器支持和高对比主题,应用只需通过无障碍 API 提供组件自身无法知道的标签、描述与关系信息。

主要能力:accessibleName 映射 aria-label,适用于无可见文字的场景;accessibleNameRef 跨 shadow DOM 关联一个或多个元素 ID 作为标签,存在可见标签时优先使用;accessibleDescription 及其 Ref 提供额外说明;accessibleRole 在非标准用法时覆盖默认 ARIA 角色;accessibilityAttributes 对象可设置 expanded、hasPopup、controls 等关系属性。

标签关联:因 shadow DOM,标准 label for 不适用于自定义元素,应使用 ui5-label 的 for 属性或 accessibleNameRef。标题层级用 ui5-title 的 level 与 ui5-panel 的 header-level 设置,避免跳级。图标通过 mode 控制:Image 需配 accessible-name、Interactive 可点击、Decorative 对屏幕阅读器隐藏。动态变化用 InvisibleMessage 的 announce,非紧急用 Polite、紧急用 Assertive。提示用 tooltip 属性而非 title。

高对比与主题:提供 sap_horizon、sap_horizon_dark、sap_horizon_hcb、sap_horizon_hcw,可结合 prefers-color-scheme 与 prefers-contrast 媒体查询调用 setTheme 切换。

限制:具体安装与版本信息暂未提供;改动角色仅在组件被非标准使用时进行。