跳至主要內容

文字元素模組 (ui_element)

該模組在 20260507 以後版本方可使用

ui_element 用於按文字、角色、狀態或座標讀取目前介面上的 UI 元素，並對匹配到的元素執行點選、滾動、輸入、切換、調節等操作。它適合腳本需要理解介面結構、減少硬編碼座標、或在不同分辨率裝置上保持可讀定位邏輯的場景。

固定座標觸控仍建議使用 模擬觸控模組 (touch)。ui_element 中出現的座標均為物理像素。

基本用法​

local ui_element = require("ui_element")

local item, err = ui_element.find({
    title = "搜索",
    role = "text_field",
})

if item then
    ui_element.input_text(item, "hello")
else
    sys.toast(err)
end

說明​

查詢類介面失敗時通常返回 nil, err。 find_all 沒有匹配項時返回空陣列。 動作類介面成功時返回 true, info，失敗時返回 nil, err。 介面發生變化後，之前取得到的快照不再代表最新介面，應重新呼叫 snapshot()。