Прокрутка UI-элемента или текущей страницы (ui_element.scroll)

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

Объявление

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

Параметры

• селектор или элемент Необязательная таблица: селектор, элемент, возвращённый запросом, либо таблица координат { x = абсцисса, y = ордината }.
• направление Строка: поддерживаются "down", "up", "left", "right", "top" и "bottom".
• параметры Необязательная таблица. С помощью point, x и y можно задать точку попадания, а с помощью steps — шаг прокрутки.

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

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

Описание

Если селектор не передан, по умолчанию выполняется попытка прокрутить текущую страницу. При передаче селектора выполняется попытка прокрутить прокручиваемую область, содержащую целевой элемент. Если требуется прокрутить несколько страниц с проверкой результата, вызывайте функцию в цикле Lua и самостоятельно отслеживайте изменения страницы.

Пример

local ui_element = require("ui_element")

ui_element.scroll("down", {
    point = { x = 200, y = 700 },
})

ui_element.scroll({
    text_contains = "列表",
}, "up")