Tìm một phần tử giao diện (ui_element.find)

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

Khai báo

element, err = ui_element.find(selector [, options ])

Tham số

• selector Bảng. Mô tả phần tử giao diện đích. Xem Trường bộ chọn.
• options Không bắt buộc, bảng. Xem Tùy chọn chung.

Giá trị trả về

• element Bảng. Phần tử giao diện khớp đầu tiên. nil khi thất bại.
• err Chuỗi. Lý do thất bại. Khi không có phần tử nào khớp, giá trị thường là "target not found".

Mô tả

Nếu có selector.index, phần tử khớp thứ N sẽ được trả về. Nên dùng title hoặc text_contains cùng với role để giảm mơ hồ.

Ví dụ

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.click(item)
else
    sys.toast(err)
end

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