跳到主要内容

Mouse

Mouse 类以主框架 CSS 像素为单位，相对于视口的左上角进行操作。

每个 page 对象都有自己的 Mouse，可通过 page.mouse 访问。

# 使用 ‘page.mouse’ 绘制一个 100x100 的正方形。
page.mouse.move(0, 0)
page.mouse.down()
page.mouse.move(0, 100)
page.mouse.move(100, 100)
page.mouse.move(100, 0)
page.mouse.move(0, 0)
page.mouse.up()

方法​

click​

v1.9 之前添加 mouse.click

相当于依次调用 mouse.move()、mouse.down()、mouse.up() 的快捷方式。

用法

mouse.click(x, y)
mouse.click(x, y, **kwargs)

参数

  • x float#

    相对于主框架视口左上角的 X 坐标（CSS 像素）。

  • y float#

    相对于主框架视口左上角的 Y 坐标（CSS 像素）。

  • button "left" | "right" | "middle" (可选)#

    默认为 left。

  • click_count int (可选)#

    默认为 1。参见 UIEvent.detail。

  • delay float (可选)#

    mousedown 和 mouseup 之间等待的时间（毫秒）。默认为 0。

返回值

dblclick​

v1.9 之前添加 mouse.dblclick

相当于依次调用 mouse.move()、mouse.down()、mouse.up()、mouse.down() 和 mouse.up() 的快捷方式。

用法

mouse.dblclick(x, y)
mouse.dblclick(x, y, **kwargs)

参数

  • x float#

    相对于主框架视口左上角的 X 坐标（CSS 像素）。

  • y float#

    相对于主框架视口左上角的 Y 坐标（CSS 像素）。

  • button "left" | "right" | "middle" (可选)#

    默认为 left。

  • delay float (可选)#

    mousedown 和 mouseup 之间等待的时间（毫秒）。默认为 0。

返回值

down​

v1.9 之前添加 mouse.down

派发一个 mousedown 事件。

用法

mouse.down()
mouse.down(**kwargs)

参数

  • button "left" | "right" | "middle" (可选)#

    默认为 left。

  • click_count int (可选)#

    默认为 1。参见 UIEvent.detail。

返回值

move​

v1.9 之前添加 mouse.move

派发一个 mousemove 事件。

用法

mouse.move(x, y)
mouse.move(x, y, **kwargs)

参数

  • x float#

    相对于主框架视口左上角的 X 坐标（CSS 像素）。

  • y float#

    相对于主框架视口左上角的 Y 坐标（CSS 像素）。

  • steps int (可选)#

    默认为 1。会发送中间的 mousemove 事件。

返回值

up​

v1.9 之前添加 mouse.up

派发一个 mouseup 事件。

用法

mouse.up()
mouse.up(**kwargs)

参数

  • button "left" | "right" | "middle" (可选)#

    默认为 left。

  • click_count int (可选)#

    默认为 1。参见 UIEvent.detail。

返回值

wheel​

新增于: v1.15 mouse.wheel

派发一个 wheel 事件。此方法通常用于手动滚动页面。更多滚动页面的方式请参见滚动。

备注

如果未处理 wheel 事件，可能会导致页面滚动，并且该方法不会等待滚动完成后再返回。

用法

mouse.wheel(delta_x, delta_y)

参数

  • delta_x float#

    水平滚动的像素数。

  • delta_y float#

    垂直滚动的像素数。

返回值