Description des champs d’un élément

Ce module est disponible à partir des versions postérieures au 20260507

Les éléments renvoyés par les interfaces de requête sont des tables Lua ordinaires. Les champs proviennent des informations exposées par l’interface actuelle ; ils peuvent différer selon l’application et le type de contrôle.

Champs courants

• text
  type texte, titre lisible de l’élément.
• value
  type quelconque, valeur actuelle de l’élément. Il s’agit généralement du texte actuel pour une zone de texte, de 0 ou 1 pour un interrupteur et d’un texte en pourcentage pour un curseur.
• identifier
  type texte, identifiant de l’élément.
• hint
  type texte, indication d’aide du système.
• bundleId
  type texte, bundle identifier de l’application à laquelle appartient l’élément.
• x / y / width / height
  type entier, zone de l’élément, en pixels physiques.
• centerPoint
  type table, centre de l’élément, en pixels physiques, par exemple { x = 100, y = 200 }.
• children
  type table, tableau des éléments enfants. La profondeur d’expansion est contrôlée par max_level.
• traits
  type entier, valeur des caractéristiques de l’élément.
• traitsDescription
  type table, tableau des noms de caractéristiques de l’élément, par exemple Button, StaticText, Toggle, Adjustable.
• isVisible
  type booléen, indique si l’élément est visible.
• isSelected
  type booléen, indique si l’élément est sélectionné.
• isToggle
  type booléen, indique si l’élément ressemble à un interrupteur.
• isAdjustable
  type booléen, indique si l’élément accepte l’augmentation ou la diminution.
• checked
  type booléen, état confirmé des contrôles tels que les interrupteurs, cases à cocher et boutons radio. Ce champ peut être absent si l’état fiable ne peut pas être lu.
• hasTextEntry
  type booléen, indique si l’élément ressemble à une cible de saisie textuelle.
• isKeyboardKey
  type booléen, indique si l’élément ressemble à une touche de clavier.
• absoluteValue
  type réel, valeur normalisée éventuellement renvoyée par les contrôles réglables tels que les curseurs.

Champs de l’état de détection

Ces champs peuvent apparaître uniquement lorsque include_hit_state, hit_test ou fallback_hit_test est activé, ou lors de la vérification d’une action :

• canHit
  type booléen, indique si l’élément peut actuellement être détecté depuis la couche supérieure.
• hitVerified
  type booléen, indique si l’état de détection a déjà été vérifié.
• hitTestPoint
  type table, point de détection, en pixels physiques.

Description

Les champs d’élément conviennent à la lecture et à la vérification de l’état actuel de l’interface. Pour une localisation stable, utilisez de préférence des champs sémantiques comme text, role, checked et selected pour composer un sélecteur. Après une modification de l’interface, relancez la requête de l’élément ou obtenez un nouveau snapshot.