Description des champs du sélecteur

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

Un sélecteur est une table Lua qui décrit l’élément d’interface à rechercher ou à manipuler. Il est recommandé d’utiliser en priorité une combinaison de texte lisible et de rôle pour la localisation, puis d’ajouter index si nécessaire pour distinguer des éléments portant le même nom.

Exemple

local selector = {
    title = "搜索",
    role = "text_field",
}

local item = ui_element.find(selector)

Champs

• title / text
  type texte, titre lisible correspondant à l’élément. Les deux champs ont la même signification.
• text_contains
  type texte, sous-chaîne à rechercher dans le titre lisible.
• value
  type texte, numérique ou booléen, valeur actuelle correspondant à celle de l’élément.
• value_contains
  type texte, sous-chaîne à rechercher dans la valeur de l’élément.
• identifier
  type texte, identifiant correspondant à celui de l’élément. Certaines applications ne le fournissent pas.
• bundle_id
  type texte, bundle identifier de l’application à laquelle appartient l’élément.
• role
  type texte, type d’élément. Les valeurs courantes comprennent button, text_field, static_text, switch, checkbox, radio, slider, picker, scrollable, link, image, keyboard_key.
• traits
  type texte ou tableau de textes, noms des caractéristiques de l’élément, par exemple Button, StaticText, Toggle, Adjustable.
• visible
  type booléen, indique si l’élément est visible.
• hittable
  type booléen, indique si l’élément peut actuellement être détecté. Les interfaces d’action nécessitent généralement que la cible puisse être détectée.
• checked
  type booléen, état confirmé correspondant aux interrupteurs, cases à cocher et boutons radio.
• selected
  type booléen, indique si l’élément est sélectionné.
• index
  type entier, lorsque plusieurs éléments correspondent, sélectionne le n-ième élément ; conformément aux habitudes Lua, l’index commence à 1.

Description

Il est déconseillé d’utiliser comme sélecteurs principaux des champs qui changent facilement, tels que les coordonnées, dimensions ou identifiants de fenêtre. Lorsque plusieurs éléments correspondent sans que index soit indiqué, une interface d’action peut renvoyer nil, "ambiguous target". Les champs exposés peuvent différer selon l’application et la version d’iOS ; prévoyez une gestion adaptée lorsque des champs importants sont absents.