Aller au contenu principal

Module des éléments textuels (ui_element)

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

ui_element permet de lire les éléments d’interface actuels selon leur texte, rôle, état ou coordonnées, puis d’effectuer sur les éléments correspondants des actions telles que le clic, le défilement, la saisie, le basculement ou le réglage. Il convient aux scripts qui doivent comprendre la structure de l’interface, réduire le recours aux coordonnées codées en dur ou conserver une logique de localisation lisible sur des appareils de résolutions différentes.

Pour les actions tactiles à coordonnées fixes, il est toujours recommandé d’utiliser le module d’émulation tactile (touch). Les coordonnées utilisées par ui_element sont exprimées en pixels physiques.

Utilisation de base​

local ui_element = require("ui_element")

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

if item then
    ui_element.input_text(item, "hello")
else
    sys.toast(err)
end

Description​

En cas d’échec d’une interface de requête, nil, err est généralement renvoyé. find_all renvoie un tableau vide lorsqu’aucun élément ne correspond. En cas de réussite d’une interface d’action, true, info est renvoyé ; en cas d’échec, nil, err est renvoyé. Après une modification de l’interface, le snapshot obtenu précédemment ne représente plus l’interface actuelle ; rappelez snapshot().