Selenium3.0 文档——selenium.webdriver.common.action_chains

class selenium.webdriver.common.action_chains.ActionChains(driver)

ActionChains

是一个底层的自动交互的方法，例如鼠标移动、鼠标按键事件、键盘响应和菜单右击交互。这些对于像悬停和拖拽这种复杂的行为很有用。

创建用户行为。

当你调用

ActionChains

类中的动作方法时，这些动作都被存储在

ActionChains

类中的队列中。一旦你调用

perform()

，这些存在队列中的事件会依次启动。

ActionChains可以用链模式：

menu = driver.find_element_by_css_selector(".nav")
hidden_submenu = driver.find_element_by_css_selector(".nav #submenu1")

ActionChains(driver).move_to_element(menu).click(hidden_submenu).perform()

或者动作被依次储存在队列中，然后启动：

menu = driver.find_element_by_css_selector(".nav")
hidden_submenu = driver.find_element_by_css_selector(".nav #submenu1")

actions = ActionChains(driver)
actions.move_to_element(menu)
actions.click(hidden_submenu)
actions.perform()

无论哪种方式，这些动作会按照调用的顺序依次启动。

创建新的ActionChains

参数：

driver

：用户启动动作的

WebDriver

的实例。

click(on_elemrnt=None)

单击一个元素

参数：

on_element

：要单击的元素。如果没有，在鼠标的当前位置单击。

click_and_hold(on_elemrnt=None)

在一个元素上按住鼠标左键。

参数：

on_element

：鼠标按下的元素。如果没有，在鼠标的当前位置单击。

context_click(on_elemrnt=None)

在一个元素上右击。

参数：

on_element

：要右击的元素。如果没有，在鼠标的当前位置单击。

double_click(on_elemrnt=None)

双击一个元素。

参数：

on_elemrnt

：要双击的元素。如果没有，在鼠标的当前位置单击。

drag_and_drop(source, target)

在源元素上按住鼠标左键，然后移动到目标元素上并松开鼠标按键。

参数：

source

：按下鼠标的元素

target

：松开鼠标的元素

drag_and_drop_by_offset(source, xoffset, yoffset)

在源元素上按住鼠标左键，然后移动到目标位移并松开鼠标。

参数：

source

：按下鼠标的元素

xoffset

：X轴位移

yoffset

：Y轴位移

key_down(value, element=None)

仅仅按下一个按键，并不松开。只用于修饰键（Ctrl、Alt和Shift）。

参数：

value

：要发送的修饰键。值在

Keys

类中定义了。

element

：发送按键值的元素。如果没有，就向当前焦点的元素的发送。

比如按下ctrl+c：

ActionChains(driver).key_down(Keys.CONTROL).send_keys('c').key_up(Keys.CONTROL).perform()

key_up(value, element=None)

松开修饰键。

参数：

value

：要发送的修饰键。值在

Keys

类中定义了。

element

：发送按键值的元素。如果没有，就向当前焦点的元素的发送。

比如按下ctrl+c：

ActionChains(driver).key_down(Keys.CONTROL).send_keys('c').key_up(Keys.CONTROL).perform()

move_by_offset(xoffset, yoffset)

将鼠标从当前位置移动一定的位移。

参数：

xoffset

：X轴位移，可以是正数也可以是负数。

yoffset

：Y轴位移，可以是正数也可以是负数。

move_to_element(to_element)

把鼠标移动到一个元素的中间位置。

参数：

to_element

：要将鼠标移动到那里的网页元素。

move_to_element_with_offset(to_element, xoffset, yoffset)

将鼠标在一个指定的元素中移动一定的位移。位移是相对于元素的左上角。

参数：

to_element

：要将鼠标移动到那里的网页元素。

xoffset

：X轴位移。

yoffset

：Y轴位移。

perform()

启动储存的动作。

release(on_element=None)

释放按在元素上的鼠标按键。

参数：

on_element

：要释放鼠标的元素。如果没有，就在鼠标的当前位置释放。

send_keys(*keys_to_send)

向当前获得焦点的元素发送按键值。

参数：

keys_to_send

：要发送的按键。修饰键的常量在

Keys

类中已经定义。

send_keys_to_element(element, *keys_to_send)

向一个元素中发送按键值。

参数：

element

：要发送按键值的元素。

keys_to_send

：要发送的按键。修饰键的常量在

Keys

类中已经定义。