Selenium Webdriver 3.X源码分析之ActionChains

2019 年 10 月 4 日
笔记

> Selenium Webdriver 3.X源码分析系列第5篇，该系列原则上会将整个源码分享一遍

在实际应用action_chains是这样的，例如将鼠标左键从一个元素移动到另外一个元素上，然后做单击动作。

方式一，连环腿大招方式：

方式二，无影脚方式：

不管是哪种方式，请注意其中最后都会调用perform方法，这个action_chains有点类似游戏中，先积聚足够的能力，然后一下放出一个连贯动作的大招，而这里的perform方法就是释放这些连贯动作的触发点。

下面我们一起按下action_chains.py的源码，先看一张大概的源码结构：

我们先看一下ActionChains对外提供的API的大体能力，下面我用一张表对相关API进行必要的说明。

API	功能	备注
def perform(self)	行行为事件
def click(self, on_element=None)	点击	– 如果参数不写，那么点击的是当前鼠标位置- 如果参数写定位到的元素对象element，那就是点这个元素
def click_and_hold(self, on_element=None)	鼠标左键按住某个元素	– 如果参数不写，那么点的是当前鼠标位置- 如果参数写定位到的元素对象element，那就是点这个元素
def context_click(self, on_element=None)	鼠标右键点击	– 如果参数不写，那么点的是当前鼠标位置- 如果参数写定位到的元素对象element，那就是点这个元素
def double_click(self, on_element=None)	双击鼠标	– 如果参数不写，那么点的是当前鼠标位置- 如果参数写定位到的元素对象element，那就是点这个元素
def drag_and_drop(self, source, target)	按住源元素上的鼠标左键，然后移动到目标元素并释放鼠标按钮	– source: 按住鼠标的元素位置- target: 松开鼠标的元素位置
def drag_and_drop_by_offset(self, source, xoffset, yoffset)	按住源元素上的鼠标左键，然后移动到目标偏移量并释放鼠标按钮。	– source: 按住鼠标的元素位置- xoffset: X 轴的偏移量- yoffset: Y 轴的偏移量
def key_down(self, value, element=None)	只发送一个按键，而不释放它。只应用于修饰键（控制、alt和shift）	– value: 要发送的修饰符键。值在“Keys”类中定义。- element: 定位的元素如果element参数不写就是当前鼠标的位置举个例子，按住 ctrl+c::ActionChains(driver).key_down(Keys.CONTROL).send_keys('c').key_up(Keys.CONTROL).perform()def key_up(self, value, element=None):# 释放按键，配合上面的一起使用
def move_by_offset(self, xoffset, yoffset)	将鼠标移动到当前鼠标位置的偏移量	– xoffset: X轴作为一个正整数或负整数移动到x偏移量- yoffset: Y轴偏移，作为正整数或负整数。
def move_to_element(self, to_element)	鼠标悬停	– to_element: 定位需要悬停的元素
def move_to_element_with_offset(self, to_element, xoffset, yoffset)	通过指定元素的偏移量移动鼠标。偏移量与元素的左上角相对	– to_element: 定位需要悬停的元素- xoffset: X 轴偏移量- yoffset: Y 轴偏移量
def release(self, on_element=None)	释放一个元素上的鼠标按钮	– 如果参数不写，那么是当前鼠标位置- 如果参数写定位到的元素对象element，那就是这个元素
def send_keys(self, *keys_to_send)	发送到当前焦点元素	要发送的按键。修饰符键常数可以在“Keys”类。
def send_keys_to_element(self, element, *keys_to_send):	发送到定位到的元素上	– element: 定位的元素- keys_to_send: 要发送的按键。修饰符键常数可以在“Keys”类。