Pular para o conteúdo principal

Rolar um elemento de UI ou a página atual (ui_element.scroll)

Esta função está disponível somente a partir da versão 20260507.

Declarações​

estado, informacoes_ou_erro = ui_element.scroll(direcao [, opcoes])
estado, informacoes_ou_erro = ui_element.scroll(seletor_ou_elemento, direcao [, opcoes])

Parâmetros​

  • seletor_ou_elemento Tabela opcional; pode ser um seletor, um elemento retornado por uma consulta ou uma tabela de coordenadas { x = coordenada_x, y = coordenada_y }.
  • direcao Texto; aceita "down", "up", "left", "right", "top" e "bottom".
  • opcoes Tabela opcional. Use point, x e y para especificar o ponto de acerto ou steps para especificar o parâmetro de passo.

Valores retornados​

  • estado Booleano; true em caso de sucesso e nil em caso de falha.
  • informacoes_ou_erro Informações de ação em formato de tabela em caso de sucesso; motivo da falha em formato de texto em caso de erro.

Descrição​

Sem um seletor, tenta rolar a página atual por padrão. Quando um seletor é fornecido, tenta rolar a região rolável que contém o elemento de destino. Para rolar várias páginas de forma determinada, recomenda-se fazer chamadas em um loop no script Lua e verificar as mudanças da página.

Exemplo​

local ui_element = require("ui_element")

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

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