mirror of
https://gitee.com/g1879/DrissionPage.git
synced 2024-12-10 04:00:23 +08:00
147 lines
6.0 KiB
Python
147 lines
6.0 KiB
Python
# -*- coding:utf-8 -*-
|
||
"""
|
||
@Author : g1879
|
||
@Contact : g1879@qq.com
|
||
@Copyright: (c) 2024 by g1879, Inc. All Rights Reserved.
|
||
@License : BSD 3-Clause.
|
||
"""
|
||
from pathlib import Path
|
||
from typing import Union
|
||
|
||
from .downloader import DownloadMission
|
||
from .._elements.chromium_element import ChromiumElement
|
||
from .._pages.tabs import MixTab, ChromiumTab
|
||
|
||
|
||
class Clicker(object):
|
||
_ele: ChromiumElement = ...
|
||
|
||
def __init__(self, ele: ChromiumElement):
|
||
"""
|
||
:param ele: ChromiumElement
|
||
"""
|
||
...
|
||
|
||
def __call__(self, by_js: Union[bool, str, None] = False,
|
||
timeout: float = 1.5, wait_stop: bool = True) -> Union[ChromiumElement, False]:
|
||
"""点击元素
|
||
如果遇到遮挡，可选择是否用js点击
|
||
:param by_js: 是否用js点击，为None时先用模拟点击，遇到遮挡改用js，为True时直接用js点击，为False时只用模拟点击
|
||
:param timeout: 模拟点击的超时时间（秒），等待元素可见、可用、进入视口
|
||
:param wait_stop: 是否等待元素运动结束再执行点击
|
||
:return: 是否点击成功
|
||
"""
|
||
...
|
||
|
||
def left(self, by_js: Union[bool, str, None] = False,
|
||
timeout: float = 1.5, wait_stop: bool = True) -> Union[ChromiumElement, False]:
|
||
"""点击元素，可选择是否用js点击
|
||
:param by_js: 是否用js点击，为None时先用模拟点击，遇到遮挡改用js，为True时直接用js点击，为False时只用模拟点击
|
||
:param timeout: 模拟点击的超时时间（秒），等待元素可见、可用、进入视口
|
||
:param wait_stop: 是否等待元素运动结束再执行点击
|
||
:return: 是否点击成功
|
||
"""
|
||
...
|
||
|
||
def right(self) -> ChromiumElement:
|
||
"""右键单击"""
|
||
...
|
||
|
||
def middle(self, get_tab: bool = True) -> Union[ChromiumTab, MixTab, None]:
|
||
"""中键单击，默认返回新出现的tab对象
|
||
:param get_tab: 是否返回新tab对象，为False则返回None
|
||
:return: Tab对象或None
|
||
"""
|
||
...
|
||
|
||
def at(self,
|
||
offset_x: float = None,
|
||
offset_y: float = None,
|
||
button: str = 'left',
|
||
count: int = 1) -> ChromiumElement:
|
||
"""带偏移量点击本元素，相对于左上角坐标。不传入x或y值时点击元素中间点
|
||
:param offset_x: 相对元素左上角坐标的x轴偏移量
|
||
:param offset_y: 相对元素左上角坐标的y轴偏移量
|
||
:param button: 点击哪个键，可选 left, middle, right, back, forward
|
||
:param count: 点击次数
|
||
:return: None
|
||
"""
|
||
...
|
||
|
||
def multi(self, times: int = 2) -> ChromiumElement:
|
||
"""多次点击
|
||
:param times: 默认双击
|
||
:return: None
|
||
"""
|
||
...
|
||
|
||
def to_download(self,
|
||
save_path: Union[str, Path] = None,
|
||
rename: str = None,
|
||
suffix: str = None,
|
||
new_tab: bool = False,
|
||
by_js: bool = False,
|
||
timeout: float = None) -> DownloadMission:
|
||
"""点击触发下载
|
||
:param save_path: 保存路径，为None保存在原来设置的，如未设置保存到当前路径
|
||
:param rename: 重命名文件名
|
||
:param suffix: 指定文件后缀
|
||
:param new_tab: 该下载是否在新tab中触发
|
||
:param by_js: 是否用js方式点击，逻辑与click()一致
|
||
:param timeout: 等待下载触发的超时时间，为None则使用页面对象设置
|
||
:return: DownloadMission对象
|
||
"""
|
||
...
|
||
|
||
def to_upload(self, file_paths: Union[str, Path, list, tuple], by_js: bool = False) -> None:
|
||
"""触发上传文件选择框并自动填入指定路径
|
||
:param file_paths: 文件路径，如果上传框支持多文件，可传入列表或字符串，字符串时多个文件用回车分隔
|
||
:param by_js: 是否用js方式点击，逻辑与click()一致
|
||
:return: None
|
||
"""
|
||
...
|
||
|
||
def for_new_tab(self, by_js: bool = False, timeout: float = 3) -> Union[ChromiumTab, MixTab]:
|
||
"""点击后等待新tab出现并返回其对象
|
||
:param by_js: 是否使用js点击，逻辑与click()一致
|
||
:param timeout: 等待超时时间
|
||
:return: 新标签页对象，如果没有等到新标签页出现则抛出异常
|
||
"""
|
||
...
|
||
|
||
def for_url_change(self, text: str = None, exclude: bool = False,
|
||
by_js: bool = False, timeout: float = None) -> bool:
|
||
"""点击并等待tab的url变成包含或不包含指定文本
|
||
:param text: 用于识别的文本，为None等待当前url变化
|
||
:param exclude: 是否排除，为True时当url不包含text指定文本时返回True，text为None时自动设为True
|
||
:param by_js: 是否用js点击
|
||
:param timeout: 超时时间（秒），为None使用页面设置
|
||
:return: 是否等待成功
|
||
"""
|
||
...
|
||
|
||
def for_title_change(self, text: str = None, exclude: bool = False,
|
||
by_js: bool = False, timeout: float = None) -> bool:
|
||
"""点击并等待tab的title变成包含或不包含指定文本
|
||
:param text: 用于识别的文本，为None等待当前title变化
|
||
:param exclude: 是否排除，为True时当title不包含text指定文本时返回True，text为None时自动设为True
|
||
:param by_js: 是否用js点击
|
||
:param timeout: 超时时间（秒），为None使用页面设置
|
||
:return: 是否等待成功
|
||
"""
|
||
...
|
||
|
||
def _click(self,
|
||
view_x: float,
|
||
view_y: float,
|
||
button: str = 'left',
|
||
count: int = 1) -> ChromiumElement:
|
||
"""实施点击
|
||
:param view_x: 视口x坐标
|
||
:param view_y: 视口y坐标
|
||
:param button: 'left' 'right' 'middle' 'back' 'forward'
|
||
:param count: 点击次数
|
||
:return: None
|
||
"""
|
||
...
|