Aller au contenu principal

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.