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.