Saltar al contenido principal

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.