Cliquer sur un élément d’interface (ui_element.click)

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

Déclaration

etat, info_ou_erreur = ui_element.click(selecteur_ou_element [, options ])

Paramètres

• selecteur_ou_element type table, peut être un sélecteur, un élément renvoyé par une requête ou une table de coordonnées { x = coord_x, y = coord_y }.
• options paramètre facultatif de type table ; consultez la description des options générales.

Valeur renvoyée

• etat type booléen, vaut true en cas de réussite et nil en cas d’échec.
• info_ou_erreur type table contenant les informations de l’action en cas de réussite, ou texte décrivant la cause de l’échec.

Description

Sert à cliquer sur un bouton, un élément de liste, une touche de clavier ou tout autre élément d’interface cliquable. Les coordonnées de la table sont exprimées en pixels physiques. Pour un clic à coordonnées fixes, utilisez de préférence touch.tap. Lorsque plusieurs cibles correspondent et qu’il est impossible d’en déterminer une seule, nil, "ambiguous target" peut être renvoyé.

Exemple

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.click({
    title = "继续",
    role = "button",
})

if not ok then
    sys.toast(info_or_err)
end

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