Buscar un elemento UI (ui_element.find)

Esta función solo está disponible a partir de las versiones posteriores a 20260507

Declaración

elemento, información_de_error = ui_element.find(selector [, opciones ])

Parámetros

• selector Tipo tabla que describe el elemento UI que se desea buscar; consulta la descripción de los campos del selector.
• opciones Parámetro opcional, tipo tabla; consulta la descripción de las opciones comunes.

Valor devuelto

• elemento Tipo tabla: primer elemento UI coincidente. Es nil cuando falla.
• información de error Tipo texto: causa del error. Cuando no hay coincidencias normalmente es "target not found".

Descripción

Si el selector contiene index, se devuelve el elemento que ocupa la posición index entre los resultados coincidentes. Se recomienda usar title o text_contains junto con role para localizar elementos y reducir la ambigüedad causada por elementos con el mismo nombre.

Ejemplo

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

Nota: el código anterior usa la función de fuera de este capítulo sys.toast