滚动网页元素
指令说明
自动移动鼠标指针(虚拟鼠标,不抢夺真实的鼠标)到指定的元素上,然后触发滚动。
若元素不在浏览器窗口内,该指令会自动滚动网页,直到元素出现在窗口内时再滚动。
滚动距离是物理像素,JS element.getBoundingClientRect() 获取到的是CSS像素,需要乘以devicePixelRatio才是物理像素。
通过网页元素获取到的宽高、位置以及图片验证码滑动距离等都是物理像素。
指令输入参数
| 输入参数 | 输入参数类型 | 说明 |
|---|---|---|
| 网页对象 | WebPage | 在该网页滚动 |
| 网页元素 | WebElement 或 str (捕获的元素ID) | 鼠标移动到该元素上然后开始滚动,可以选择捕获的网页元素也可以选择获取网页元素、获取网页相似元素、获取网页关联元素等指令获取到网页元素 |
| 滚动方式 | 枚举项 | 目前仅支持 CDP静默滚动 |
| 横向滚动距离 | float | 物理像素,大于0网页向右移动,小于0网页向左移动 |
| 纵向滚动距离 | float | 物理像素,大于0网页向下移动(鼠标向上滚),小于0网页向上移动动(鼠标向下滚动) |
| 鼠标指针位置 | 枚举项 | 随机、中间,把鼠标指针移动到元素的随机或者中间位置后再滚动 |
| 等待元素出现时长 | float | 若元素未出现则一直等待,直到元素出现再滚动,若超过最长等待时间后元素仍未出现则触发错误,单位:秒 |
指令输出参数
无
类型定义参考
滚动方式
| 拖动方式 | 说明 |
|---|---|
| CDP静默滚动 | 通过浏览器CDP接口滚动,类似鼠标滚动但不需要鼠标。即使浏览器窗口在屏幕外或者被其他窗口遮挡仍旧可以滚动。 |
提示
- 需要先安装曲辕RPA浏览器插件
- CDP静默输入要求:曲辕RPA >= 7.7.0,浏览器插件 >= 2.4.0
常见问题
参考 网页操作常见问题