面向键盘操作的半自动化解决方案

项目地址 https://github.com/XboxYan/auto-keyboard概要这是一个半自动化的键盘访问解决方案，主要适用于需要完全键盘操作场景，比如大屏展示，电视，游戏菜单等，大大简化按键操作的逻辑。焦点使用虚拟焦点，也就是通过添加.focus等class实现，而不是原生自带的:focus，更利于定制化需求。基于HTML页面。比较冷门，键盘交互方向，不感兴趣的可以跳过。半自动化由于实际场景复杂多样，过于全反而会让业务代码更繁杂。该功能插件仅针对于局部实现自动化操作，整体页面布局仍需开发者手动协调。具体是指开发者需要手动讲页面分为几块逻辑区域，比如下方的键盘区和搜索列表区。然后对每块区域分别调用new View()即可<div class=“search_keyborad” id=“search”> <a data-key=“A”>A</a> <a data-key=“B”>B</a> …</div><ul class=“search_list” id=“list”> <li class=“search_item”> <img src="" > <h3>人类DNA密码破译</h3> </li> …</ul><script type=“text/javascript” src="./js/smoothscroll.min.js"></script><script type=“text/javascript” src="./js/base.js"></script><script type=“text/javascript” src="./js/view.js"></script>var S = $(‘search’); var L = $(’list’);var V = new View(S);var Vl = new View(L);V.init(S.getElementsByTagName(‘a’));Vl.init(L.getElementsByTagName(’li’));V.onfocus();这样，每块区域的按键都已经自动适配了。API通过new View(#container)适配的区域，可获焦元素可以是常见的n*m分布，也可以是绝对定位的任意布局。通过V.init(children)来初始化可获焦子元素，传入nodeList即可，与页面层级无关。new View(container)核心方法。创建一个区域，传入参数为页面的一个容器。var con = document.getElemetById(‘con’);var V = new View(S);V.init(nodeList)初始化，传入参数为需要获焦的子元素，通常使用getElementsByTagName来一次性传入多个。该方法需要等待页面加载完全后使用，也就是说当动态加载网络数据时，需等待只元素加入容器之后调用V.init(S.getElementsByTagName(‘a’));//动态数据ajax({ url:‘XXX’, sunccess:function(data){ var html = ‘’; for(var i=0;i<data.length;i++){ html+=’<a>’+data[i]+’</a>’; } S.innerHTML = html; V.init(S.getElementsByTagName(‘a’)); }})可以传空。此时表示该区域里面没有可获焦元素，常见场景为新闻类，此时该区域可以自动实现上下浏览的功能。V.insertAfter(nodeList)向后追加子元素。常见场景为上拉加载，追加下一页等功能。ajax({ url:‘XXX’, sunccess:function(data){ var html = ‘’; for(var i=0;i<data.length;i++){ html+=’<a>’+data[i]+’</a>’; } M.innerHTML = html; V.insertAfter(M.getElementsByTagName(‘a’)); }})V.insertBefore(nodeList)与insertAfter相反，向前追加子元素。V.onfocus()主动聚焦，当有多个区域时，可选择控制。var V = new View(S);V.onfocus();Calback这一部分是对按键的回调V.ok回车、确定。Vi.ok = function(item){ console.log(item)//当前获焦元素的dom节点}当按下确定时，会给当前获焦元素添加pressIn类，抬起时移除，可自定义按下效果。V.left、V.right、V.up、V.down向左/右/上/下（处于边界时）。当获焦元素处于区域边界时触发。一般用于跨越区域。Vl.left = function(){ V.onfocus();//此时Vl会自动失去焦点，V会主动获焦}当处于边界时，如果没有指定触发回调，比如V.left，会给当前获焦元素添加shake类，这是一个颤抖动画，300ms自动移除。V.back返回。当按返回键时触发。V.move移动时触发，回调参数为移动之前的元素，和移动之后的元素。V.move = function (prev, current) { //prev移动之前 //current移动之前后}propsV.saveCurrent是否保留当前状态，类名为current。一般用作tab切换时跟随。默认为false。V.saveCurrentDelay是否保留当前状态，类名为current。一般用作tab切换时跟随，但是需要点击ok触发。默认为false。V.scrollAnimate是否启用滚动动画。该功能使用smoothscroll.js完成，如果不支持该插件，可禁用滚动动画。案例https://portal.codelabo.cn/接口已失效（业务已停止），可查看源代码，效果实现的是一个tab切换的页面，有两个接口获取数据结语目前市面上并没有什么对键盘操作封装的库，键盘什么的这个方向确实比较窄，或者说比较冷门，希望能够帮助特定的人群吧。有这方面兴趣的欢迎交流，一起讨论。