Rechercher un élément d’interface (ui_element.find)

Cette fonction est disponible à partir des versions postérieures au 20260507

Déclaration

element, message_erreur = ui_element.find(selecteur [, options ])

Paramètres

• selecteur type table décrivant l’élément d’interface à rechercher ; consultez la description des champs du sélecteur.
• options paramètre facultatif de type table ; consultez la description des options générales.

Valeur renvoyée

• element type table, premier élément d’interface correspondant. En cas d’échec, nil est renvoyé.
• message_erreur type texte, cause de l’échec. Lorsqu’aucun élément ne correspond, la valeur est généralement "target not found".

Description

Si le sélecteur contient index, renvoie le n-ième élément correspondant. Il est recommandé d’utiliser title ou text_contains avec role pour la localisation, afin de réduire les ambiguïtés entre éléments portant le même nom.

Exemple

local ui_element = require("ui_element")

local item, err = ui_element.find({
    title = "搜索",
    role = "text_field",
})

if item then
    ui_element.click(item)
else
    sys.toast(err)
end

Remarque : le code utilise la fonction sys.toast, qui n’appartient pas à ce chapitre.