开发实践 · 原创

两键导航与帮助面板:个人站的键盘可达性

V63 给站点加了 Gmail 式两键导航:g 然后 h/a/g/t/w/f/n,八个视图一秒直达;? 呼出快捷键帮助。这篇记录实现里容易踩的四个坑。

结论:两键序列的全部复杂度都在「什么时候不触发」:输入框里、修饰键按着、序列超时,三个否定条件比肯定逻辑更重要。

为什么是 g 前缀

单键直达会和浏览器/输入法抢按键;g 前缀把冲突面收敛到一个键,且 Gmail/GitHub 用户零学习成本。900ms 序列窗口是实测出来的:短了赶不上,长了误触。

实现要点

状态只有一个时间戳:pendingG。keydown 里先判 Escape(关帮助),再判「正在打字/带修饰键」直接放行,再判 ?,最后走序列逻辑。整个模块 60 行。

别打扰输入框

target 是 INPUT/TEXTAREA/SELECT/contentEditable 时一律放行——搜索框里输 gf 是在搜「gf」,不是要去论坛。这条判断放在最前,出错最伤信任。

帮助面板

? 面板列出全部快捷键:固定右下、Esc 或点关闭收起、role=dialog。快捷键不写进帮助等于不存在——可发现性是可达性的一半。

#开发实践 #原创

这篇文章有对应的论坛讨论串:V63 更新日志:论坛上线、拼音首字母搜索与键盘导航

讨论

1 条

评论公开可见,支持 Markdown。后端不可达时本区自动进入只读模式。

  • Randy Hopkins 作者

    欢迎讨论。登录后即可发言,评论公开可见,你可以随时删除自己的评论。这里期待的是围绕文章内容的经验与勘误——我会定期回来逐条处理。

正在加载讨论…