Localizar um elemento de UI (ui_element.find)

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

Declaração

elemento, mensagem_de_erro = ui_element.find(seletor [, opcoes])

Parâmetros

• seletor Tabela que descreve o elemento de UI a localizar; consulte Descrição dos campos do seletor.
• opcoes Tabela opcional; consulte Descrição das opções comuns.

Valores retornados

• elemento Tabela; primeiro elemento de UI correspondente. nil em caso de falha.
• mensagem_de_erro Texto; motivo da falha. Normalmente é "target not found" quando não há correspondência.

Descrição

Se o seletor contiver index, retorna o elemento de número index entre os resultados correspondentes. Recomenda-se usar title ou text_contains junto com role para reduzir a ambiguidade causada por elementos com o mesmo nome.

Exemplo

local ui_element = require("ui_element")

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

if item then
    ui_element.click(item)
else
    sys.toast(err)
end

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