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

UI 要素をクリック (ui_element.click)

この関数は 20260507 以降のバージョンでのみ使用できます

宣言​

状態, 情報またはエラー情報 = ui_element.click(セレクターまたは要素 [, オプション ])

パラメータ​

  • セレクターまたは要素 テーブル型。セレクター、クエリが返した要素、または { x = 横座標, y = 縦座標 } の座標テーブルを指定できます。
  • オプション 省略可能なテーブル型。共通オプションの説明を参照してください。

戻り値​

  • 状態 ブール型。成功時は true、失敗時は nil です。
  • 情報またはエラー情報 成功時はテーブル型のアクション情報、失敗時は文字列型のエラー理由です。

説明​

ボタン、リスト項目、キーボードキー、その他のクリック可能な UI をクリックするために使用します。 座標テーブル内の座標単位は物理ピクセルです。固定座標のクリックには touch.tap を優先して使用してください。 複数の対象が一致し、一意の対象を判定できない場合は nil, "ambiguous target" を返すことがあります。

例​

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.click({
    title = "继续",
    role = "button",
})

if not ok then
    sys.toast(info_or_err)
end

注記：上記のコードでは、この章で扱っていない関数 sys.toast を使用しています。