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

Trường phần tử

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

Các phần tử do API truy vấn trả về là bảng Lua thuần. Các trường được lấy từ giao diện hiện tại, vì vậy ứng dụng và loại điều khiển khác nhau có thể trả về các trường khác nhau.

Trường chung​

  • text
    Chuỗi. Tiêu đề dễ đọc của phần tử.
  • value
    Kiểu bất kỳ. Giá trị hiện tại của phần tử. Trường văn bản thường cung cấp nội dung hiện tại, công tắc có thể cung cấp 0 hoặc 1, còn thanh trượt có thể cung cấp văn bản phần trăm.
  • identifier
    Chuỗi. Mã định danh phần tử.
  • hint
    Chuỗi. Văn bản gợi ý của hệ thống.
  • bundleId
    Chuỗi. Mã định danh gói của ứng dụng sở hữu phần tử.
  • x / y / width / height
    Số nguyên. Khung phần tử tính bằng pixel vật lý.
  • centerPoint
    Bảng. Tâm phần tử tính bằng pixel vật lý, ví dụ { x = 100, y = 200 }.
  • children
    Bảng. Mảng phần tử con. Độ sâu mở rộng do max_level điều khiển.
  • traits
    Số nguyên. Giá trị đặc tính thô.
  • traitsDescription
    Bảng. Mảng tên đặc tính, chẳng hạn Button, StaticText, Toggle, Adjustable.
  • isVisible
    Boolean. Phần tử có hiển thị hay không.
  • isSelected
    Boolean. Phần tử có được chọn hay không.
  • isToggle
    Boolean. Phần tử có hoạt động như công tắc hay không.
  • isAdjustable
    Boolean. Phần tử có hỗ trợ tăng hoặc giảm hay không.
  • checked
    Boolean. Trạng thái đã xác nhận của công tắc, hộp kiểm, nút chọn và các điều khiển tương tự. Trường có thể không tồn tại khi không thể đọc trạng thái một cách đáng tin cậy.
  • hasTextEntry
    Boolean. Phần tử có vẻ là mục tiêu nhập văn bản hay không.
  • isKeyboardKey
    Boolean. Phần tử có vẻ là một phím bàn phím hay không.
  • absoluteValue
    Số. Giá trị đã chuẩn hóa có thể xuất hiện trên các điều khiển có thể điều chỉnh như thanh trượt.

Trường trạng thái tương tác​

Các trường này có thể chỉ xuất hiện khi dùng include_hit_state, hit_test, fallback_hit_test hoặc phép kiểm tra thao tác:

  • canHit
    Boolean. Hiện có thể tương tác với phần tử từ lớp trên cùng hay không.
  • hitVerified
    Boolean. Trạng thái tương tác đã được kiểm tra hay chưa.
  • hitTestPoint
    Bảng. Điểm tương tác tính bằng pixel vật lý.

Mô tả​

Các trường phần tử hữu ích để đọc và kiểm tra trạng thái giao diện hiện tại. Để chọn mục tiêu ổn định, nên dùng các trường ngữ nghĩa như text, role, checked và selected. Sau khi giao diện thay đổi, hãy truy vấn lại phần tử hoặc chụp trạng thái mới.