Saltar al contenido principal

Descripción de los campos del selector

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

Un selector es una tabla Lua que describe el elemento UI que se desea buscar u operar. Se recomienda localizarlo primero mediante una combinación de texto legible y rol, y añadir index solo cuando sea necesario para distinguir elementos con el mismo nombre.

Ejemplo​

local selector = {
    title = "搜索",
    role = "text_field",
}

local item = ui_element.find(selector)

Campos​

  • title / text Tipo texto: coincide con el título legible del elemento. Ambos tienen el mismo significado.
  • text_contains Tipo texto: coincide con la subcadena contenida en el título legible.
  • value Tipo texto, numérico o booleano: coincide con el valor actual del elemento.
  • value_contains Tipo texto: coincide con la subcadena contenida en el valor del elemento.
  • identifier Tipo texto: coincide con el identificador del elemento. No todas las aplicaciones lo proporcionan.
  • bundle_id Tipo texto: coincide con el bundle identifier de la aplicación a la que pertenece el elemento.
  • role Tipo texto: coincide con el tipo de elemento. Los valores habituales incluyen button, text_field, static_text, switch, checkbox, radio, slider, picker, scrollable, link, image y keyboard_key.
  • traits Tipo texto o array de textos: coincide con los nombres de las características del elemento, por ejemplo, Button, StaticText, Toggle y Adjustable.
  • visible Tipo booleano: coincide con si el elemento es visible.
  • hittable Tipo booleano: coincide con si actualmente se puede alcanzar el elemento. Las interfaces de acción normalmente requieren que el objetivo se pueda alcanzar.
  • checked Tipo booleano: coincide con el estado confirmable de interruptores, casillas, opciones de selección única y otros controles.
  • selected Tipo booleano: coincide con si el elemento está seleccionado.
  • index Tipo entero: cuando hay varias coincidencias, selecciona cuál devolver, empezando por 1 según la convención de Lua.

Descripción​

No se recomienda usar como selector principal campos que cambian con facilidad, como coordenadas, dimensiones o identificadores de ventana. Si coinciden varios elementos y no se especifica index, las interfaces de acción pueden devolver nil, "ambiguous target". Los campos expuestos pueden variar entre aplicaciones y versiones de iOS; se debe prever una lógica para cuando falten campos esenciales.