Pular para o conteúdo principal

Módulo de elementos de texto (ui_element)

Este módulo está disponível somente a partir da versão 20260507.

ui_element lê elementos da interface atual por texto, função, estado ou coordenadas e executa operações como clicar, rolar, inserir texto, alternar e ajustar os elementos correspondentes. É útil quando o script precisa entender a estrutura da interface, reduzir coordenadas codificadas ou manter uma lógica de localização legível em dispositivos com resoluções diferentes.

Para tocar em coordenadas fixas, ainda recomendamos o módulo de simulação de toque (touch). Todas as coordenadas em ui_element são pixels físicos.

Uso básico​

local ui_element = require("ui_element")

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

if item then
    ui_element.input_text(item, "hello")
else
    sys.toast(err)
end

Descrição​

Em geral, as interfaces de consulta retornam nil, err quando falham. find_all retorna um array vazio quando não há correspondências. As interfaces de ação retornam true, info quando têm sucesso e nil, err quando falham. Depois que a interface mudar, um instantâneo obtido anteriormente não representa mais a interface atual; chame snapshot() novamente.