ui_element 使用範例

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

查找並點選按鈕

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

查找搜尋框並輸入文字

local ui_element = require("ui_element")

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

if search then
    ui_element.set_text(search, "XXTouch")
else
    sys.toast(err)
end

讀取目前頁面上的文字

local ui_element = require("ui_element")

local list, err = ui_element.list_text_elements({
    max_level = 1,
})

if list then
    for _, item in ipairs(list) do
        if item.text then
            nLog(item.text)
        end
    end
else
    sys.toast(err)
end

滾動目前頁面

local ui_element = require("ui_element")

ui_element.scroll("down", {
    point = { x = 200, y = 700 },
})

切換開關

local ui_element = require("ui_element")

ui_element.set_checked({
    title = "飞行模式",
    role = "switch",
}, false)

復用一次快照

local ui_element = require("ui_element")

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

if ui then
    local item = ui:find({ text_contains = "隐私" })
    if item then
        ui:click(item)
    end
else
    sys.toast(err)
end

調節滑塊或滾輪

local ui_element = require("ui_element")

ui_element.increase({
    role = "slider",
    index = 1,
})

ui_element.decrease({
    role = "picker",
    index = 1,
}, {
    steps = 2,
})

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