Saltar al contenido principal

Hacer clic en un elemento UI (ui_element.click)

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

Declaración​

estado, información o información_de_error = ui_element.click(selector_o_elemento [, opciones ])

Parámetros​

  • selector_o_elemento Tipo tabla: puede ser un selector, un elemento devuelto por una consulta o una tabla de coordenadas { x = coordenada_x, y = coordenada_y }.
  • opciones Parámetro opcional, tipo tabla; consulta la descripción de las opciones comunes.

Valor devuelto​

  • estado Tipo booleano: true cuando tiene éxito y nil cuando falla.
  • información o información de error Tipo tabla de información de acción cuando tiene éxito; tipo texto con la causa del error cuando falla.

Descripción​

Se usa para hacer clic en botones, elementos de listas, teclas del teclado u otros elementos UI en los que se pueda hacer clic. Las unidades de las coordenadas de la tabla son píxeles físicos. Para hacer clic en coordenadas fijas, se recomienda usar primero touch.tap. Si coinciden varios objetivos y no se puede determinar uno único, puede devolver nil, "ambiguous target".

Ejemplo​

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.click({
    title = "继续",
    role = "button",
})

if not ok then
    sys.toast(info_or_err)
end

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