メインコンテンツまでスキップ

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")