Beschreibung der Elementfelder

Dieses Modul ist erst in Versionen nach 20260507 verfügbar.

Das von einer Abfrageschnittstelle zurückgegebene Element ist eine gewöhnliche Lua-Tabelle. Die Felder stammen aus den Informationen, die die aktuelle Oberfläche offenlegt; je nach App und Steuerelementtyp können unterschiedliche Felder zurückgegeben werden.

Häufige Felder

• text Textwert; lesbarer Titel des Elements.
• value Beliebiger Typ; aktueller Wert des Elements. Bei Textfeldern ist dies normalerweise der aktuelle Text, bei Schaltern kann es 0 oder 1 sein und bei Schiebereglern ein Prozenttext.
• identifier Textwert; Elementbezeichner.
• hint Textwert; vom System bereitgestellter Hilfetext.
• bundleId Textwert; bundle identifier der App, zu der das Element gehört.
• x / y / width / height Ganzzahl; Elementbereich in physischen Pixeln.
• centerPoint Tabellenwert; Mittelpunkt des Elements in physischen Pixeln, z. B. { x = 100, y = 200 }.
• children Tabellenwert; Array der untergeordneten Elemente. Die Aufklapptiefe wird durch max_level gesteuert.
• traits Ganzzahl; Merkmalswert des Elements.
• traitsDescription Tabellenwert; Array der Merkmalsnamen des Elements, z. B. Button, StaticText, Toggle, Adjustable.
• isVisible Boolescher Wert; gibt an, ob das Element sichtbar ist.
• isSelected Boolescher Wert; gibt an, ob das Element ausgewählt ist.
• isToggle Boolescher Wert; gibt an, ob das Element einem Schalter ähnelt.
• isAdjustable Boolescher Wert; gibt an, ob das Element eine Erhöhung oder Verringerung unterstützt.
• checked Boolescher Wert; Bestätigungsstatus von Schaltern, Kontrollkästchen, Optionsfeldern und ähnlichen Steuerelementen. Bei einem nicht zuverlässig lesbaren Status kann das Feld fehlen.
• hasTextEntry Boolescher Wert; gibt an, ob das Element einem Texteingabeziel ähnelt.
• isKeyboardKey Boolescher Wert; gibt an, ob das Element einer Tastaturtaste ähnelt.
• absoluteValue Reelle Zahl; von Schiebereglern und ähnlichen anpassbaren Steuerelementen möglicherweise zurückgegebener normalisierter Wert.

Felder zum Trefferstatus

Diese Felder können nur erscheinen, wenn include_hit_state, hit_test oder fallback_hit_test aktiviert ist oder eine Aktion überprüft wird:

• canHit Boolescher Wert; gibt an, ob das Element derzeit von oben getroffen werden kann.
• hitVerified Boolescher Wert; gibt an, ob der Trefferstatus bereits überprüft wurde.
• hitTestPoint Tabellenwert; Trefferpunkt in physischen Pixeln.

Hinweise

Elementfelder eignen sich zum Lesen und Bewerten des aktuellen Oberflächenstatus. Für eine stabile Positionierung sollten vorzugsweise semantische Felder wie text, role, checked und selected zu einem Selektor kombiniert werden. Nach einer Änderung der Oberfläche sollten Elemente erneut abgefragt oder ein neuer Snapshot abgerufen werden.