输入模式
一般来说,启动抓物机后会默认进入命令模式。如果想正常输入,有两种方式:
- 直接退出抓物机。
- 进入输入模式。
如果你希望保持抓物机激活的同时正常输入,可以通过进入输入模式来实现。输入模式会暂时禁用抓物机的功能,使你能够正常输入文本。当你完成输入后,可以通过按 Control + Esc 退出输入模式并返回命令模式。
你可以通过触发 command.enterTextMode 命令进入输入模式。你也可以为这个模式设置一个专门的快捷键。
原始输入模式
Section titled “原始输入模式”原始输入模式是输入模式的一个变体。你可以通过 command.enterRawInputMode 进入原始输入模式,默认命令序列是 I 。
在原始输入模式中,所有输入模式快捷键都会被禁用,包括下方列出的 Nano 风格快捷键。这更适合命令行、Shell、编辑器等需要让前台 app 直接接收完整按键组合的场景。
当安全输入框激活时,macOS 不会让键盘事件流入 Cursor Crane。遇到这种情况时,Cursor Crane 会显示安全输入状态提示。
输入模式提供文本查找快捷键,可以快速把光标移动到匹配的文本上。
默认的查找快捷键是 Control + W 。它会打开查找流程,让你搜索文本并直接跳转到匹配位置。
当没有主动查找词时, Control + N 和 Control + P 仍然可以查找下一个或上一个匹配项,并且会先使用选中文本,再使用光标下的词。
如果光标附近没有可用的词,输入模式也可以使用相邻的单个符号作为查找种子。例如光标靠近 += 时,隐式查找会使用 +,而不是整个 +=。
在使用文本查找时,输入模式现在也可以匹配成对符号的另一半。这个行为对“查找下一个”和“查找上一个”都生效,支持例如 ( 对应 )、[ 对应 ]、{ 对应 },也支持 ' 对应 '、" 对应 " 这样的引号匹配。
查找面板打开时,可以按住 Shift ,从当前选区扩展选择到目标匹配项,而不是用匹配项替换当前选区。这个行为支持 Return 、 Down 和 Up 。在查找面板中按 Control + Shift + Return 可以向上查找并选择到上一个匹配项。
默认快捷键可以在应用设置中查看,也可以按你的习惯自行修改。
Nano 快捷键
Section titled “Nano 快捷键”输入模式现在提供了更丰富的 Nano 风格快捷键层。原始输入模式中不会启用这些快捷键,并且每个快捷键都可以在 Settings > Input 里单独自定义。
Nano 快捷键支持的 action 包括:
| Action | 功能 |
|---|---|
| Exit Input Mode | 退出输入模式并返回命令模式 |
| Move Left | 向左移动一个字符 |
| Move Right | 向右移动一个字符 |
| Move Up | 向上移动一行 |
| Move Down | 向下移动一行 |
| Move To Line Start | 移动到当前行行首 |
| Move To Line End | 移动到当前行行尾 |
| Move To Previous Word | 移动到上一个单词 |
| Move To Next Word | 移动到下一个单词 |
| Move To Document Start | 移动到文档开头 |
| Move To Document End | 移动到文档结尾 |
| Delete Backward | 删除前一个字符 |
| Delete Forward | 删除后一个字符 |
| Delete To Line Start | 删除到当前行行首 |
| Delete To Line End | 删除到当前行行尾 |
| Scroll Cursor To Visible Center | 把文本光标滚动回当前可见区域中央 |
| Select Text At Cursor | 选中文本光标所在位置的文本 |
| Move Mouse To Cursor | 把鼠标移动到当前文本光标位置 |
| Left Click Cursor | 在当前文本光标位置执行左键点击 |
| Command Left Click Cursor | 在当前文本光标位置执行 Command + 左键点击 |
| Option Left Click Cursor | 在当前文本光标位置执行 Option + 左键点击 |
| Control Left Click Cursor | 在当前文本光标位置执行 Control + 左键点击 |
| Right Click Cursor | 在当前文本光标位置执行右键点击 |
| Move Cursor To Visible Middle Line Start | 把文本光标移动到当前可见区域中线所在行的行首 |
| Find Text | 打开文本查找 |
| Find Next | 选择下一个查找匹配项 |
| Find Previous | 选择上一个查找匹配项 |
| Select To Find Next | 扩展当前选区到下一个查找匹配项 |
| Select To Find Previous | 扩展当前选区到上一个查找匹配项 |
| Toggle Regex Find | 在查找面板打开时切换正则查找 |
| Show Cursor Position | 显示当前文本光标所在的行号和列号 |
这个页面不再列出默认快捷键绑定。若要查看当前实际绑定,请直接前往 Settings > Input,尤其是在你已经自定义过快捷键的情况下。
Page 键
Section titled “Page 键”输入模式会把普通的 Page Up 和 Page Down 留给前台编辑器处理。
按住 Control 再按 Page Up 或 Page Down ,可以按编辑器可见高度的一半滚动。这样既能保留编辑器原生 Page 键行为,也能获得更小、更可预测的滚动距离。
按住 Option 再按 Page Up 或 Page Down ,可以让文本光标按设置的行数移动。如果目标行在可见区域外,输入模式会将它滚动到可见区域中。行数可以在 Settings > Input 中调整。
如果当前聚焦控件是文本区域,你可以通过 command.createTextAreaPortal 把内容打开到外部编辑器中。
在 Settings > Input 中,你可以选择把它打开到:
- 普通应用,例如 TextEdit 或其他可以打开纯文本文件的编辑器。
- 终端应用,例如 Terminal、iTerm2、Warp、Hyper、Kitty 或 Ghostty。
如果选择终端目标,还可以自定义启动命令模板。
- 按 Control + Esc 退出输入模式。
- 按 Shift + Control + Esc 退出抓物机。