Pular para o conteúdo principal

Clicar em um elemento de UI (ui_element.click)

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

Declaração​

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

Parâmetros​

  • seletor_ou_elemento Tabela; pode ser um seletor, um elemento retornado por uma consulta ou uma tabela de coordenadas { x = coordenada_x, y = coordenada_y }.
  • opcoes Tabela opcional; consulte Descrição das opções comuns.

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​

Usada para clicar em botões, itens de lista, teclas do teclado e outras UIs clicáveis. As coordenadas na tabela de coordenadas são pixels físicos. Para clicar em coordenadas fixas, prefira touch.tap. Pode retornar nil, "ambiguous target" quando vários destinos correspondem e não é possível determinar um único destino.

Exemplo​

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

Observação: o código acima usa a função sys.toast, que não pertence a este capítulo.