Mouse

Mouse 類別以主框架 CSS 像素為單位運作，相對於 viewport 的左上角。

每個 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()

非同步

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

  相對於主框架 viewport 的 X 座標，以 CSS 像素為單位。

• y float#

  相對於主框架 viewport 的 Y 座標，以 CSS 像素為單位。

• button "left" | "right" | "middle" (選填)#

  預設為 left。

• click_count int (選填)#

  預設為 1。請參閱 UIEvent.detail。

• delay float (選填)#

  mousedown 和 mouseup 之間等待的時間，以毫秒為單位。預設為 0。

回傳

• NoneType#

---

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#

  相對於主框架 viewport 的 X 座標，以 CSS 像素為單位。

• y float#

  相對於主框架 viewport 的 Y 座標，以 CSS 像素為單位。

• button "left" | "right" | "middle" (選填)#

  預設為 left。

• delay float (選填)#

  mousedown 和 mouseup 之間等待的時間，以毫秒為單位。預設為 0。

回傳

• NoneType#

---

down

在 v1.9 之前新增 mouse.down

發送 mousedown 事件。

用法

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

引數

• button "left" | "right" | "middle" (選填)#

  預設為 left。

• click_count int (選填)#

  預設為 1。請參閱 UIEvent.detail。

回傳

• NoneType#

---

move

在 v1.9 之前新增 mouse.move

發送 mousemove 事件。

用法

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

引數

• x float#

  相對於主框架 viewport 的 X 座標，以 CSS 像素為單位。

• y float#

  相對於主框架 viewport 的 Y 座標，以 CSS 像素為單位。

• steps int (選填)#

  預設為 1。發送中繼 mousemove 事件。

回傳

• NoneType#

---

up

在 v1.9 之前新增 mouse.up

發送 mouseup 事件。

用法

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

引數

• button "left" | "right" | "middle" (選填)#

  預設為 left。

• click_count int (選填)#

  預設為 1。請參閱 UIEvent.detail。

回傳

• NoneType#

---

wheel

新增於：v1.15 mouse.wheel

發送 wheel 事件。此方法通常用於手動滾動頁面。請參閱 滾動 以了解滾動的替代方法。

注意

如果未處理滾輪事件，可能會導致滾動，並且此方法不會等待滾動完成才返回。

用法

mouse.wheel(delta_x, delta_y)

引數

• delta_x float#

  水平滾動的像素數。

• delta_y float#

  垂直滾動的像素數。

回傳

• NoneType#