U
|
[ ±d2 ã @ sN d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z G dd d Z
|
dS )
|
z The ActionChains implementation,é N)Ú
|
WebElementé )Ú ActionBuilder)Ú ScrollOrigin)Úkeys_to_typingc @ s
|
e Zd ZdZd:ddZdd Zdd Zd;d
|
d Zd<d d Zd=ddZ d>ddZ
|
dd Z dd Z d?ddZ d@ddZdd Zd d Zd d Zd d! ZdAd"d#Zd$d% Zd&d' Zed(d)d*Zeed+d,d-Zeeed.d/d0ZdBeeeeee d3d4d5Z d6d7 Z d8d9 Z d S )CÚ ActionChainsaÅ ActionChains are a way to automate low level interactions such as mouse
|
movements, mouse button actions, key press, and context menu interactions.
|
This is useful for doing more complex actions like hover over and drag and
|
drop.
|
|
Generate user actions.
|
When you call methods for actions on the ActionChains object,
|
the actions are stored in a queue in the ActionChains object.
|
When you call perform(), the events are fired in the order they
|
are queued up.
|
|
ActionChains can be used in a chain pattern::
|
|
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()
|
|
Or actions can be queued up one by one, then performed.::
|
|
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()
|
|
Either way, the actions are performed in the order they are called, one after
|
another.
|
éú c C s || _ t||d| _dS )zØCreates a new ActionChains.
|
|
:Args:
|
- driver: The WebDriver instance which performs user actions.
|
- duration: override the default 250 msecs of DEFAULT_MOVE_DURATION in PointerInput
|
)ÚdurationN)Z_driverr Ú w3c_actions)ÚselfZdriverr © r ú^d:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\selenium/webdriver/common/action_chains.pyÚ__init__= s zActionChains.__init__c C s | j ¡ dS )z Performs all stored actions.N)r
|
Úperform©r r r r r G s zActionChains.performc C s$ | j ¡ | j jD ] }| ¡ qdS )zMClears actions that are already stored locally and on the remote
|
end.N)r
|
Z clear_actionsZdevices)r Zdevicer r r Ú reset_actionsK s
|
zActionChains.reset_actionsNc C s6 |r| |¡ | jj ¡ | jj ¡ | jj ¡ | S )zClicks an element.
|
|
:Args:
|
- on_element: The element to click.
|
If None, clicks on current mouse position.
|
)Úmove_to_elementr
|
Úpointer_actionÚclickÚ
|
key_actionÚpause©r Ú
|
on_elementr r r r R s
|
zActionChains.clickc C s* |r| |¡ | jj ¡ | jj ¡ | S )z°Holds down the left mouse button on an element.
|
|
:Args:
|
- on_element: The element to mouse down.
|
If None, clicks on current mouse position.
|
)r r
|
r Úclick_and_holdr r r r r r r b s
|
|
zActionChains.click_and_holdc C s6 |r| |¡ | jj ¡ | jj ¡ | jj ¡ | S )z¹Performs a context-click (right click) on an element.
|
|
:Args:
|
- on_element: The element to context-click.
|
If None, clicks on current mouse position.
|
)r r
|
r Ú context_clickr r r r r r r q s
|
zActionChains.context_clickc C s8 |r| |¡ | jj ¡ tdD ]}| jj ¡ q"| S )zDouble-clicks an element.
|
|
:Args:
|
- on_element: The element to double-click.
|
If None, clicks on current mouse position.
|
é )r r
|
r Ú double_clickÚranger r )r r Ú_r r r r s
|
zActionChains.double_clickc C s | |¡ | |¡ | S )zòHolds down the left mouse button on the source element, then moves
|
to the target element and releases the mouse button.
|
|
:Args:
|
- source: The element to mouse down.
|
- target: The element to mouse up.
|
)r Úrelease)r ÚsourceÚtargetr r r Ú drag_and_drop s
|
|
zActionChains.drag_and_dropc C s" | |¡ | ||¡ | ¡ | S )a Holds down the left mouse button on the source element, then moves
|
to the target offset and releases the mouse button.
|
|
:Args:
|
- source: The element to mouse down.
|
- xoffset: X offset to move to.
|
- yoffset: Y offset to move to.
|
)r Úmove_by_offsetr )r r ÚxoffsetÚyoffsetr r r Údrag_and_drop_by_offset s
|
z$ActionChains.drag_and_drop_by_offsetc C s, |r| |¡ | jj |¡ | jj ¡ | S )aÔ Sends a key press only, without releasing it. Should only be used
|
with modifier keys (Control, Alt and Shift).
|
|
:Args:
|
- value: The modifier key to send. Values are defined in `Keys` class.
|
- element: The element to send keys.
|
If None, sends a key to current focused element.
|
|
Example, pressing ctrl+c::
|
|
ActionChains(driver).key_down(Keys.CONTROL).send_keys('c').key_up(Keys.CONTROL).perform()
|
)r r
|
r Úkey_downr r ©r ÚvalueÚelementr r r r' « s
|
|
zActionChains.key_downc C s, |r| |¡ | jj |¡ | jj ¡ | S )at Releases a modifier key.
|
|
:Args:
|
- value: The modifier key to send. Values are defined in Keys class.
|
- element: The element to send keys.
|
If None, sends a key to current focused element.
|
|
Example, pressing ctrl+c::
|
|
ActionChains(driver).key_down(Keys.CONTROL).send_keys('c').key_up(Keys.CONTROL).perform()
|
)r r
|
r Úkey_upr r r( r r r r+ À s
|
|
zActionChains.key_upc C s | j j ||¡ | j j ¡ | S )zëMoving the mouse to an offset from current mouse position.
|
|
:Args:
|
- xoffset: X offset to move to, as a positive or negative integer.
|
- yoffset: Y offset to move to, as a positive or negative integer.
|
)r
|
r Zmove_byr r )r r$ r% r r r r# Ô s zActionChains.move_by_offsetc C s | j j |¡ | j j ¡ | S )zxMoving the mouse to the middle of an element.
|
|
:Args:
|
- to_element: The WebElement to move to.
|
)r
|
r Úmove_tor r )r Ú
|
to_elementr r r r á s z ActionChains.move_to_elementc C s* | j j |t|t|¡ | j j ¡ | S )aa Move the mouse by an offset of the specified element. Offsets are
|
relative to the in-view center point of the element.
|
|
:Args:
|
- to_element: The WebElement to move to.
|
- xoffset: X offset to move to, as a positive or negative integer.
|
- yoffset: Y offset to move to, as a positive or negative integer.
|
)r
|
r r, Úintr r )r r- r$ r% r r r Úmove_to_element_with_offsetí s
|
z(ActionChains.move_to_element_with_offsetc C s | j j |¡ | j j |¡ | S )z7Pause all inputs for the specified duration in seconds.)r
|
r r r )r Úsecondsr r r r ü s zActionChains.pausec C s* |r| |¡ | jj ¡ | jj ¡ | S )zReleasing a held mouse button on an element.
|
|
:Args:
|
- on_element: The element to mouse up.
|
If None, releases on current mouse position.
|
)r r
|
r r r r r r r r r s
|
|
zActionChains.releasec G s* t |}|D ]}| |¡ | |¡ q | S )z°Sends keys to current focused element.
|
|
:Args:
|
- keys_to_send: The keys to send. Modifier keys constants can be found in the
|
'Keys' class.
|
)r r' r+ )r Ú keys_to_sendÚtypingÚkeyr r r Ú send_keys s
|
|
zActionChains.send_keysc G s | |¡ | j| | S )zÑSends keys to an element.
|
|
:Args:
|
- element: The element to send keys.
|
- keys_to_send: The keys to send. Modifier keys constants can be found in the
|
'Keys' class.
|
)r r4 )r r* r1 r r r Úsend_keys_to_element" s
|
|
z!ActionChains.send_keys_to_element)r* c C s | j jj|d | S )zÈIf the element is outside the viewport, scrolls the bottom of the
|
element to the bottom of the viewport.
|
|
:Args:
|
- element: Which element to scroll into the viewport.
|
)Úorigin©r
|
Ú wheel_actionÚscroll)r r* r r r Úscroll_to_element. s z ActionChains.scroll_to_element©Údelta_xÚdelta_yc C s | j jj||d | S )a: Scrolls by provided amounts with the origin in the top left corner
|
of the viewport.
|
|
:Args:
|
- delta_x: Distance along X axis to scroll using the wheel. A negative value scrolls left.
|
- delta_y: Distance along Y axis to scroll using the wheel. A negative value scrolls up.
|
r; r7 )r r< r= r r r Úscroll_by_amount9 s z ActionChains.scroll_by_amount)Ú scroll_originr< r= c C s> t |ts tdt| | jjj|j|j|j ||d | S )a8 Scrolls by provided amount based on a provided origin. The scroll
|
origin is either the center of an element or the upper left of the
|
viewport plus any offsets. If the origin is an element, and the element
|
is not in the viewport, the bottom of the element will first be
|
scrolled to the bottom of the viewport.
|
|
:Args:
|
- origin: Where scroll originates (viewport or element center) plus provided offsets.
|
- delta_x: Distance along X axis to scroll using the wheel. A negative value scrolls left.
|
- delta_y: Distance along Y axis to scroll using the wheel. A negative value scrolls up.
|
|
:Raises: If the origin with offset is outside the viewport.
|
- MoveTargetOutOfBoundsException - If the origin with offset is outside the viewport.
|
z+Expected object of type ScrollOrigin, got: )r6 ÚxÚyr< r= )
|
Ú
|
isinstancer Ú TypeErrorÚtyper
|
r8 r9 r6 Zx_offsetZy_offset)r r? r< r= r r r Úscroll_from_originE s
|
ûz ActionChains.scroll_from_originr Úviewport©r@ rA r< r= r r6 c C s. t jdtdd | jjj||||||d | S )a) Sends wheel scroll information to the browser to be processed.
|
|
:Args:
|
- x: starting X coordinate
|
- y: starting Y coordinate
|
- delta_x: the distance the mouse will scroll on the x axis
|
- delta_y: the distance the mouse will scroll on the y axis
|
ziscroll() has been deprecated, please use scroll_to_element(), scroll_by_amount() or scroll_from_origin().é )Ú
|
stacklevelrG )ÚwarningsÚwarnÚDeprecationWarningr
|
r8 r9 )r r@ rA r< r= r r6 r r r r9 a s ý ÿzActionChains.scrollc C s | S ©Nr r r r r Ú __enter__w s zActionChains.__enter__c C s d S rM r )r Ú_typeÚ_valueZ
|
_tracebackr r r Ú__exit__z s zActionChains.__exit__)r )N)N)N)N)N)N)N)r rF ) Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r r r r r r r r" r& r' r+ r# r r/ r r r4 r5 r r: r. r> r rE Ústrr9 rN rQ r r r r r s2
|
|
|
|
|
|
|
|
|
r ) rU rJ Z$selenium.webdriver.remote.webelementr Zactions.action_builderr Zactions.wheel_inputr Úutilsr r r r r r Ú<module> s
|
