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

Mô-đun phần tử văn bản (ui_element)

Mô-đun này khả dụng trong các phiên bản sau 20260507

ui_element đọc các phần tử giao diện trên màn hình hiện tại theo văn bản, vai trò, trạng thái hoặc tọa độ, rồi thực hiện các thao tác như nhấn, cuộn, nhập văn bản, chuyển đổi và điều chỉnh trên phần tử khớp. Mô-đun hữu ích khi kịch bản cần hiểu giao diện hiện tại, giảm tọa độ mã hóa cứng hoặc duy trì logic chọn mục tiêu dễ đọc trên nhiều thiết bị.

Với thao tác chạm theo tọa độ cố định, nên dùng Mô-đun chạm. Tọa độ do ui_element cung cấp được tính bằng pixel vật lý.

Cách dùng cơ bản​

local ui_element = require("ui_element")

local item, err = ui_element.find({
    title = "Tìm kiếm",
    role = "text_field",
})

if item then
    ui_element.input_text(item, "xin chào")
else
    sys.toast(err)
end

Mô tả​

API truy vấn thường trả về nil, err khi thất bại. find_all trả về mảng rỗng khi không có phần tử nào khớp. API thao tác trả về true, info khi thành công và nil, err khi thất bại. Sau khi giao diện thay đổi, ảnh chụp trạng thái trước đó không còn đại diện cho màn hình mới nhất. Hãy gọi lại snapshot().