Descripción de los campos del elemento

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

Los elementos devueltos por las interfaces de consulta son tablas Lua normales. Los campos proceden de la información expuesta por la interfaz actual, y distintas aplicaciones y tipos de controles pueden devolver campos diferentes.

Campos comunes

• text Tipo texto: título legible del elemento.
• value Tipo arbitrario: valor actual del elemento. En un cuadro de texto suele ser el texto actual, un interruptor puede ser 0 o 1 y un control deslizante puede ser un texto porcentual.
• identifier Tipo texto: identificador del elemento.
• hint Tipo texto: indicación auxiliar del sistema.
• bundleId Tipo texto: bundle identifier de la aplicación a la que pertenece el elemento.
• x / y / width / height Tipo entero: región del elemento, en píxeles físicos.
• centerPoint Tipo tabla: punto central del elemento, en píxeles físicos; por ejemplo, { x = 100, y = 200 }.
• children Tipo tabla: array de elementos secundarios. La profundidad de expansión la controla max_level.
• traits Tipo entero: valor de características del elemento.
• traitsDescription Tipo tabla: array de nombres de características del elemento, por ejemplo, Button, StaticText, Toggle y Adjustable.
• isVisible Tipo booleano: indica si el elemento es visible.
• isSelected Tipo booleano: indica si el elemento está seleccionado.
• isToggle Tipo booleano: indica si el elemento se comporta como un control de alternancia.
• isAdjustable Tipo booleano: indica si el elemento admite ajustes incrementales.
• checked Tipo booleano: estado confirmado de controles como interruptores, casillas y opciones de selección única. Puede no existir si no se puede leer un estado fiable.
• hasTextEntry Tipo booleano: indica si el elemento se comporta como un destino de entrada de texto.
• isKeyboardKey Tipo booleano: indica si el elemento se comporta como una tecla del teclado.
• absoluteValue Tipo real: valor normalizado que pueden devolver controles ajustables como los deslizadores.

Campos del estado de impacto

Estos campos solo pueden aparecer cuando se habilita include_hit_state, hit_test o fallback_hit_test, o al verificar una acción:

• canHit Tipo booleano: indica si actualmente se puede alcanzar el elemento desde la capa superior.
• hitVerified Tipo booleano: indica si ya se ha verificado el estado de impacto.
• hitTestPoint Tipo tabla: punto de impacto, en píxeles físicos.

Descripción

Los campos del elemento son adecuados para leer y evaluar el estado actual de la interfaz. Para una localización estable, se recomienda formar el selector con campos semánticos como text, role, checked y selected. Después de que cambie la interfaz, se deben volver a consultar los elementos o a obtener una instantánea.