
issue: Screen reader navigation on the main web interface is broken
快速结论:此报错发生在使用屏幕阅读器(如 Orca)导航 Open WebUI 主界面时,键盘无法聚焦到用户菜单、文件上传、工具激活及网页搜索按钮。优先排查是否升级到了 v0.9.6 或更高版本,该问题已在 v0.9.6 中修复。
问题场景
用户在 Debian 13 Gnome 系统上,通过 Docker 运行 Open WebUI(版本 v0.8.11 到 v0.9.2),搭配 Ollama 0.21.0,使用 Firefox 或 Chromium 浏览器,并启用 Orca 屏幕阅读器(在 Wayland 和 X11 显示服务器上均复现)时触发。
报错原文
UI Elements are not accessible with Screenreader from v0.8.11
Keyboard navigation (using Tab or arrow keys) worked perfectly up until version v0.8.10
The user menu (used for logging out or accessing settings) is no longer accessible
The buttons for uploading files, activating tools, and enabling web search cannot be reached via Tab or arrow keys
The screen reader focus jumps directly from the chat input field to the voice input button
原因分析
可能原因:v0.8.11 引入的 UI 更改导致某些交互元素(如用户菜单、文件上传按钮等)失去了正确的键盘聚焦顺序或 ARIA 可访问性标记。社区注意到代码库中多个图像具有空的 alt="" 属性,本该有描述性文字(如用户头像、应用 logo、webhook 头像),这可能导致屏幕阅读器无法正确识别和聚焦这些元素。
环境排查
- 确认 Open WebUI 版本:v0.8.11 至 v0.9.5 存在此问题,v0.9.6 已修复。
- 确认屏幕阅读器:Orca(Linux GNOME 默认)。
- 确认浏览器:Firefox 或 Chromium。
- 确认操作系统:Debian 13 Gnome(Wayland 和 X11 均受影响)。
- 可降级到 v0.8.10 验证问题是否消失,以排除屏幕阅读器自身问题。
解决步骤
- 升级 Open WebUI 到 v0.9.6 或更高版本。这是 Issue 关闭时确认有效的修复版本。
- 如果无法升级,可考虑临时降级到 v0.8.10(该版本导航正常)。
- 若仍需使用受影响版本,检查并更新浏览器的可访问性设置,确保未禁用 ARIA 支持。
- (可优先尝试)对于开发者或高级用户,可检查代码库中图像的
alt属性,为头像、logo 等元素添加适当的描述性文字,并提交 PR。
验证方法
升级到 v0.9.6 后,使用 Orca 屏幕阅读器重新导航 Open WebUI 界面,确认以下操作恢复正常:通过 Tab 键或箭头键能够聚焦到用户菜单(右上角和左下角)、文件上传按钮、工具激活按钮、网页搜索按钮,并且焦点不会直接从聊天输入框跳转到语音输入按钮。同时检查所有图像元素是否被屏幕阅读器正确朗读。



