0Pricing
Web Accessibility Academy · 课时

正确构建组合框与自动完成

构建屏幕阅读器能够理解的可搜索选择控件。

正确构建组合框与自动完成 是 CoddyKit 上的免费 Web Accessibility Academy 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Web Accessibility Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Web Accessibility Academy 课程共包含 4 节课。

什么是组合框

组合框是与建议弹出框配对的输入框。可以把它想象成搜索框:您输入时,它会下拉显示匹配的结果。🔍

两个部分协同工作

组合框包含一个供用户输入的文本输入框,以及一个单独的选项弹出列表。ARIA 将两者连接起来,让屏幕阅读器能够识别它们的关系。

在输入框上设置角色

请将 role="combobox" 添加到文本输入框本身。这会告诉辅助技术:在这里输入内容将显示一个选项列表。

<input role="combobox" aria-expanded="false"
  aria-controls="results" type="text">

指向弹出框

在输入框上使用 aria-controls,并将其设置为弹出框的 id。这样就能将字段与它打开和关闭的列表框关联起来。

播报打开或关闭状态

列表显示时将 aria-expanded 切换为 true,隐藏时切换为 false。屏幕阅读器会根据该属性播报弹出框的状态。

弹出框是一个列表框

建议项容器使用 role="listbox",每条建议使用 role="option"。这样用户就能使用熟悉且可导航的列表。

<ul id="results" role="listbox">
  <li role="option" id="o1">Apple</li>
</ul>

焦点留在输入框中

关键在于:键盘焦点不会离开输入框。用户可以继续输入,同时使用箭头键在选项之间移动高亮显示。

aria-activedescendant

将输入框上的 aria-activedescendant 指向高亮选项的 id。这样屏幕阅读器就能读出当前选项,而无需移动真实焦点。

<input role="combobox"
  aria-activedescendant="o1">

预期使用的按键

向下和向上箭头键在选项之间移动,Enter 选择当前选项,Escape 关闭弹出框。这些按键的行为直接来自 APG。

标记所选选项

将 aria-selected="true" 设置在高亮选项上,其余选项设置为 false。在单选组合框中,同一时间只能选择一个选项。

自动完成行为

使用 aria-autocomplete 描述建议的显示方式:经过筛选的菜单使用“list”,文本也会在输入框中直接补全时使用“both”。

快速检查

用户正在通过箭头键浏览组合框中的建议。哪个属性会告诉屏幕阅读器当前激活的是哪一项?

回顾

组合框由输入框和列表框组成:使用 aria-controls 和 aria-expanded 将它们关联起来,让焦点留在字段中,并使用 aria-activedescendant 跟踪当前选项。✅

常见问题解答

「正确构建组合框与自动完成」课时是免费的吗?

是的 — 「正确构建组合框与自动完成」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Web Accessibility Academy 课程的其余内容,请升级到 CoddyKit PRO。 Web Accessibility Academy 课程共包含 4 节课。

「正确构建组合框与自动完成」这节课中我会学到什么?

构建屏幕阅读器能够理解的可搜索选择控件。 你通过在浏览器中直接运行的动手代码来练习 Web Accessibility Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Web Accessibility Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Web Accessibility Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。

「正确构建组合框与自动完成」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Web Accessibility Academy 课中编写并运行代码吗?

能。每节 Web Accessibility Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 阅读 APG:模式、按键与示例
  2. 正确构建组合框与自动完成
  3. 菜单、菜单栏与菜单按钮
  4. 树形网格与其他高级模式
← 返回 Web Accessibility Academy