控制焦点

📖 节点概述

用来控制网页元素的焦点状态。既可以将焦点设置到指定的输入框、按钮或任何可聚焦元素上，也可以从某个元素上移除焦点，甚至全局取消页面上所有元素的焦点。这对于模拟键盘输入、触发焦点相关样式变化或确保后续操作指向正确元素。

💡 使用场景：

• 激活输入框：在填写表单前，先将焦点移动到目标输入框，确保后续“键盘输入”或“输入文本”节点能正确写入。
• 触发自动提示：让搜索框获得焦点，触发下拉建议列表的显示。
• 关闭下拉或弹窗：使用全局失焦，关闭因焦点而出现的日期选择器、建议菜单等浮层组件。
• 解除焦点锁定：在连续操作多个页面后，主动让当前元素失去焦点，避免键盘事件误触发。

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

节点提供两种主要动作：聚焦（让元素获得焦点）和取消焦点（让元素失去焦点）。取消焦点时可以不填元素定位，节点会自动执行全局失焦，即让页面整体失去焦点（例如点击页面空白处）。

场景案例：激活搜索框并显示下拉建议

1. 打开页面：用【访问网址】进入搜索页面。
2. 定位搜索框：使用【智能定位元素】或手动填写输入框的 CSS 选择器（如 #searchInput），填入“元素定位”。
3. 设置动作：动作选择“聚焦指定元素 (Focus)”。
4. 执行：将上一个步骤的 Exec 输出连接到本节点的 Exec 输入。节点会让搜索框获得焦点，此时网站可能会自动弹出历史搜索建议或热门推荐。
5. 后续操作：可以使用【输入文本】节点直接在该已聚焦的搜索框中输入关键词。

场景案例：关闭因焦点而展开的日期选择器

1. 日期输入框：点击日期输入框后弹出了日期选择面板。
2. 取消焦点：在某个操作后，使用【控制焦点】节点，动作选择“取消焦点 (Blur)”，不填写“元素定位”（或留空）。
3. 执行：节点会执行全局失焦操作，模拟点击页面空白区域，日期面板通常会关闭。之后可继续操作页面其他部分。

聚焦方式选择：默认的“智能聚焦”会模拟鼠标点击后再调用 focus，能触发大多数 UI 框架的完整响应链；如果只需要静默获取焦点（例如不触发点击事件），可切换为“原生 JS Focus”。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

💎 小贴士：

• 若要对输入框使用“键盘输入”节点，先用本节点将焦点移到该输入框上，以确保按键事件被正确接收。
• 全局失焦会尝试让 document.body 获得焦点并模拟点击空白区域，大多数弹出层会因此关闭，但有些复杂组件可能需要点击特定区域才能消失，此时建议使用“点击元素”节点。
• 当你选择“取消焦点”并指定了某个元素定位，节点会先让该元素失焦，然后再执行全局失焦，确保焦点被全部移除。
• 默认不忽略报错，因为焦点操作通常很关键，失败应引起注意；可在调试稳定后开启忽略报错以增加鲁棒性。