Pular para o conteúdo principal

Descrição dos campos do elemento

Este módulo está disponível somente a partir da versão 20260507.

Os elementos retornados pelas interfaces de consulta são tabelas Lua comuns. Os campos vêm das informações expostas pela interface atual; aplicativos e tipos de controle diferentes podem retornar campos diferentes.

Campos comuns​

  • text
    Texto; título legível do elemento.
  • value
    Qualquer tipo; valor atual do elemento. Em geral é o texto atual para campos de texto, pode ser 0 ou 1 para interruptores e pode ser um texto percentual para controles deslizantes.
  • identifier
    Texto; identificador do elemento.
  • hint
    Texto; dica de acessibilidade do sistema.
  • bundleId
    Texto; bundle identifier do aplicativo ao qual o elemento pertence.
  • x / y / width / height
    Inteiro; região do elemento, em pixels físicos.
  • centerPoint
    Tabela; ponto central do elemento, em pixels físicos, por exemplo { x = 100, y = 200 }.
  • children
    Tabela; array de elementos filhos. A profundidade de expansão é controlada por max_level.
  • traits
    Inteiro; valor das características do elemento.
  • traitsDescription
    Tabela; array de nomes das características do elemento, como Button, StaticText, Toggle e Adjustable.
  • isVisible
    Booleano; indica se o elemento está visível.
  • isSelected
    Booleano; indica se o elemento está selecionado.
  • isToggle
    Booleano; indica se o elemento se comporta como um interruptor.
  • isAdjustable
    Booleano; indica se o elemento aceita ajustes de aumento e redução.
  • checked
    Booleano; estado confirmado de controles como interruptores, caixas de seleção e opções de escolha única. Pode não existir quando não for possível ler um estado confiável.
  • hasTextEntry
    Booleano; indica se o elemento se comporta como um destino de entrada de texto.
  • isKeyboardKey
    Booleano; indica se o elemento se comporta como uma tecla de teclado.
  • absoluteValue
    Número real; valor normalizado que pode ser retornado por controles ajustáveis, como controles deslizantes.

Campos do estado de acerto​

Estes campos podem aparecer somente quando include_hit_state, hit_test ou fallback_hit_test estiver habilitado, ou durante a verificação de uma ação:

  • canHit
    Booleano; indica se o elemento pode ser atingido a partir do nível superior.
  • hitVerified
    Booleano; indica se o estado de acerto já foi verificado.
  • hitTestPoint
    Tabela; ponto de acerto, em pixels físicos.

Descrição​

Os campos do elemento são adequados para ler e avaliar o estado atual da interface. Para uma localização estável, prefira compor o seletor usando campos semânticos como text, role, checked e selected. Depois que a interface mudar, consulte os elementos novamente ou obtenha um novo instantâneo.