Перейти к основному содержимому

Модуль текстовых элементов (ui_element)

Модуль доступен в версиях после 20260507.

ui_element считывает UI-элементы текущего интерфейса по тексту, роли, состоянию или координатам и выполняет над найденными элементами нажатие, прокрутку, ввод, переключение и регулировку. Модуль подходит, когда скрипту нужно понимать структуру интерфейса, уменьшить число жёстко заданных координат или сохранить читаемую логику поиска на устройствах с разным разрешением.

Для касаний по фиксированным координатам по-прежнему рекомендуется модуль имитации касаний (touch). Все координаты в ui_element указаны в физических пикселях.

Основное использование​

local ui_element = require("ui_element")

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

if item then
    ui_element.input_text(item, "hello")
else
    sys.toast(err)
end

Описание​

При ошибке интерфейсы поиска обычно возвращают nil, err. Если find_all ничего не нашёл, возвращается пустой массив. При успехе интерфейсы действий возвращают true, info, при ошибке — nil, err. После изменения интерфейса ранее полученный снимок больше не отражает актуальное состояние; вызовите snapshot() повторно.