JavaScript如何编写可访问性代码?

雨伟君_6726

雨伟君_6726

2025-12-20

991人浏览

原创

可访问性友好的JavaScript核心是不干扰、可感知、可操作、可理解:使用语义化HTML元素,同步设置ARIA属性,确保键盘导航与焦点管理,用live region通知状态变化,响应系统辅助偏好,并全程以残障用户视角测试。

javascript如何编写可访问性代码?

编写可访问性(Accessibility)友好的 JavaScript 代码,核心是不破坏屏幕阅读器、键盘导航和辅助技术的正常工作,同时主动增强残障用户的交互体验。关键不是“加功能”,而是“不干扰、可感知、可操作、可理解”。

确保所有交互元素有语义化 HTML 基础

JavaScript 不应凭空创建不可访问的控件。按钮就用 ,链接就用 ,下拉菜单用 或带 role="combobox" 的结构。避免用

模拟按钮——它默认无法聚焦、没有角色、不响应空格/回车键。
  • 用 button 替代 div + click:浏览器自动处理焦点、键盘事件(空格/回车触发)、ARIA 默认角色
  • 动态插入内容时,同步设置 role、aria-* 属性。例如展开面板后,给目标区域加 aria-expanded="true" 和 aria-hidden="false"
  • 表单控件必须有 label(显式 for/id 关联或包裹式),JavaScript 提交前校验失败时,用 aria-invalid="true" 和 aria-describedby 指向错误提示

支持完整的键盘导航与焦点管理

屏幕阅读器用户和仅用键盘操作的用户依赖 Tab 键顺序和焦点可见性。JavaScript 常见问题包括:弹窗打开后焦点未进入、关闭后未返回原位置、模态框外内容仍可聚焦。

  • 模态框打开时,用 element.focus() 将焦点移到第一个可聚焦项(如标题或首输入框)
  • 限制模态框内 Tab 循环:监听 keydown,捕获 Tab 键,当焦点在最后一项且按 Shift+Tab 时,跳转到第一项;反之亦然
  • 关闭模态框后,用 triggerElement.focus() 把焦点还原到触发它的按钮上(需提前保存引用)
  • 避免使用 outline: none 移除默认焦点轮廓——改用更美观但清晰的 outline 样式,或仅在 :focus-visible 下定制

及时通知状态变化(尤其动态内容)

屏幕阅读器不会自动朗读 DOM 变化(如加载完成、提交成功、错误提示出现)。需通过 ARIA live regions 主动“广播”。

DeepBI DHTML 页面生成器
DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur

下载
  • 在页面顶部添加隐藏的 live region:
  • JavaScript 更新状态时,向该容器写入文本(如 liveRegion.textContent = "密码已复制到剪贴板"),屏幕阅读器会自动朗读
  • 操作成功/失败反馈优先用 live region,而非仅靠颜色或图标——红色文字对色觉障碍者无效,小图标对低视力用户不可读
  • 长时间操作(如上传)显示进度条,并同步更新 aria-valuenow、aria-valuemin、aria-valuemax

尊重用户偏好与系统设置

现代浏览器和操作系统提供减少动画、高对比度、强制颜色等辅助选项。JavaScript 应检测并响应这些偏好。

  • 检测减少动画:if (window.matchMedia('(prefers-reduced-motion: reduce)').matches) { /* 跳过 CSS transition / JS 动画 */ }
  • 检测高对比度模式:if (window.matchMedia('(forced-colors: active)').matches),此时避免依赖背景色传达信息,改用文字、图标或边框
  • 禁用自动轮播或定时跳转:提供 pause 按钮,并在用户首次交互后停止自动播放
  • 不覆盖用户缩放:避免固定像素字号(如 font-size: 12px),用 rem 或 %,确保文字在 200% 缩放下仍可读、不溢出

可访问性不是附加功能,而是基础要求。从 HTML 结构出发,用 JavaScript 补足语义与行为,而不是绕过它。测试时关掉屏幕阅读器听一遍,全程只用键盘操作一遍,比任何代码检查都管用。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

2024.01.03

4696

7

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

2025.12.06

326

9

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

5076

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

1475

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1958

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

10603

11

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1080

4

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3224

5

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.14

1689

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程