Files
2026-11-02 22:54:14 +08:00

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
"""
...