跳至主要內容

取得一次 UI 快照 (ui_element.snapshot)

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

聲明​

快照, 錯誤資訊 = ui_element.snapshot([ 選項 ])

參數​

回傳值​

  • 快照 表型，包含目前 UI 元素清單和快照方法。失敗時為 nil。
  • 錯誤資訊 文字型，失敗原因。

快照方法​

元素 = 快照:find(選擇器)
元素清單 = 快照:find_all(選擇器)
狀態, 資訊 = 快照:click(選擇器或元素 [, 選項 ])
狀態, 資訊 = 快照:scroll([ 選擇器或元素, ] 方向 [, 選項 ])
狀態, 資訊 = 快照:input_text(選擇器或元素, 文字 [, 選項 ])
狀態, 資訊 = 快照:set_text(選擇器或元素, 文字 [, 選項 ])
狀態, 資訊 = 快照:clear_text(選擇器或元素 [, 選項 ])
狀態, 資訊 = 快照:toggle(選擇器或元素 [, 選項 ])
狀態, 資訊 = 快照:set_checked(選擇器或元素, 勾選狀態 [, 選項 ])
狀態, 資訊 = 快照:set_value(選擇器或元素, 值 [, 選項 ])
狀態, 資訊 = 快照:increase(選擇器或元素 [, 選項 ])
狀態, 資訊 = 快照:decrease(選擇器或元素 [, 選項 ])

說明​

快照是一次性結果，適合在同一介面內多次查找或連續操作。 介面發生跳轉、彈窗、滾動或內容重新整理後，應重新呼叫 snapshot()。 快照表常見字段包括 elements 和 count。

範例​

local ui_element = require("ui_element")

local ui, err = ui_element.snapshot({
    max_level = 2,
})

if ui then
    local search = ui:find({
        title = "搜索",
        role = "text_field",
    })
    if search then
        ui:set_text(search, "XXTouch")
    end
else
    sys.toast(err)
end

注：上述代碼中使用了非本章函式 sys.toast