Web Accessibility Academy · 课时

使用按钮和 aria-expanded 构建折叠面板

构建能播报展开和收起状态的 раскры示控件。

第 3 / 4 课13 个步骤

使用按钮和 aria-expanded 构建折叠面板 是 CoddyKit 上的免费 Web Accessibility Academy 课时。 这是第 3 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Web Accessibility Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Web Accessibility Academy 课程共包含 4 节课。

手风琴组件的作用

手风琴组件是一组可以展开和收起的标题,用于显示内容。与选项卡不同,每个区块都可以独立打开。

标题应使用按钮

请让每个手风琴标题都成为真正的按钮。按钮可以获得焦点,支持 Enter 和空格键,并且会自动向屏幕阅读器宣布自身。

<button>Shipping details</button>

使用 div 作为标题会失败

请注意,不要使用可点击的 div 作为标题。它无法获得焦点,也不会响应键盘操作,并且不会向辅助技术说明自己的作用。

<div onclick="toggle()">Shipping details</div>

aria-expanded 是关键

请将 aria-expanded 添加到按钮上,让屏幕阅读器宣布内容是收起还是展开的。这个状态正是手风琴组件实现无障碍访问的关键。

<button aria-expanded="false">Shipping details</button>

点击时切换状态

用户激活按钮时,请在 true 和 false 之间切换 aria-expanded。它必须始终与面板是否实际显示保持同步。

btn.setAttribute("aria-expanded", String(open));

指向区域

在按钮上使用 aria-controls,并将其值设为按钮打开的面板的 id。这样,用户就能知道该标题会显示哪些内容。

<button aria-controls="sec1" aria-expanded="false">More</button>

隐藏收起的面板

区块关闭时,请为其面板添加 hidden 属性。这样面板会从页面和无障碍树中移除,直到再次打开。

<div id="sec1" hidden>Panel content</div>

将标题包裹在真正的标题元素中

请将每个按钮放在真正的标题元素中,例如 h3。屏幕阅读器用户就能通过标题导航在各个区块之间跳转。

<h3><button aria-expanded="false">FAQ</button></h3>

单个 disclosure 不需要 ARIA

单独的显示与隐藏控件属于披露组件,而不是选项卡组。它只需要一个带有 aria-expanded 的按钮,完全不需要 tablist 或 tab 角色。

让焦点停留在按钮上

切换后,请将焦点留在用户刚刚按下的按钮上。不要把焦点强行移入面板,这会让键盘用户感到意外。

为什么 aria-expanded 很重要

由于按钮本身携带状态,屏幕阅读器每次都会说出“已展开”或“已收起”。用户始终知道激活按钮后会发生什么。

快速检查

您正在构建一个可以打开和关闭区块的手风琴标题。哪个属性可以让它的状态变得可访问?

回顾:无障碍手风琴组件

您已经学会了:手风琴标题应是一个带有 aria-expanded 的按钮,并且放在标题元素中。切换状态、指向面板,并在关闭时将其隐藏。

免费开始

用 AI 导师学习 HTML — 免费

在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。

课程
30
课程
120

常见问题解答

「使用按钮和 aria-expanded 构建折叠面板」课时是免费的吗?

是的 — 「使用按钮和 aria-expanded 构建折叠面板」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Web Accessibility Academy 课程的其余内容,请升级到 CoddyKit PRO。 Web Accessibility Academy 课程共包含 4 节课。

「使用按钮和 aria-expanded 构建折叠面板」这节课中我会学到什么?

构建能播报展开和收起状态的 раскры示控件。 你通过在浏览器中直接运行的动手代码来练习 Web Accessibility Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

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

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

「使用按钮和 aria-expanded 构建折叠面板」课时需要多长时间?

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

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

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

此课程中的所有课时

  1. 选项卡模式:tablist、tab、tabpanel
  2. 使用方向键在选项卡之间导航
  3. 使用按钮和 aria-expanded 构建折叠面板
  4. раскры示控件还是选项卡:选择合适的模式
← 返回 Web Accessibility Academy