Описание полей элемента

Модуль доступен в версиях после 20260507.

Элемент, возвращаемый интерфейсом поиска, представляет собой обычную таблицу Lua. Поля основаны на данных текущего интерфейса; разные App и типы элементов могут возвращать разные поля.

Распространённые поля

• text Строка, читаемый заголовок элемента.
• value Любой тип, текущее значение элемента. Для текстового поля это обычно текущий текст, для переключателя — 0 или 1, для ползунка — процентная строка.
• identifier Строка, идентификатор элемента.
• hint Строка, системная подсказка для специальных возможностей.
• bundleId Строка, bundle identifier App, которому принадлежит элемент.
• 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 и других. После изменения интерфейса повторно найдите элемент или получите новый снимок.