跳至主要内容

鼠标

Mouse类在主框架的CSS像素中运行,相对于视口的左上角。

每个page对象都有自己独立的鼠标控制器,可通过page.mouse访问。

# using ‘page.mouse’ to trace a 100x100 square.
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()

方法

点击

Added before 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 (可选)#

    mousedownmouseup之间等待的时间,以毫秒为单位。默认为0。

返回


双击

Added before 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 (可选)#

    mousedownmouseup之间等待的时间,以毫秒为单位。默认为0。

返回


下载

Added before v1.9 mouse.down

派发一个mousedown事件。

用法

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

参数

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

    默认为 left

  • click_count int (可选)#

    默认为1。参见 UIEvent.detail

返回


移动

Added before 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事件。

返回


向上

Added before v1.9 mouse.up

触发一个 mouseup 事件。

用法

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

参数

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

    默认为 left

  • click_count int (可选)#

    默认为1。参见 UIEvent.detail

返回


wheel

Added in: v1.15 mouse.wheel

派发一个wheel事件。此方法通常用于手动滚动页面。关于其他滚动方式,请参阅scrolling

note

如果未处理滚轮事件,可能会导致滚动,而此方法在返回前不会等待滚动完成。

用法

mouse.wheel(delta_x, delta_y)

参数

  • delta_x float#

    水平滚动的像素数。

  • delta_y float#

    垂直滚动的像素数。

返回