跳至主要内容

鼠标

Mouse 类在视口左上角相对于主框架 CSS 像素进行操作。

每个page对象都有自己的 Mouse，可以通过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()

方法​

click​

在 v1.9 之前添加 mouse.click

用于mouse.move()、mouse.down()、mouse.up()的快捷方式。

用法

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

参数

  • x 浮点数#

    相对于主框架视口以 CSS 像素为单位的 X 坐标。

  • y 浮点数#

    相对于主框架视口以 CSS 像素为单位的 Y 坐标。

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

    默认为left。

  • click_count 整数 (可选)#

    默认为 1。请参阅UIEvent.detail。

  • delay 浮点数 (可选)#

    以毫秒为单位等待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 浮点数#

    相对于主框架视口以 CSS 像素为单位的 X 坐标。

  • y 浮点数#

    相对于主框架视口以 CSS 像素为单位的 Y 坐标。

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

    默认为left。

  • delay 浮点数 (可选)#

    以毫秒为单位等待mousedown和mouseup之间的时间。默认为 0。

返回值

down​

在 v1.9 之前添加 mouse.down

分发mousedown事件。

用法

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

参数

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

    默认为left。

  • click_count 整数 (可选)#

    默认为 1。请参阅UIEvent.detail。

返回值

move​

在 v1.9 之前添加 mouse.move

分发mousemove事件。

用法

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

参数

  • x 浮点数#

    相对于主框架视口以 CSS 像素为单位的 X 坐标。

  • y 浮点数#

    相对于主框架视口以 CSS 像素为单位的 Y 坐标。

  • steps 整数 (可选)#

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

返回值

up​

在 v1.9 之前添加 mouse.up

分发mouseup事件。

用法

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

参数

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

    默认为left。

  • click_count 整数 (可选)#

    默认为 1。请参阅UIEvent.detail。

返回值

wheel​

添加于：v1.15 mouse.wheel

分发wheel事件。此方法通常用于手动滚动页面。有关滚动页面的替代方法，请参阅滚动。

注意

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

用法

mouse.wheel(delta_x, delta_y)

参数

返回值