You need to enable JavaScript to run this app. SAPUI5与屏幕阅读器适配的重复播报、冗余控件播报问题解决方案咨询
优惠活动
大模型
产品
解决方案
定价
更多

SAPUI5与屏幕阅读器适配的重复播报、冗余控件播报问题解决方案咨询

SAPUI5 多端屏幕阅读器冗余播报适配方案

安卓端带图标Button重复播报问题

根因

sap.m.Button内置的图标DOM元素会自动读取icon参数对应的内置语义名称(本例中sap-icon://action-settings默认可访问名即为"Settings"),同时你通过ariaDescribedBy关联的InvisibleText文本也为"Settings",安卓Chrome的Voice Assist不会对重复的可访问名称做自动去重,因此会连续播报两次。iOS Safari的Voiceover会自动合并同类可访问属性,因此表现正常。

修复方案

  • 显式指定按钮的可访问名称,同时将内部图标设为对屏幕阅读器隐藏,避免重复读取
    修改后XML示例:
    <core:InvisibleText id="ariaSettings" text="{i18n>ariaSettings}"/>
    <Button id="btnSettings" 
            icon="sap-icon://action-settings" 
            press=".onSettings" 
            ariaLabelledBy="ariaSettings"
    />
    
    在控制器的onAfterRendering钩子中给内部图标DOM添加隐藏属性:
    onAfterRendering: function() {
      const oBtn = this.byId("btnSettings");
      if (oBtn?.getDomRef()) {
        // 定位按钮内部的图标DOM元素
        const oIconDom = oBtn.getDomRef().querySelector(".sapMBtnIcon");
        oIconDom?.setAttribute("aria-hidden", "true");
      }
    }
    
  • 若需要保留额外的描述提示,可将核心可访问名用ariaLabelledBy指定,ariaDescribedBy仅存放与核心名不重复的补充操作说明,避免重名导致重复播报。

sap.m.GenericTile 优先播报控件类型名问题

根因

sap.m.GenericTile默认会将自身控件类型("Generic Tile")写入可访问语义中,部分屏幕阅读器会优先播报该类型前缀,导致冗余。

修复方案

  • 显式指定自定义可访问名称,覆盖默认的类型播报
    XML示例:
    <core:InvisibleText id="tileAriaName" text="销售数据概览"/>
    <GenericTile id="salesTile" 
                  header="销售数据概览"
                  ariaLabelledBy="tileAriaName"
    />
    
    可在onAfterRendering中进一步修改DOM角色,移除默认的类型提示:
    onAfterRendering: function() {
      const oTile = this.byId("salesTile");
      if (oTile?.getDomRef()) {
        // 替换默认角色为通用可点击元素角色,避免播报"Generic Tile"类型名
        oTile.getDomRef().setAttribute("role", "button");
        // 移除默认的冗余描述属性
        oTile.getDomRef().removeAttribute("aria-describedby");
      }
    }
    
  • 优先评估升级SAPUI5版本至1.90+,该版本官方已优化多数控件的默认可访问语义,减少冗余类型播报。

SAPUI5 通用隐藏冗余播报的实现方法

SAPUI5没有提供直接的aria-hidden属性配置,可通过以下三种通用方式实现:

  • 给纯装饰类的内部元素绑定自定义属性:通过core.CustomData实现,仅对非交互的装饰元素生效,示例:
    <core:Icon src="sap-icon://separator">
      <core:CustomData key="aria-hidden" value="true"/>
    </core:Icon>
    
  • 注意:禁止给可交互的根控件(如按钮、可点击Tile)直接设置aria-hidden="true",否则会导致整个控件对屏幕阅读器不可访问。
  • 控件渲染完成后通过onAfterRendering钩子直接修改DOM的aria相关属性,是多端适配最灵活的方式,注意在控件销毁时清理绑定避免内存泄漏。
  • 全局适配场景可使用sap/ui/core/Accessibility模块的扩展配置,统一修改特定控件的默认可访问语义,无需逐个修改视图代码。

内容的提问来源于stack exchange,提问作者ajsnub

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 15:06:05