332 lines
9.5 KiB
Python
332 lines
9.5 KiB
Python
# -*- coding:utf-8 -*-
|
|
"""
|
|
@Author : g1879
|
|
@Contact : g1879@qq.com
|
|
@Website : https://DrissionPage.cn
|
|
@Copyright: (c) 2020 by g1879, Inc. All Rights Reserved.
|
|
"""
|
|
from typing import Union
|
|
|
|
from .._elements.chromium_element import ChromiumElement
|
|
from .._pages.chromium_base import ChromiumBase
|
|
from .._pages.chromium_frame import ChromiumFrame
|
|
from .._pages.chromium_page import ChromiumPage
|
|
from .._pages.chromium_tab import ChromiumTab
|
|
from .._pages.mix_tab import MixTab
|
|
from .._pages.web_page import WebPage
|
|
|
|
|
|
class Scroller(object):
|
|
_owner: Union[ChromiumBase, ChromiumElement] = ...
|
|
_t1: str = ...
|
|
_t2: str = ...
|
|
_wait_complete: bool = ...
|
|
|
|
def __init__(self, owner: Union[ChromiumBase, ChromiumElement]):
|
|
"""
|
|
:param owner: 元素对象或页面对象
|
|
"""
|
|
...
|
|
|
|
def __call__(self, pixel: int = 300) -> None:
|
|
"""向下滚动若干像素,水平位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def to_top(self) -> None:
|
|
"""滚动到顶端,水平位置不变"""
|
|
...
|
|
|
|
def to_bottom(self) -> None:
|
|
"""滚动到底端,水平位置不变"""
|
|
...
|
|
|
|
def to_half(self) -> None:
|
|
"""滚动到垂直中间位置,水平位置不变"""
|
|
...
|
|
|
|
def to_rightmost(self) -> None:
|
|
"""滚动到最右边,垂直位置不变"""
|
|
...
|
|
|
|
def to_leftmost(self) -> None:
|
|
"""滚动到最左边,垂直位置不变"""
|
|
...
|
|
|
|
def to_location(self, x: int, y: int) -> None:
|
|
"""滚动到指定位置
|
|
:param x: 水平距离
|
|
:param y: 垂直距离
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def up(self, pixel: int = 300) -> None:
|
|
"""向上滚动若干像素,水平位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def down(self, pixel: int = 300) -> None:
|
|
"""向下滚动若干像素,水平位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def left(self, pixel: int = 300) -> None:
|
|
"""向左滚动若干像素,垂直位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def right(self, pixel: int = 300) -> None:
|
|
"""向右滚动若干像素,垂直位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def _run_js(self, js: str): ...
|
|
|
|
def _wait_scrolled(self) -> None:
|
|
"""等待滚动结束"""
|
|
...
|
|
|
|
|
|
class ElementScroller(Scroller):
|
|
_owner: ChromiumElement = ...
|
|
|
|
def __init__(self, owner: ChromiumElement):
|
|
"""
|
|
:param owner: 元素对象
|
|
"""
|
|
...
|
|
|
|
def to_see(self, center: Union[bool, None] = None) -> ChromiumElement:
|
|
"""滚动页面直到元素可见
|
|
:param center: 是否尽量滚动到页面正中,为None时如果被遮挡,则滚动到页面正中
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def to_center(self) -> ChromiumElement:
|
|
"""元素尽量滚动到视口中间"""
|
|
...
|
|
|
|
def to_top(self) -> ChromiumElement:
|
|
"""滚动到顶端,水平位置不变"""
|
|
...
|
|
|
|
def to_bottom(self) -> ChromiumElement:
|
|
"""滚动到底端,水平位置不变"""
|
|
...
|
|
|
|
def to_half(self) -> ChromiumElement:
|
|
"""滚动到垂直中间位置,水平位置不变"""
|
|
...
|
|
|
|
def to_rightmost(self) -> ChromiumElement:
|
|
"""滚动到最右边,垂直位置不变"""
|
|
...
|
|
|
|
def to_leftmost(self) -> ChromiumElement:
|
|
"""滚动到最左边,垂直位置不变"""
|
|
...
|
|
|
|
def to_location(self, x: int, y: int) -> ChromiumElement:
|
|
"""滚动到指定位置
|
|
:param x: 水平距离
|
|
:param y: 垂直距离
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def up(self, pixel: int = 300) -> ChromiumElement:
|
|
"""向上滚动若干像素,水平位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def down(self, pixel: int = 300) -> ChromiumElement:
|
|
"""向下滚动若干像素,水平位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def left(self, pixel: int = 300) -> ChromiumElement:
|
|
"""向左滚动若干像素,垂直位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def right(self, pixel: int = 300) -> ChromiumElement:
|
|
"""向右滚动若干像素,垂直位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
|
|
class PageScroller(Scroller):
|
|
_owner: Union[ChromiumBase, ChromiumElement] = ...
|
|
|
|
def __init__(self, owner: Union[ChromiumBase, ChromiumElement]):
|
|
"""
|
|
:param owner: 页面对象
|
|
"""
|
|
...
|
|
|
|
def to_see(self,
|
|
loc_or_ele: Union[str, tuple, ChromiumElement],
|
|
center: Union[bool, None] = None) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""滚动页面直到元素可见
|
|
:param loc_or_ele: 元素的定位信息,可以是loc元组,或查询字符串
|
|
:param center: 是否尽量滚动到页面正中,为None时如果被遮挡,则滚动到页面正中
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def to_top(self) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""滚动到顶端,水平位置不变"""
|
|
...
|
|
|
|
def to_bottom(self) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""滚动到底端,水平位置不变"""
|
|
...
|
|
|
|
def to_half(self) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""滚动到垂直中间位置,水平位置不变"""
|
|
...
|
|
|
|
def to_rightmost(self) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""滚动到最右边,垂直位置不变"""
|
|
...
|
|
|
|
def to_leftmost(self) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""滚动到最左边,垂直位置不变"""
|
|
...
|
|
|
|
def to_location(self, x: int, y: int) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""滚动到指定位置
|
|
:param x: 水平距离
|
|
:param y: 垂直距离
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def up(self, pixel: int = 300) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""向上滚动若干像素,水平位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def down(self, pixel: int = 300) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""向下滚动若干像素,水平位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def left(self, pixel: int = 300) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""向左滚动若干像素,垂直位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def right(self, pixel: int = 300) -> Union[ChromiumTab, MixTab, ChromiumPage, WebPage]:
|
|
"""向右滚动若干像素,垂直位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def _to_see(self, ele: ChromiumElement, center: Union[bool, None]) -> None:
|
|
"""执行滚动页面直到元素可见
|
|
:param ele: 元素对象
|
|
:param center: 是否尽量滚动到页面正中,为None时如果被遮挡,则滚动到页面正中
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
|
|
class FrameScroller(PageScroller):
|
|
_owner: ChromiumElement = ...
|
|
|
|
def __init__(self, owner: ChromiumFrame): ...
|
|
|
|
def to_see(self,
|
|
loc_or_ele: Union[str, tuple, ChromiumElement],
|
|
center: Union[bool, None] = None) -> ChromiumFrame:
|
|
"""滚动页面直到元素可见
|
|
:param loc_or_ele: 元素的定位信息,可以是loc元组,或查询字符串
|
|
:param center: 是否尽量滚动到页面正中,为None时如果被遮挡,则滚动到页面正中
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def to_top(self) -> ChromiumFrame:
|
|
"""滚动到顶端,水平位置不变"""
|
|
...
|
|
|
|
def to_bottom(self) -> ChromiumFrame:
|
|
"""滚动到底端,水平位置不变"""
|
|
...
|
|
|
|
def to_half(self) -> ChromiumFrame:
|
|
"""滚动到垂直中间位置,水平位置不变"""
|
|
...
|
|
|
|
def to_rightmost(self) -> ChromiumFrame:
|
|
"""滚动到最右边,垂直位置不变"""
|
|
...
|
|
|
|
def to_leftmost(self) -> ChromiumFrame:
|
|
"""滚动到最左边,垂直位置不变"""
|
|
...
|
|
|
|
def to_location(self, x: int, y: int) -> ChromiumFrame:
|
|
"""滚动到指定位置
|
|
:param x: 水平距离
|
|
:param y: 垂直距离
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def up(self, pixel: int = 300) -> ChromiumFrame:
|
|
"""向上滚动若干像素,水平位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def down(self, pixel: int = 300) -> ChromiumFrame:
|
|
"""向下滚动若干像素,水平位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def left(self, pixel: int = 300) -> ChromiumFrame:
|
|
"""向左滚动若干像素,垂直位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|
|
|
|
def right(self, pixel: int = 300) -> ChromiumFrame:
|
|
"""向右滚动若干像素,垂直位置不变
|
|
:param pixel: 滚动的像素
|
|
:return: None
|
|
"""
|
|
...
|