Chuyển tới nội dung chính

Cuộn phần tử giao diện hoặc trang hiện tại (ui_element.scroll)

Hàm này khả dụng trong các phiên bản sau 20260507

Khai báo​

ok, info_or_err = ui_element.scroll(direction [, options ])
ok, info_or_err = ui_element.scroll(selector_or_element, direction [, options ])

Tham số​

  • selector_or_element Không bắt buộc, bảng. Một bộ chọn, phần tử do truy vấn trả về hoặc bảng tọa độ { x = X, y = Y }.
  • direction Chuỗi. Các giá trị được hỗ trợ: "down", "up", "left", "right", "top", "bottom".
  • options Không bắt buộc, bảng. Dùng point, x hoặc y để chọn điểm tương tác; dùng steps làm tham số bước.

Giá trị trả về​

  • ok Boolean. true khi thành công, nil khi thất bại.
  • info_or_err Bảng khi thành công, chuỗi lý do thất bại khi thất bại.

Mô tả​

Khi không có bộ chọn, API này thử cuộn trang hiện tại. Khi có bộ chọn, API thử cuộn vùng có thể cuộn chứa mục tiêu. Nếu cần cuộn nhiều trang, hãy gọi API trong vòng lặp Lua và tự kiểm tra thay đổi của trang.

Ví dụ​

local ui_element = require("ui_element")

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

ui_element.scroll({
    text_contains = "Danh sách",
}, "up")