无障碍·适老化工具条(EaseBar)
旗舰版商业版功能
校对日期:2026-09-24。需要商业版旗舰版。
工具条通过一行 <script> 即可接入,无需额外依赖。语音朗读使用浏览器原生 Web Speech API,不向任何第三方发送页面内容。
一、标准与合规依据
| 依据 | 说明 |
|---|---|
| GB/T 37668-2019《信息技术 互联网内容无障碍可访问性技术要求与测试方法》 | 国家标准,规定可感知性、可操作性、可理解性、兼容性四类技术要求,是适老化无障碍评测的首要技术依据 |
| 工信部《互联网网站适老化通用设计规范》(工信部信管〔2021〕18 号附件) | 字体放大、对比度、语音朗读、验证码替代等适老化通用设计要求 |
| 中国互联网协会《互联网网站适老化及无障碍服务水平评测评价体系》 | 官方评测体系(wza.isc.org.cn),技术指标测评 60 分以上方可进入用户满意度评价 |
二、开启
控制台 → 配置 → 站点设置 → 无障碍(需具有“站点设置 → 无障碍”权限;社区版和商业版基础版、标准版、高级版不显示此入口):
| 设置项 | 默认 | 说明 |
|---|---|---|
| 是否开启 | 关 | 开启后本站全部前台页面加载工具条(含静态化页面) |
| 悬浮入口按钮 | 开 | 页面左侧显示悬浮的“无障碍”入口;关闭后仍可通过页头“无障碍”按钮或 Shift+X 打开 |
| 默认展开 | 关 | 首次访问时自动展开工具条;用户关闭后,浏览器会记住该选择 |
| 无障碍声明页地址 | 空 | 本站“无障碍声明/帮助”页面的地址;点击工具条的“说明”按钮可打开该页,留空时显示内置说明弹窗(含快捷键表) |
| 长者版地址 | 空 | 本站长者版或关怀版页面的地址;点击“关怀模式”时跳转到该页,留空时使用内置关怀模式 |
各站点独立保存设置;同一语言组中的站点也需分别设置。修改立即生效(静态化页面在下次生成后生效)。
三、前台表现
- 参考主题的页头导航右侧会显示“无障碍”按钮,点击可展开或收起工具条;开启“悬浮入口按钮”后,页面左侧也会显示入口。
- 工具条展开时页面内容整体下移,不遮挡站点顶部导航。
- 用户的选择(配色、放大档位、语速等)保存在浏览器本地,各站点分别保存。
| 功能 | 快捷键 | 对应评测/规范要求 |
|---|---|---|
| 工具条开关 | Shift+X | 无障碍辅助浏览工具条入口,醒目且便于操作 |
| 关怀模式 | Shift+M | 适老化模式:页面放大至 125% 或以上、增大行距和字距、显示大指针(设置了长者版地址时跳转该页) |
| 指读语音(鼠标指向朗读) | Shift+D | 语音朗读辅助,鼠标移到文本上自动朗读并高亮 |
| 连续朗读(Esc 停止) | Shift+B | 按顺序语音播报页面内容 |
| 声音开关 / 语速三档 | Shift+V / Shift+L | 语音可控制开关与语速 |
| 高对比配色(白底黑字/黄底蓝字/蓝底黄字/黑底黄字) | Shift+G | 高对比度,多配色方案可选 |
| 页面放大/缩小(100%–200% 六档) | Shift+Y / Shift+U | 页面缩放、字体放大 |
| 大指针 | Shift+S | 放大鼠标指针 |
| 十字辅助线 | Shift+F | 帮助低视力用户定位阅读位置 |
| 超大字幕 | Shift+P | 页面底部特大字显示 |
| 纯文本模式 | Shift+W | 去除装饰图片与布局,转为易读纯文本 |
| 重置 / 退出服务 | Shift+R / Shift+X | 一键恢复默认、退出无障碍服务 |
| 使用说明弹窗 | 工具条“说明” | 无障碍说明(GB/T 37668 一级指标“提供无障碍说明”) |
| 区域跳转:主要内容/导航/搜索 | Alt+4 / Alt+2 / Alt+6 | 区域跳转、跳过重复块 |
在输入框或可编辑区域中操作时,快捷键会自动停用,不影响正常输入。
四、主题接入(主题作者)
参考主题已完成接入。自定义主题需分别在页脚脚本区和页头添加以下代码, 并检查商业版级别和功能开关。低于旗舰版的版本不包含该脚本,直接引用会返回 404:
html
[#if config.commercialTier gte 4 && site.accessibility.enabled]
<script src="${ctx}/static/easebar/easebar.min.js?v=${v}"
data-open="${site.accessibility.defaultOpen?c}"
data-entry="${site.accessibility.entryButton?c}"
data-storage-key="easebar:${site.id?c}"
[#if site.accessibility.helpUrl?has_content]data-help-url="${site.accessibility.helpUrl}"[/#if]
[#if site.accessibility.elderUrl?has_content]data-elder-url="${site.accessibility.elderUrl}"[/#if]
defer nonce="${csp_nonce!''}"></script>
[/#if]html
[#if config.commercialTier gte 4 && site.accessibility.enabled]
<button type="button" onclick="window.EaseBar && window.EaseBar.toggle()">无障碍</button>
[/#if]- 区域跳转依赖页面地标:
<main>(或[role=main])、<nav>/<header>、[role=search]内的输入框或input[type=。search] - 脚本加载后可用
window.EaseBar接口:toggle()、open()、close()、set('contrast',、'by') set('zoom',3)、reset()、get()。 - 脚本文件:
ujcms-commercial/(src/ main/ resources/ com/ ujcms/ cms/ commercial/ t4/ static/ easebar/ easebar.js源码、easebar.min.js压缩版)。修改源码后执行npx -y terser easebar.js --compress passes=2 --mangle --comments "/重新生成压缩版。^!/ " -o easebar. min.js - 浏览器支持:Chrome / Edge / Firefox / Safari 现代版本;未安装中文语音包时,中文朗读功能不可用,其余功能不受影响。
五、网站内容自查清单
除接入工具条外,还需依据 GB/T 37668-2019 和评测体系的否决性指标检查网站内容:
- 所有非装饰性图片提供准确的
alt文本; - 表单控件有
<label>或aria-label;验证码提供语音/短信等替代方式; - 页面可全键盘操作,无键盘陷阱,焦点顺序合理、焦点可见;
- 正文与背景对比度 ≥ 4.5:1,文字可放大 200% 不丢失内容;
- 视频提供字幕,音频提供文字稿;不自动播放声音;
- 不使用仅以颜色传达的信息;避免每秒闪烁 3 次以上的内容;
- 提供“无障碍声明/帮助”页面,并在“无障碍声明页地址”中填写链接,供工具条的“说明”按钮使用;
- 弹窗广告可关闭,适老版/关怀版页面无诱导类广告(评测否决项)。