요소 필드 설명

이 모듈은 20260507 이후 버전에서 사용할 수 있습니다.

조회 인터페이스가 반환하는 요소는 일반 Lua 테이블입니다. 필드는 현재 화면에서 노출하는 정보에서 가져오며 App과 컨트롤 유형에 따라 반환되는 필드가 다를 수 있습니다.

일반 필드

• text 문자열. 요소의 읽을 수 있는 제목입니다.
• value 임의 유형. 요소의 현재 값입니다. 텍스트 상자는 일반적으로 현재 텍스트이고, 스위치는 0 또는 1, 슬라이더는 백분율 텍스트일 수 있습니다.
• identifier 문자열. 요소 식별자입니다.
• hint 문자열. 시스템 접근성 힌트입니다.
• bundleId 문자열. 요소가 속한 App의 bundle identifier입니다.
• x / y / width / height 정수. 물리 픽셀 단위의 요소 영역입니다.
• centerPoint 테이블. 물리 픽셀 단위의 요소 중심점입니다. 예: { x = 100, y = 200 }.
• children 테이블. 하위 요소 배열이며 펼칠 깊이는 max_level로 제어합니다.
• traits 정수. 요소 특성 값입니다.
• traitsDescription 테이블. 요소 특성 이름 배열입니다. 예: Button, StaticText, Toggle, Adjustable.
• isVisible 불리언. 요소가 보이는지 여부입니다.
• isSelected 불리언. 요소가 선택되었는지 여부입니다.
• isToggle 불리언. 요소가 스위치 컨트롤과 같은지 여부입니다.
• isAdjustable 불리언. 요소가 값 증가와 감소를 지원하는지 여부입니다.
• checked 불리언. 스위치, 체크 상자, 라디오 항목 같은 컨트롤의 체크 상태입니다. 신뢰할 수 있는 상태를 읽을 수 없으면 이 필드가 없을 수 있습니다.
• hasTextEntry 불리언. 요소가 텍스트 입력 대상과 같은지 여부입니다.
• isKeyboardKey 불리언. 요소가 키보드 키와 같은지 여부입니다.
• absoluteValue 실수. 슬라이더 같은 조절 가능한 컨트롤이 반환할 수 있는 정규화된 값입니다.

히트 상태 필드

이 필드는 include_hit_state, hit_test, fallback_hit_test를 사용하거나 동작을 검증할 때만 나타날 수 있습니다.

• canHit 불리언. 현재 최상위에서 히트할 수 있는지 여부입니다.
• hitVerified 불리언. 히트 상태를 검증했는지 여부입니다.
• hitTestPoint 테이블. 물리 픽셀 단위의 히트 지점입니다.

설명

요소 필드는 현재 화면 상태를 읽고 판단하는 데 적합합니다. 안정적으로 위치를 지정하려면 text, role, checked, selected 같은 의미 기반 필드를 우선 사용하여 선택자를 구성하십시오. 화면이 바뀌면 요소를 다시 조회하거나 스냅샷을 다시 가져와야 합니다.