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.