键盘输入

📖 节点概述

强大的键盘操作模拟节点，可以模拟大部分的键盘行为：输入文本、按下单个字符、触发组合快捷键、发送特殊功能键（如 Enter、Tab），和执行复杂的按键宏序列。可以针对指定输入框操作，也可以直接对当前页面焦点发送按键。支持按键重复、长按和按键间隔等高级选项，满足从简单表单填写到复杂快捷键操作的各种需求。

💡 使用场景：

• 快捷键操作：发送 Ctrl+S 保存、Ctrl+C/V 复制粘贴，或者 Ctrl+Shift+I 打开开发者工具。
• 表单提交：在输入框中输入内容后，模拟按下 Enter 键提交。
• 对话框确认：使用 Escape 关闭弹窗，或者 Tab 在字段间切换。
• 游戏或动画控制：发送方向键或空格键进行交互。
• 批量文本录入：通过宏序列一次性完成复杂的连续按键操作。

🎮 实战连线指南：如何正确使用它？

节点默认将键盘事件发送到当前聚焦的页面元素。如果你需要向某个特定的输入框发送按键，可以通过“元素定位”指定它，节点会自动先将焦点移到该元素上，再执行按键。

场景案例：在搜索框中输入关键词后按回车搜索

1. 打开页面：导航到搜索网站。
2. 定位搜索框：使用【智能定位元素】获取搜索框的定位器，填入“元素定位”。
3. 设置文本输入：操作类型选择“文本输入 (Text Input)”。在出现的“输入文本”框中输入关键词（如 RPA 教程），文本写入模式选择“覆盖清空”，输入模式保持“直接插入”。
4. 添加回车键：再拖入一个【键盘输入】节点，操作类型选择“特殊功能键 (Special Keys)”，在“特殊功能键”下拉框中选择 Enter。元素定位可以留空，因为焦点已经在搜索框中。
5. 串联：将两个键盘节点依次连接，第一个输入完文本后，第二个按下回车。
6. 执行：流程会清空搜索框，输入关键词，然后提交搜索。

场景案例：使用组合键全选并复制整个页面内容

1. 设置组合键：操作类型选择“组合键 (Shortcut)”。
2. 配置修饰键和主键：在“修饰键”下拉框选择 Ctrl，在出现的“主键”输入框中输入 a（表示 Ctrl+A 全选）。
3. 执行复制：再添加一个组合键，修饰键 Ctrl，主键 c。可以留空元素定位，组合键会直接发送到页面。
4. 后续使用：复制后的内容可以粘贴到其他地方。可根据需要调整“重复次数”和“按键间隔”。

场景案例：执行复杂的宏序列

1. 选择操作类型：“按键序列 (Macro Sequence)”。
2. 编写宏序列：在“宏序列”文本框中输入一串指令，例如 {Enter}{Delay 500}Hello{Enter}，表示先按回车，等 0.5 秒，再输入 Hello，再按回车。
3. 格式说明：普通文本会直接输入，{按键名} 表示特殊按键或组合键，{Delay 毫秒} 表示延时。组合键写法如 {Ctrl+a}。
4. 执行：节点会逐条解析并执行序列，非常适合需要定时插入延时的复杂键盘流程。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

💎 小贴士：

• 如果不想手动指定元素定位，可以先用“控制焦点”节点将焦点设置到目标元素，然后再使用本节点并留空定位。
• 在“文本输入”模式下，\n 和 \t 会被自动转义为换行符和制表符，方便输入多行内容。
• 宏序列中可以使用 {Delay 数字} 来插入延时，数字单位是毫秒。支持嵌套组合键，如 {Ctrl+Shift+s}。
• 逐字符模拟模式比直接插入慢得多，但有时能绕过某些前端框架对 insertText 的限制。
• 若操作后页面焦点发生转移，后续的键盘节点可能失效，建议在必要时重新定位元素或重新获取焦点。