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