Поиск UI-элемента (ui_element.find)

Эта функция доступна в версиях после 20260507.

Объявление

элемент, сообщение_об_ошибке = ui_element.find(селектор [, параметры ])

Параметры

• селектор Таблица с описанием искомого UI-элемента; см. описание полей селектора.
• параметры Необязательные параметры в виде таблицы; см. описание общих параметров.

Возвращаемые значения

• элемент Таблица с первым совпавшим UI-элементом. При ошибке возвращается nil.
• сообщение об ошибке Строка с причиной ошибки. Если совпадений нет, обычно возвращается "target not found".

Описание

Если селектор содержит index, возвращается index-й элемент среди совпадений. Для однозначного поиска рекомендуется сочетать title или text_contains с role, чтобы уменьшить неоднозначность одноимённых элементов.

Пример

local ui_element = require("ui_element")

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

if item then
    ui_element.click(item)
else
    sys.toast(err)
end

Примечание: в приведённом коде используется функция из другой главы — sys.toast.