跳到主要内容

获取一次 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