Нажатие UI-элемента (ui_element.click)

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

Объявление

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

Параметры

• Селектор или элемент Таблица: селектор, элемент, возвращённый поиском, или таблица координат { x = абсцисса, y = ордината }.
• Параметры Необязательная таблица; см. описание общих параметров.

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

• Состояние Логическое значение: при успехе true, при ошибке nil.
• Информация или ошибка При успехе таблица с информацией о действии, при ошибке строка с причиной.

Описание

Нажимает кнопки, элементы списка, клавиши клавиатуры и другие доступные для нажатия UI-элементы. Координаты в таблице указаны в физических пикселях. Для нажатия по фиксированным координатам предпочтительно используйте touch.tap. Если совпадает несколько целей и нельзя определить единственную, может возвращаться nil, "ambiguous target".

Пример

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

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