极奇策RPA技术教程:鼠标滚轮 (NodeMouseScroll) - 自动化开发与配置详细指南

鼠标滚轮
📖 节点概述
模拟鼠标滚轮操作,可实现页面或局部容器的像素滚动、平滑滚动到指定元素,以及智能滚动直到页面上出现目标文本。支持多种滚动单位、物理加速度模拟和修饰键,能够满足从普通翻页到滑块验证码辅助的各种滚动需求。
💡 使用场景:
- 加载页面:滚动到页面底部,触发“加载更多”按钮或异步内容。
- 滑块辅助:配合拖拽节点,先用滚轮微调页面位置,再定位滑块。
- 页面内导航:平滑滚动到某个章节或元素,确保其可见后再操作。
- 动态内容抓取:在智能滚动模式下,自动滚动直到出现需要的文本,再提取数据。
- 内嵌滚动容器操作:对弹窗、iframe 或侧边栏中的滚动条进行控制。
🎮 实战连线指南:如何正确使用它?
节点默认操作当前活动标签页,也可以指定 Tab。主要工作模式有三种,通过“滚动模式”下拉框切换,不同模式下界面控件会自动调整。
场景案例:不断向下滚动页面,直到出现“没有更多了”的提示
- 打开列表页:导航到需要滚动加载的页面。
- 设置滚动模式:选择“智能滚动:直到页面出现指定文本”。
- 填写目标文本:在“目标文本”中输入
没有更多了。匹配模式保持“包含”。 - 配置步长与频率:Y 轴步长设为
500像素(每次滚动距离),步间隔设为300毫秒(滚动间隔),最大滚动次数设为30。 - 运行:节点会反复向下滚动,每次滚动后检查页面是否出现目标文本,一旦出现就停止,并输出“结果状态”为 true。
场景案例:平滑滚动到页面底部的“提交”按钮
- 定位元素:使用【智能定位元素】获取“提交”按钮的定位器。
- 选择模式:选择“滚动到指定元素 (平滑定位)”。
- 填入目标元素:在“滚动到元素”控件中选择或填入该定位器。
- 条件滚动:高级选项中的“条件滚动”保持“总是滚动”,或设为“仅当元素不可见”以提高效率。
- 执行:节点会自动平滑滚动,直到按钮出现在视野中央,然后流程继续。
场景案例:精确控制内嵌列表滚动 300 像素
- 定位滚动容器:如果页面有一个局部滚动的
div,先使用【智能定位元素】获取其定位器。 - 填入滚动区域:将定位器填入“滚动区域”控件。留空则对整个页面滚动。
- 设置滚动模式:“指定像素滚动 (物理级)”。
- 设定偏移:Y 轴滚动设为
300,X 轴保持0。 - 修饰键(可选):如需按下 Ctrl 键同时滚动实现缩放,可在高级选项中选择修饰键。
- 执行:鼠标滚轮事件将在容器中心点上触发,滚动 300 像素。
⚙️ 引脚与参数说明
📥 输入引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| Exec | EXEC | 控制流入口,触发后执行滚动操作。 |
| Tab | TAB | (可选) 指定操作的标签页,不连则操作当前活动标签页。 |
| 滚动区域 | ANY | 局部滚动容器的定位器。若留空,则对页面主窗口执行滚动。支持备选定位列表。 |
| 滚动到元素 | ANY | (仅“滚动到指定元素”模式可见) 要滚动到的目标元素定位器。 |
⚙️ 控件参数
| 控件名称 | 类型 | 说明 |
|---|---|---|
| 滚动模式 | 下拉选择 | 决定滚动方式:<br>• 指定像素滚动:精确控制水平和垂直滚动距离。<br>• 滚动到指定元素:平滑滚动直到目标元素进入视野。<br>• 智能滚动:不断滚动直到页面出现指定文本。 |
| 目标文本 | 文本输入 | (仅智能滚动模式) 期待出现的文字内容,配合匹配模式使用。 |
| 文本匹配模式 | 下拉选择 | (仅智能滚动模式) 包含、精确或正则,用于匹配目标文本。 |
| X轴滚动 (px) | 数字滑块 | 水平方向滚动距离(正值向右,负值向左)。 |
| Y轴滚动/步长 (px) | 数字滑块 | 垂直方向滚动距离(正值向下,负值向上);在智能滚动模式中作为每次滚动的步长。 |
| 最大滚动次数 | 数字滑块 | (高级,仅智能滚动) 防止一直滚动的最大尝试次数,默认 20。 |
| 步间隔(毫秒) | 数字滑块 | (高级,仅智能滚动) 两次滚动之间的等待时间,模拟人眼阅读间隔。 |
| 重试次数 | 数字滑块 | (高级) 定位滚动区域或目标元素失败时的重试次数,默认 1。 |
| 条件滚动 | 下拉选择 | (仅“滚动到指定元素”模式) 总是滚动 或 仅当元素不可见,可避免重复滚动。 |
| 滚动单位 | 下拉选择 | (仅像素滚动) 将 Y 轴数值解释为 像素、行数(1行≈18px)或 刻度(1刻度≈54px)。 |
| 物理模拟 | 下拉选择 | (仅像素滚动) 无 或 加速度曲线,后者会将滚动过程拆分为多个微步,更逼真。 |
| 修饰键 | 下拉选择 | (仅像素滚动) 模拟按下 Ctrl、Shift、Alt 或 Meta 键的同时滚动。 |
| 忽略报错 | 开关 | (高级) 默认关闭。开启后,若滚动过程中出现异常不会中断流程。 |
📤 输出引脚
| 引脚名称 | 数据类型 | 说明 |
|---|---|---|
| Exec | EXEC | 滚动操作完成后触发。 |
| 结果状态 | ANY | 操作是否成功。智能滚动找到文本时返回true,其他模式通常返回 true;异常时可能为 false。 |
💎 小贴士:
- 在智能滚动中,节点会遍历容器内所有可见文本节点进行匹配,忽略脚本、样式等不可见内容,匹配更准确。
- 若页面滚动区域本身有滚动条,务必通过“滚动区域”指定该容器,否则滚轮事件可能作用在页面上而无效。
- 使用修饰键滚动(如 Ctrl+滚轮)可模拟页面缩放,但具体效果取决于网站实现。
- 物理加速度模拟会增加操作时长,但能降低被识别为机器人的风险。
- 智能滚动在达到最大次数仍未找到文本时会抛出错误,建议结合“忽略报错”或外部重试逻辑使用。
这篇文档对您有帮助吗?
您的反馈将帮助我们持续优化文档内容

