U
|
\ ±d* ã @ s d dl mZ d dl mZ d dl mZ d dl mZ d dlmZ d dlmZ d dl m
|
Z
|
e dd d
|
d Z ee dd d dZ G dd dZdS )é )ÚDict)ÚList)ÚOptional)ÚUnion)ÚWebDriverException)ÚBy)Ú
|
WebElementÚ
|
RelativeBy)Útag_nameÚreturnc C s | s t dtd| iS )aW Start searching for relative objects using a tag name.
|
|
Note: This method may be removed in future versions, please use
|
`locate_with` instead.
|
:Args:
|
- tag_name: the DOM tag of element to start searching.
|
:Returns:
|
- RelativeBy - use this object to create filters within a
|
`find_elements` call.
|
ztag_name can not be nullz css selector)r r )r
|
© r úbd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\selenium/webdriver/support/relative_locator.pyÚ with_tag_name s r )ÚbyÚusingr c C s, | dk st d|dk s t dt| |iS )a) Start searching for relative objects your search criteria with By.
|
|
:Args:
|
- by: The value from `By` passed in.
|
- using: search term to find the element with.
|
:Returns:
|
- RelativeBy - use this object to create filters within a
|
`find_elements` call.
|
Nz Please pass in a by argumentz Please pass in a using argument)ÚAssertionErrorr )r r r r r Ú locate_with+ s
|
r c @ sÌ e Zd ZdZdeeeeef ef ee dddZ
|
dee ef d dddZ dee ef d dd d
|
Z dee ef d dd d Zdee ef d dd dZdee eef d dddZedddZdS )r aÈ Gives the opportunity to find elements based on their relative location
|
on the page from a root elelemt. It is recommended that you use the helper
|
function to create it.
|
|
Example:
|
lowest = driver.find_element(By.ID, "below")
|
|
elements = driver.find_elements(locate_with(By.CSS_SELECTOR, "p").above(lowest))
|
|
ids = [el.get_attribute('id') for el in elements]
|
assert "above" in ids
|
assert "mid" in ids
|
N©ÚrootÚfiltersc C s || _ |p g | _dS )a
|
Creates a new RelativeBy object. It is preferred if you use the
|
`locate_with` method as this signature could change.
|
:Args:
|
root - A dict with `By` enum as the key and the search query as the value
|
filters - A list of the filters that will be searched. If none are passed
|
in please use the fluent API on the object to create the filters
|
Nr )Úselfr r r r r Ú__init__I s zRelativeBy.__init__)Úelement_or_locatorr c C s$ |s t d| j d|gd¡ | S )z
|
Add a filter to look for elements above.
|
:Args:
|
- element_or_locator: Element to look above
|
z:Element or locator must be given when calling above methodÚabove©ÚkindÚargs©r r Úappend©r r r r r r U s zRelativeBy.abovec C s$ |s t d| j d|gd¡ | S )z
|
Add a filter to look for elements below.
|
:Args:
|
- element_or_locator: Element to look below
|
z:Element or locator must be given when calling below methodÚbelowr r r r r r r a s zRelativeBy.belowc C s$ |s t d| j d|gd¡ | S )z
|
Add a filter to look for elements to the left of.
|
:Args:
|
- element_or_locator: Element to look to the left of
|
z?Element or locator must be given when calling to_left_of methodÚleftr r r r r r Ú
|
to_left_ofm s zRelativeBy.to_left_ofc C s$ |s t d| j d|gd¡ | S )z
|
Add a filter to look for elements right of.
|
:Args:
|
- element_or_locator: Element to look right of
|
z@Element or locator must be given when calling to_right_of methodÚrightr r r r r r Ú to_right_ofy s zRelativeBy.to_right_of)Úelement_or_locator_distancer c C s$ |s t d| j d|gd¡ | S )z¬
|
Add a filter to look for elements near.
|
:Args:
|
- element_or_locator_distance: Element to look near by the element or within a distance
|
zEElement or locator or distance must be given when calling near methodÚnearr r )r r% r r r r&
s zRelativeBy.near)r c C s d| j | jdiS )z[Create a dict that will be passed to the driver to start searching
|
for the element.Úrelativer r )r r r r Úto_dict s
|
þÿzRelativeBy.to_dict)NN)N)N)N)N)N)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r r r r Ústrr r r r r r" r$ Úintr& r( r r r r r : s * N)Útypingr r r r Zselenium.common.exceptionsr Z selenium.webdriver.common.byr Z$selenium.webdriver.remote.webelementr r- r r r r r r r Ú<module> s
|
