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.