跳转到内容

输入模式

一般来说,启动抓物机后会默认进入命令模式。如果想正常输入,有两种方式:

  1. 直接退出抓物机。
  2. 进入输入模式。

如果你希望保持抓物机激活的同时正常输入,可以通过进入输入模式来实现。输入模式会暂时禁用抓物机的功能,使你能够正常输入文本。当你完成输入后,可以通过按 Control + Esc 退出输入模式并返回命令模式。

你可以通过触发 command.enterTextMode 命令进入输入模式。你也可以为这个模式设置一个专门的快捷键。

原始输入模式是输入模式的一个变体。你可以通过 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 风格快捷键层。原始输入模式中不会启用这些快捷键,并且每个快捷键都可以在 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 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 退出抓物机。