which-key.nvim
项目核心内容总结:
WhichKey 是一个 Neovim 插件,用于实时显示按键提示,帮助用户快速查找和执行自定义快捷键。
功能与特性:
- 动态按键提示:通过自定义触发器(如
<leader>)或模式切换事件自动弹出提示窗口,支持延迟显示(如操作符模式下按键后显示)。 - 灵活配置:
- 支持自定义映射(如
wk.add定义快捷键、分组、动态子菜单)。 - 可设置图标(需安装
mini.icons或nvim-web-devicons),图标颜色、类别、高亮可自定义。
- 支持自定义映射(如
- 高级特性:
- Hydra 模式:保持提示窗口持续显示,直至按
<esc>退出。 - 内置插件:提供常见操作(如窗口切换、文件搜索)的快捷键提示,支持书签、寄存器、拼写建议等功能。
- Hydra 模式:保持提示窗口持续显示,直至按
- 可视化与交互:
- 提供丰富的高亮主题(如
WhichKeyDesc、WhichKeyGroup等)。 - 支持键盘导航(如
<bs>返回上一级、<c-d>/<c-u>滚动)。
- 提供丰富的高亮主题(如
使用方法:
- 定义映射:通过
wk.add添加快捷键、分组、动态子菜单。 - 配置触发器:设置
opts.triggers指定触发模式(如n、v)。 - 调整延迟:通过
opts.defer函数控制特定模式下是否延迟显示。 - 启用插件:如拼写建议需手动开启
opts.icons.mappings。