Zum Hauptinhalt springen

Beschreibung der Selektorfelder

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

Ein Selektor ist eine Lua-Tabelle, die das zu suchende oder zu bedienende UI-Element beschreibt. Es wird empfohlen, zuerst eine Kombination aus lesbarem Text und Rolle zur Positionierung zu verwenden und nur bei Bedarf mit index gleichnamige Elemente zu unterscheiden.

Beispiel​

local selector = {
    title = "搜索",
    role = "text_field",
}

local item = ui_element.find(selector)

Felder​

  • title / text Textwert; lesbarer Titel des Elements. Beide Felder haben dieselbe Bedeutung.
  • text_contains Textwert; Teilstring, der im lesbaren Titel enthalten sein muss.
  • value Textwert, Zahlenwert oder boolescher Wert; aktueller Wert des Elements.
  • value_contains Textwert; Teilstring, der im Elementwert enthalten sein muss.
  • identifier Textwert; Elementbezeichner. Nicht alle Apps stellen ihn bereit.
  • bundle_id Textwert; bundle identifier der App, zu der das Element gehört.
  • role Textwert; Elementtyp. Häufige Werte sind button, text_field, static_text, switch, checkbox, radio, slider, picker, scrollable, link, image und keyboard_key.
  • traits Textwert oder Textarray; Merkmalsname des Elements, z. B. Button, StaticText, Toggle und Adjustable.
  • visible Boolescher Wert; gibt an, ob das Element sichtbar ist.
  • hittable Boolescher Wert; gibt an, ob das Element derzeit getroffen werden kann. Aktionsschnittstellen benötigen normalerweise ein treffbares Ziel.
  • checked Boolescher Wert; bestätigt den Status von Schaltern, Kontrollkästchen, Optionsfeldern und ähnlichen Elementen.
  • selected Boolescher Wert; gibt an, ob das Element ausgewählt ist.
  • index Ganzzahl; bei mehreren Treffern die Nummer des gewünschten Elements, nach Lua-Konvention ab 1.

Hinweise​

Koordinaten, Abmessungen, Fensterbezeichner und andere leicht veränderliche Felder sollten nicht als primäre Selektoren verwendet werden. Wenn mehrere Elemente gleichzeitig passen und kein index angegeben ist, kann eine Aktionsschnittstelle nil, "ambiguous target" zurückgeben. Je nach App und iOS-Version können unterschiedliche Felder offengelegt werden; für wichtige fehlende Felder sollte eine Fehlerbehandlung vorgesehen werden.