issue(a11y): the model picker can’t take keyboard focus inside a window, such as Default models in New Group

问题场景

在 Open WebUI 管理面板中依次进入 Admin Panel > Users > Groups，点击 New Group 打开新建分组弹窗。弹窗内含有 Default models 模型选择器：用 Tab 定位到该控件并按 Enter 打开后，列表弹出且第一个模型处于高亮状态，但键盘焦点仍留在弹窗中该按钮上。此时输入字母不会过滤列表，继续按 Tab 会把焦点移到列表后面的 Group Description 等字段，而列表保持打开。同一个选择器在聊天窗口外（无弹窗包裹）时，键盘操作正常。

报错原文

issue(a11y): the model picker can't take keyboard focus inside a window, such as Default models in New Group

原因分析

根据 Issue 正文的定位，原因是弹窗组件 common/Modal.svelte 的焦点陷阱逻辑：它只在焦点目标位于 menu 或 listbox 内部时，才允许焦点进入渲染在弹窗内容之外的浮层。模型选择器的搜索框是一个 combobox，既不属于 menu 也不属于 listbox，因此焦点陷阱会把它“推回”弹窗内部。结果是列表视觉上已展开但无法接收键盘输入，Tab 顺序也仍沿弹窗表单字段推进。该结论为 Issue 作者基于代码的定位，未经维护者确认的修复验证，具体实现细节以对应版本源码为准。

环境排查

• 确认 Open WebUI 版本/提交，Issue 复现于 dev 分支 3b8205505；报告中同时说明在最新 release 与 dev 分支上均已复现。
• 确认安装方式为 Git Clone，默认配置，未涉及自定义环境变量或前端构建改动。
• 确认浏览器为 Firefox，操作系统为 Linux。
• 确认复现路径为管理面板 Users > Groups 的 New Group 弹窗；作为对照，在聊天中（不经弹窗）使用同一选择器，键盘操作应正常。
• Python、CUDA、PyTorch、显卡、Ollama 相关版本与前端焦点逻辑无直接关联，Issue 未提供，此处无需排查。

解决步骤

1. 先按 Issue 步骤稳定复现：Admin Panel > Users > Groups > New Group，Tab 到 Default models 后按 Enter，输入字母观察列表是否过滤，再按 Tab 观察焦点去向。
2. 记录对照结果：在聊天界面（不在弹窗中）使用同一模型选择器，确认键盘输入过滤正常，以排除浏览器或输入法层面的问题。
3. 可优先尝试的临时绕过：打开列表后直接用鼠标点击选择器内部的搜索框再输入；或直接鼠标点选模型，避免依赖键盘焦点。
4. 如具备开发条件，可检查当前版本 common/Modal.svelte 的焦点陷阱判定逻辑，确认是否仍仅将 menu/listbox 视为可脱离弹窗的焦点目标；Issue 未给出补丁，修改前应以官方后续提交为准，不建议在未经验证的情况下自行改源码用于生产环境。
5. 关注 Issue #33024、#33056 等关联问题的处理进展，它们涉及同一模型选择器的键盘可达性与关闭后的焦点回归，通常会在同一轮修复中覆盖。

验证方法

在弹窗中的 Default models 选择器上用键盘重新走一遍完整流程：Enter 打开后焦点应进入搜索框、输入即可过滤列表、Tab 不应跳到列表背后的字段、按 Escape 或选定模型关闭后焦点应回到触发按钮。同时确认聊天中的同一选择器键盘操作未出现回归。Issue 关闭时未提供已验证的修复提交，实际修复效果需以官方修复版本为准。

参考来源

open-webui/open-webui #33364

关联：#33024、#33056（由机器人评论在 Issue 中列出）

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。