开源推荐
morning
GitHub 热门项目:keyux
2026-11-18
1 阅读
约6分钟阅读
GitHub Trending
字号:
GitHub 项目:keyux
仓库地址:https://github.com/ai/keyux
星级:550 | 作者:艾
项目描述:改善 Web 应用键盘 UI 的 JS 库
===================================================
自述文件内容:
#KeyUX
JS 库,用于改进 Web 应用程序的键盘 UI。它的设计不仅
对于**a11y**,还可以创建用户喜欢的**专业工具**
使用键盘。
- 添加 **热键** 和 `aria-keyshortcuts`。
- 按下热键时显示按钮的“:active”状态。
- 在`role =“menu”`列表中启用**使用键盘箭头导航**。
- 根据 `aria-controls` 跳转到下一节并返回
使用 Esc。
- 显示和隐藏 `role="menu"` 的子菜单。
- 允许用户**覆盖热键**。
- **2 KB**(缩小并压缩)。没有依赖性。
- Vanilla JS,可与任何框架配合使用,包括 React、Vue、Svelte。
````jsx
导出 const Button = ({ 热键, 子项 }) => {
返回(
<按钮 aria-keyshortcuts={热键}>
{孩子}
{likelyWithKeyboard(窗口) && {getHotKeyHint(窗口, 热键)}}
按钮>
)
}
````
请参阅[演示页面](https://ai.github.io/keyux/)
和[示例](./test/demo/index.tsx):
https://github.com/user-attachments/assets/bcd78271-cf76-45a3-8beb-4f3cea69c143
---
- [安装](#install)
- [热键](#hotkeys)
- [热键提示](#hotkeys-hint)
- [按下状态](#pressed-state)
- [热键覆盖](#hotkeys-override)
- [列表热键](#hotkeys-for-list)
- [Mac 上的 Meta 代替 Ctrl](#meta-instead-of-ctrl-on-mac)
- [焦点小组](#focus-groups)
- [`focusgroup` 属性](#focusgroup-attribute)
- [菜单](#menu)
- [列表框](#listbox)
- [表列表](#tablist)
- [工具栏](#toolbar)
- [焦点跳跃](#focus-jumps)
- [嵌套菜单](#nested-menu)
---
KeyUX 由 Evil Martians 构建,这是一家为开发者工具、人工智能和网络安全初创公司提供服务的美国设计和工程咨询公司。
---
## 安装
````嘘
npm 安装 keyux
````
然后将具有必要功能的“startKeyUX”调用添加到主 JS 文件中。
````js
导入{
隐藏的KeyUX,
热键KeyUX,
热键覆盖,
跳转键UX,
focusGroupKeyUX,
focusGroupPolyfill,
按KeyUX,
启动键UX
} 来自 'keyux'
常量覆盖 = hotkeyOverrides({})
startKeyUX(窗口, [
hotkeyKeyUX([覆盖]),
focusGroupKeyUX(),
focusGroupPolyfill(),
pressKeyUX('被按下'),
跳转KeyUX(),
隐藏KeyUX()
])
````
## 热键
当用户按下热键时,KeyUX 将单击该按钮或链接
在 `aria-keyshortcuts` 中使用相同的热键。
例如,如果用户按下,KeyUX 将单击此按钮
Alt+B 或 ⌥ B。
````jsx
````
您可以使用热键将焦点移动到文本输入或文本区域:
````jsx
````
热键模式应包含“meta+ctrl+alt+shift+b”等修饰符
按照这个确切的顺序。
要启用此功能,请调用“hotkeyKeyUX”:
````js
从 'keyux' 导入 { hotkeyKeyUX, startKeyUX }
startKeyUX(窗口, [hotkeyKeyUX()
这篇文章对您有帮助吗?
订阅66必读
每日精选科技资讯,直达你的邮箱