Listbox
选项列表
选项列表是自定义的选择列表。它会管理当前所在的选项，以及方向键如何在列表中移动。
生活中的例子
物流调度员从 180 个可搜索的结果中选择一个仓库。方向键可移动选项，Enter 可确认。筛选后，屏幕阅读器仍会读出已选仓库；短而固定的列表则应改用内置的 `<select>`。
主要部分
- 01列表容器
- 02当前选项
- 03选中状态
什么时候用
只有内置的 `<select>` 无法处理搜索、较丰富的选项或多选需求时，才制作自定义选项列表。
什么时候不要用
不要在选项里放按钮、链接或其他可以单独操作的控件。
代码里的名称
role=listbox + role=option + aria-selected + roving focus/aria-activedescendant 上线前要检查
每个字段都要有程序能读到的标签。关联提示与错误，并保留已输入内容。检查自动填充、键盘顺序、验证时机、提交状态、失败恢复、缩放与多语言。
预期结果：使用 选项列表 (Listbox) 解决这项需求，同时保留用户当前的操作上下文。 用户场景：物流调度员从 180 个可搜索的结果中选择一个仓库。方向键可移动选项，Enter 可确认。筛选后，屏幕阅读器仍会读出已选仓库；短而固定的列表则应改用内置的 `<select>`。 建议界面模式：选项列表 (Listbox)。 适用理由：只有内置的 `<select>` 无法处理搜索、较丰富的选项或多选需求时，才制作自定义选项列表。 不应使用的情况：不要在选项里放按钮、链接或其他可以单独操作的控件。 产品要求：定义默认、加载、没有内容、错误、成功与恢复状态。保留用户已输入的内容，每个操作后都提供清楚反馈。 无障碍与韧性：使用结构正确的 HTML（语义化 HTML）和完整键盘操作。焦点要清楚可见，布局缩放后仍要好用。也要提供减少动态效果。遵守项目现有规则。除非项目已采用，否则不要新增界面组件库。 验收标准：主要任务可只用键盘完成，在 320px 宽度也能正常使用。焦点与状态变化可被辅助工具读出。加载、失败、重试、取消与减少动态效果都已验证。 证据与限制（证据边界）：它只代表该来源的官方说法。其他平台或团队可能有不同用法。 待确认：产品文字、数据来源、分析事件、支持设备与语言，以及平台特有限制。
检查这份需求
请 AI 编程助手检查当前如何使用 选项列表 (Listbox)。 定义：选项列表是自定义的选择列表。它会管理当前所在的选项，以及方向键如何在列表中移动。 生产环境检查：每个字段都要有程序能读到的标签。关联提示与错误，并保留已输入内容。检查自动填充、键盘顺序、验证时机、提交状态、失败恢复、缩放与多语言。 修改程序前，先列出看到的证据、缺口、严重程度，以及最小且安全的修正。