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
类中已经定义。