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.