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

Nhấn phần tử giao diện (ui_element.click)

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.click(selector_or_element [, options ])

Tham số​

  • selector_or_element 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 }.
  • options Không bắt buộc, bảng. Xem Tùy chọn chung.

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ả​

Nhấn một nút, mục danh sách, phím bàn phím hoặc phần tử giao diện có thể nhấn khác. Tọa độ trong bảng tọa độ dùng pixel vật lý. Với thao tác nhấn theo tọa độ cố định, nên dùng touch.tap. Nếu nhiều mục tiêu cùng khớp và không thể chọn một mục tiêu duy nhất, API này có thể trả về nil, "ambiguous target".

Ví dụ​

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.click({
    title = "Tiếp tục",
    role = "button",
})

if not ok then
    sys.toast(info_or_err)
end

Lưu ý: Ví dụ dùng API ngoài chương này là sys.toast.