跳至主要內容

滾動 UI 元素或目前頁面 (ui_element.scroll)

該函式在 20260507 以後版本方可使用

聲明​

狀態, 資訊或錯誤資訊 = ui_element.scroll(方向 [, 選項 ])
狀態, 資訊或錯誤資訊 = ui_element.scroll(選擇器或元素, 方向 [, 選項 ])

參數​

  • 選擇器或元素 可選參數，表型，可以是 選擇器、查詢返回的元素，或 { x = 橫座標, y = 縱座標 } 座標表。
  • 方向 文字型，支援 "down"、"up"、"left"、"right"、"top"、"bottom"。
  • 選項 可選參數，表型。可使用 point、x、y 指定命中點，也可使用 steps 指定步進參數。

回傳值​

  • 狀態 布林型，成功時為 true，失敗時為 nil。
  • 資訊或錯誤資訊 成功時為表型動作資訊，失敗時為文字型錯誤原因。

說明​

不傳選擇器時，預設嘗試滾動目前頁面。 傳入選擇器時，會嘗試滾動目標元素所在的可滾動區域。 如果需要確定滾動多頁，建議在 Lua 腳本中循環呼叫並自行檢查頁面變化。

範例​

local ui_element = require("ui_element")

ui_element.scroll("down", {
    point = { x = 200, y = 700 },
})

ui_element.scroll({
    text_contains = "列表",
}, "up")