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

Модуль доступен в версиях после 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 и других. После изменения интерфейса повторно найдите элемент или получите новый снимок.