无障碍js插件

作者: 图恩分类: 编程开发阅读: 714发布时间： 2021-06-26 06:30:38

无障碍插件

这是一个针对于有视障、听说障碍、读写障碍、肢体障碍，机体功能衰退的老年人群开发的一个辅助插件使用网站的js插件

插件地址： https://github.com/duheng/assist

插件接入方式：

1 - 在页面合适的地方如banner处加入id为 assist-open 的标签
2 - 在页面底部 body 之前引入插件；
3 - 如果需要特殊处理的地方使用后面的API做对应处理;

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>墨子工程</title>
</head>
<body>
<div id='assist-open'>无障碍</div>
<script type="text/javascript" src="dist/assist-entry.js"></script>
</body>
</html>

API

showTag; 用于打开无障碍标识，（点击无障碍后并不在当前页面打开，而是跳转到其他没有调用showTag的页面打开）

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>墨子工程</title>
</head>
<body>
<a  id='assist-open' assist-href='https://mozi.com/'>无障碍</a>
<script type="text/javascript" src="dist/assist-entry.js"></script>
 <script>
          ~(function(){
            AssistEntry.showTag() // 如果当前页面点击 无障碍 按钮后需要跳转到其他页面打开无障碍功能，则需要调用此函数做cookie标记
          })()
 </script>
</body>
</html>

zoomState; 返回页面放大倍数

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>墨子工程</title>
</head>
<body>
<a  id='assist-open' assist-href='https://mozi.com/'>无障碍</a>
<script type="text/javascript" src="dist/assist-entry.js"></script>
 <script>
          ~(function(){
              AssistEntry.message.subscribe('zoomState', state => {
                    console.log(`页面放大倍数：${state}`);
              })
          })()
 </script>
</body>
</html>

openState; 返回插件打开状态

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>墨子工程</title>
</head>
<body>
<a  id='assist-open' assist-href='https://mozi.com/'>无障碍</a>
<script type="text/javascript" src="dist/assist-entry.js"></script>
 <script>
          ~(function(){
              AssistEntry.message.subscribe('openState', state => {
                    console.log(`是否开启无障碍模式：${state}`);
             })
          })()
 </script>
</body>
</html>

bigTextState; 大字幕开启状态

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>墨子工程</title>
</head>
<body>
<a  id='assist-open' assist-href='https://mozi.com/'>无障碍</a>
<script type="text/javascript" src="dist/assist-entry.js"></script>
 <script>
          ~(function(){
              AssistEntry.message.subscribe('bigTextState', state => {
                    console.log(`是否开大字幕模式：${state}`);
             })
          })()
 </script>
</body>
</html>

页面标注:

对于插件无法识别或识别不准的标签需业务自行标注，标注规范如下

1 - 对于img标签，需设置 alt ，如

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>墨子工程</title>
</head>
<body>
 <img alt="墨子工程无障碍图片" src="https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fcdn.duitang.com%2Fuploads%2Fblog%2F201306%2F25%2F20130625150506_fiJ2r.jpeg&refer=http%3A%2F%2Fcdn.duitang.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1627139099&t=524628587af020410785e8ba98157609">
</body>
</html>

2 - 对于其他标签，需使用 title 进行标注，如


<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>墨子工程</title>
</head>
<body>
 <div title="墨子工程无障碍">
   墨子工程无障碍
 </div>
</body>
</html>

3 - 对于非语意化标签，需加入 role来标注其真实属性，如果不标注title，则取标签内容，如

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>墨子工程</title>
</head>
<body>
 <div role="button" title="提交">
   提交
 </div>
</body>
</html>

隐藏模块：

对业务中需要隐藏的模块加一个class名 qunar-assist-hide ，插件在打开的时候会自动监测这个class名统一隐藏

页面缩放影响：

随着页面放大，部分非自适应或者绝对定位的组件可能会出现错位问题，需业务开发自行调整

大段文本识别：

对于可能出现大段文本的地方，需要在当前标签加一个名为 qunar-assist-long-text 的class，插件会自动对这个class下的内容进行分割

兼容性

ie10+
所有主流浏览器
火狐（不支持页面放大功能）

其他推荐

Mozi ：一个react-native框架 https://github.com/duheng/Mozi ，此框架采用了小程序的配置部分设计，结合非侵入式编程思想搭建的。在此框架基础上你基本上只需要关注页面开发即可

本文章由javascript技术分享原创和收集