拖动网页元素
指令说明
自动移动鼠标指针（虚拟鼠标，不抢夺真实的鼠标）到指定的元素上，然后触发拖动。该指令会自动激活元素所属的网页。
若元素不在浏览器窗口内，该指令会自动滚动网页，直到元素出现在窗口内时再拖动。
拖动距离是物理像素，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
示例
拖动滑块验证码
常见问题
参考 网页操作常见问题