Zum Hauptinhalt springen

Text-Element-Modul (ui_element)

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

ui_element liest UI-Elemente der aktuellen Oberfläche anhand von Text, Rolle, Status oder Koordinaten aus und führt für passende Elemente Aktionen wie Klicken, Scrollen, Eingeben, Umschalten oder Anpassen aus. Es eignet sich für Skripte, die die Oberflächenstruktur verstehen, fest codierte Koordinaten reduzieren oder auf Geräten mit unterschiedlichen Auflösungen eine lesbare Positionslogik beibehalten müssen.

Für Touch-Eingaben mit festen Koordinaten wird weiterhin das Touch-Simulationsmodul (touch) empfohlen. Koordinaten in ui_element sind physische Pixel.

Grundlegende Verwendung​

local ui_element = require("ui_element")

local item, err = ui_element.find({
    title = "搜索",
    role = "text_field",
})

if item then
    ui_element.input_text(item, "hello")
else
    sys.toast(err)
end

Hinweise​

Bei Fehlern von Abfrageschnittstellen wird normalerweise nil, err zurückgegeben. Wenn keine Elemente gefunden werden, gibt find_all ein leeres Array zurück. Aktionsschnittstellen geben bei Erfolg true, info und bei einem Fehler nil, err zurück. Nach einer Änderung der Oberfläche stellt ein zuvor erhaltener Snapshot nicht mehr die aktuelle Oberfläche dar; rufe snapshot() erneut auf.