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.nilem 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úmeroindexentre os resultados correspondentes. Recomenda-se usartitleoutext_containsjunto comrolepara 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.