NVDA屏幕阅读器读取动态搜索表单AG Grid结果异常问题求助
问题原因
- 你将
aria-live="polite"属性添加在了包含完整AG Grid的外层容器上,aria-live区域会监听内部所有DOM变更并触发朗读。AG Grid在数据重载时会触发大量内部DOM更新:包括虚拟滚动节点增删、分页控件属性变更、单元格内容重绘、内置ARIA标签更新等,这些非预期的变更都会被live区域捕获,就是你听到随机数字、偶尔朗读全表的原因。 - AG Grid本身内置了无障碍播报逻辑,未禁用的情况下也会触发额外的朗读行为,和外层live区域逻辑冲突。
修复方案
- 拆分aria-live区域,移除外层结果容器的
aria-live属性,仅给需要播报的sr-only提示文本单独设置live区域:
<!-- 外层结果容器仅保留role和id,移除aria-live属性 --> <form action="." aria-controls="queryResultRegion"> <button (click)="loadResults()">加载结果</button> <button (click)="noResult()">加载空结果</button> </form> <div role="region" id="queryResultRegion"> <my-grid [rowData]="rowData"></my-grid> </div>
- 修改结果组件代码,将sr-only提示区和AG Grid节点分离,仅给提示区加
aria-live,同时开启AG Grid的suppressAriaLive配置禁用其内置播报逻辑:
<ng-container *ngIf="rowData"> <!-- 仅提示区域加aria-live,只有这部分内容变更时才会触发朗读 --> <div aria-live="polite" class="sr-only"> <h2 #resultHeader>搜索结果</h2> <div *ngIf="rowData.length < 1; else elseBlock"> 无匹配结果 </div> <ng-template #elseBlock> <div> 结果数量:{{ rowData.length }} </div> </ng-template> </div> <ag-grid-angular style="width: 100%; height: 200px;" class="ag-theme-alpine" [rowData]="rowData" [columnDefs]="columnDefs" [gridOptions]="gridOptions" [suppressAriaLive]="true" > </ag-grid-angular> </ng-container>
- 可选优化:如果不需要屏幕阅读器朗读表格内容,同时保留键盘导航表格的能力,可以给
ag-grid-angular节点添加aria-description属性说明表格用途,避免无意图的全表朗读。
内容的提问来源于stack exchange,提问作者romeozor
相关产品推荐
相关产品推荐

