🚤 动作链
动作链可以在浏览器上完成一系列交互行为,如鼠标移动、鼠标点击、键盘输入等。
浏览器页面对象都支持使用动作链。
可以链式操作,也可以分开执行,每个动作执行即生效,无需perform()
。
这些操作皆为模拟,真正的鼠标不会移动,因此可以多个标签页同时操作。
✅️ 使用方法
可以用上述对象内置的actions
属性调用动作链,也可以主动创建一个动作链对象,将页面对象传入使用。
这两种方式唯一区别是,前者会等待页面加载完毕再执行,后者不会。
📌 使用内置actions
属性
说明
这种方式会等到页面框架文档(不包括 js 数据)加载完成再执行动作。
from DrissionPage import ChromiumPage
page = ChromiumPage()
page.get('https://www.baidu.com')
page.actions.move_to('#kw').click().type('DrissionPage')
page.actions.move_to('#su').click()
📌 使用新对象
使用from DrissionPage.common import Actions
导入动作链。
只要把WebPage
对象或ChromiumPage
对象传入即可。动作链只在这个页面上生效。
初始化参数 | 类型 | 默认值 | 说明 |
---|---|---|---|
page | ChromiumPage WebPage ChromiumTab | 必填 | 动作链要操作的浏览器页面 |
说明
这种方式不会等到页面框架文档(不包括 js 数据)加载完成再执行动作。
示例:
from DrissionPage import ChromiumPage
from DrissionPage.common import Actions
page = ChromiumPage()
ac = Actions(page)
page.get('https://www.baidu.com')
ac.move_to('#kw').click().type('DrissionPage')
ac.move_to('#su').click()
📌 操作方式
多个动作可以用链式模式操作:
tab.actions.move_to(ele).click().type('some text')
也可以多个操作分开执行:
tab.actions.move_to(ele)
tab.actions.click()
tab.actions.type('some text')
这两种方式效果是一样的,每个动作总会依次执行。
✅️ 移动鼠标
📌 move_to()
此方法用于移动鼠标到元素中点,或页面上的某个绝对坐标。可设置偏移量,当带偏移量时,偏移量相对于元素左上角坐标。
初始化参数 | 类型 | 默认值 | 说明 |
---|---|---|---|
ele_or_loc | ChrmoiumElement str Tuple[int, int] | 必填 | 元素对象、文本定位符或绝对坐标,坐标为tuple (int, int) 形式 |
offset_x | int | 0 | x 轴偏移量,向右为正,向左为负 |
offset_y | int | 0 | y 轴偏移量,向下为正,向上为负 |
duration | float | 0.5 | 拖动用时,传入0 即瞬间到达 |
返回类型 | 说明 |
---|---|
Actions | 动作链对象本身 |
示例: 使鼠标移动到 ele 元素上
ele = tab('tag:a')
tab.actions.move_to(ele_or_loc=ele)
📌 move()
此方法用于使鼠标相对当前位置移动若干距离。
参数名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
offset_x | int | 0 | x 轴偏移量,向右为正,向左为负 |
offset_y | int | 0 | y 轴偏移量,向下为正,向上为负 |
duration | float | 0.5 | 拖动用时,传入0 即瞬间到达 |
返回类型 | 说明 |
---|---|
Actions | 动作链对象本身 |
示例: 鼠标向右移动 300 像素
tab.actions.move(300, 0)
📌 up()
此方法用于使鼠标相对当前位置向上移动若干距离。
参数名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
pixel | int | 必填 | 鼠标移动的像素值 |
返回类型 | 说明 |
---|---|
Actions | 动作链对象本身 |
示例: 鼠标向上移动 50 像素
tab.actions.up(50)
📌 down()
此方法用于使鼠标相对当前位置向下移动若干距离。
参数名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
pixel | int | 必填 | 鼠标移动的像素值 |
返回类型 | 说明 |
---|---|
Actions | 动作链对象本身 |
示例:
tab.actions.down(50)
📌 left()
此方法用于使鼠标相对当前位置向左移动若干距离。
参数名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
pixel | int | 必填 | 鼠标移动的像素值 |
返回类型 | 说明 |
---|---|
Actions | 动作链对象本身 |
示例:
tab.actions.left(50)
📌 right()
此方法用于使鼠标相对当前位置向右移动若干距离。
参数名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
pixel | int | 必填 | 鼠标移动的像素值 |
返回类型 | 说明 |
---|---|
Actions | 动作链对象本身 |
示例:
tab.actions.right(50)