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.