Faire défiler un élément d’interface ou la page actuelle (ui_element.scroll)

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

Déclaration

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

Paramètres

• selecteur_ou_element paramètre facultatif de type table, pouvant être un sélecteur, un élément renvoyé par une requête ou une table de coordonnées { x = coord_x, y = coord_y }.
• direction type texte, accepte "down", "up", "left", "right", "top" et "bottom".
• options paramètre facultatif de type table. point, x et y permettent d’indiquer le point de détection ; steps permet d’indiquer le paramètre de pas.

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

Sans sélecteur, tente par défaut de faire défiler la page actuelle. Avec un sélecteur, tente de faire défiler la zone défilable contenant l’élément cible. Pour garantir le défilement de plusieurs pages, il est recommandé d’appeler la fonction en boucle dans le script Lua et de vérifier soi-même les changements de page.

Exemple

local ui_element = require("ui_element")

ui_element.scroll("down", {
    point = { x = 200, y = 700 },
})

ui_element.scroll({
    text_contains = "列表",
}, "up")