使用按钮和 aria-expanded 构建折叠面板
构建能播报展开和收起状态的 раскры示控件。
使用按钮和 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 反馈 — 无需本地设置。
此课程中的所有课时
- 选项卡模式:tablist、tab、tabpanel
- 使用方向键在选项卡之间导航
- 使用按钮和 aria-expanded 构建折叠面板
- раскры示控件还是选项卡:选择合适的模式