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
相关产品推荐
相关产品推荐

