Saltar al contenido principal

Módulo de elementos de texto (ui_element)

Este módulo solo está disponible a partir de las versiones posteriores a 20260507

ui_element permite leer los elementos de la interfaz actual por texto, rol, estado o coordenadas, y ejecutar sobre los elementos coincidentes acciones como hacer clic, desplazarse, introducir texto, alternar o ajustar valores. Es adecuado para scripts que necesitan comprender la estructura de la interfaz, reducir las coordenadas codificadas y mantener una lógica de localización legible en dispositivos con distintas resoluciones.

Para la interacción mediante coordenadas fijas, se recomienda seguir usando el módulo de simulación táctil (touch). Las coordenadas que aparecen en ui_element son píxeles 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

Descripción​

Las interfaces de consulta normalmente devuelven nil, err cuando fallan. find_all devuelve un array vacío cuando no hay coincidencias. Las interfaces de acción devuelven true, info cuando tienen éxito y nil, err cuando fallan. Después de que cambie la interfaz, la instantánea obtenida anteriormente ya no representa la interfaz más reciente; se debe volver a llamar a snapshot().