跳至主要內容

點選 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