SwiftUI: Multi-Finger Dragging
Zusammenfassung
Kurz
Der Bericht erläutert, wie `UIGestureRecognizerRepresentable` einen konfigurierbaren `UIPanGestureRecognizer` für Mehrfinger-Ziehen in SwiftUI einbindet und wie Koordinaten, gleichzeitige Gesten sowie `onChange` und `onEnd` behandelt werden können. Er zeigt Codebeispiele, liefert aber keine systematischen Tests oder ausführlichen Angaben zu Versionsgrenzen.
Mittel
Der Artikel beschreibt eine SwiftUI-Lösung für Mehrfinger-Ziehen mit `UIPanGestureRecognizer` und `UIGestureRecognizerRepresentable`. Damit lassen sich laut Autor minimale und maximale Fingerzahl festlegen, was SwiftUIs `DragGesture` nicht direkt anbiete. Die Representable-Struktur wird per `.gesture(_:)` an eine Ansicht angehängt; ein `Binding` kann zunächst die aktuelle Position aktualisieren.
Für Koordinaten empfiehlt der Bericht den `context.converter`, der Positionen, Verschiebungen und Geschwindigkeiten in lokalen oder angegebenen SwiftUI-Koordinatenräumen bereitstellt. Ein Coordinator kann außerdem über `UIGestureRecognizerDelegate` erlauben oder verhindern, dass mehrere Gesten gleichzeitig erkannt werden.
Eine ausgebaute Variante ergänzt `onChange` und `onEnd`, einen Wert mit Zeit, aktueller und Startposition sowie berechneter Gesamtverschiebung und einen konfigurierbaren Mindestabstand. Der Coordinator verfolgt Startpunkt und Überschreiten dieser Schwelle; bei erfolgreicher Bewegung werden Änderungs- und Endaktionen aufgerufen. Der Bericht enthält Code und Animationen, aber keine systematischen Tests oder ausführlichen Angaben zu Versionsgrenzen. Die Einschätzung zu Einfachheit und früheren Problemen stammt vom Autor.
Ausführlich lesen
Der Bericht zeigt, wie sich in SwiftUI eine Mehrfinger-Ziehbewegung mit einem `UIPanGestureRecognizer` umsetzen lässt. Als Beispiel nennt der Autor eine Zeichen-App: Ein Finger kann zum Zeichnen dienen, während zwei Finger die Arbeitsfläche verschieben. UIKit erlaubt es, die minimale und maximale Zahl der Berührungen für einen Pan-Recognizer festzulegen; SwiftUIs `DragGesture` biete dafür laut Artikel keine entsprechende Einstellung.
Der Autor beschreibt `UIGestureRecognizerRepresentable` als neueren Weg, einen UIKit-Gesture-Recognizer direkt in die SwiftUI-Ansichtshierarchie einzubinden. Zuvor sei dafür ein `UIViewRepresentable` nötig gewesen. Das habe laut seiner Einschätzung zusätzlichen Aufwand bei der Umrechnung von Koordinaten verursacht und könne mit anderen Gesten in Konflikt geraten. Für die Einbindung nennt er zwei Schritte: eine Representable-Struktur erstellen und sie mit `.gesture(_:)` an eine SwiftUI-Ansicht hängen.
Die einfache Version der Struktur erstellt einen `UIPanGestureRecognizer`, setzt dessen minimale und maximale Fingerzahl und schreibt die aktuelle Position über ein `Binding` in den Zustand der Ansicht. Für Koordinaten empfiehlt der Artikel den `context.converter`: Er könne Position, Verschiebung und Geschwindigkeit im lokalen oder in einem angegebenen SwiftUI-Koordinatenraum liefern und Punkte zwischen Koordinatenräumen umrechnen. Der Autor weist darauf hin, dass `recognizer.location(in: nil)` stattdessen globale, fensterbezogene Koordinaten zurückgebe.
Für gleichzeitige Gesten lässt sich laut Bericht ein Coordinator als `UIGestureRecognizerDelegate` einsetzen. Dessen Delegate-Methode gibt über eine konfigurierbare Eigenschaft vor, ob der Recognizer gleichzeitig mit anderen Gesten arbeiten darf.
Im umfangreicheren Beispiel orientiert sich die API an SwiftUIs `DragGesture`: Sie bietet `onChange` und `onEnd` sowie einen eigenen `Value`-Typ mit Zeit, aktueller Position, Startposition und daraus berechneter Gesamtverschiebung. Außerdem gibt es Einstellungen für Mindestabstand, Koordinatenraum und minimale sowie maximale Fingerzahl. Der Recognizer prüft seine Zustände `.began`, `.changed` und `.ended`; ein Coordinator speichert dafür Startposition und Erfolg der Mindestabstandsprüfung. Sobald die Schwelle überschritten ist, wird die Bewegung als erfolgreich behandelt und `onChange` aufgerufen; beim Ende wird gegebenenfalls `onEnd` ausgelöst und der Zustand zurückgesetzt. Der Artikel erklärt, dass diese Speicherung im Coordinator nötig sei, weil die Action-Methode die Representable-Struktur nicht verändern könne. Verkettbare Methoden für `onChange` und `onEnd` geben jeweils eine veränderte Kopie der Struktur zurück.
Der Bericht liefert Codebeispiele und zeigt die Bewegung anhand von Animationen. Er enthält jedoch keine dokumentierten Messergebnisse, systematische Tests oder ausführliche Angaben zu Betriebssystem- und Versionsgrenzen. Seine Aussagen zur Einfachheit und zu früheren Problemen sind die Einschätzung des Autors; der Text belegt nicht unabhängig, dass die Beispiele in allen SwiftUI-Konfigurationen funktionieren.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Im Auftrag wurden keine Fragen angegeben (weder Sammel- noch Teilfragen), daher bleibt die Einordnung leer. Die Zusammenfassungen sind sachlich korrekt, lassen aber mehrere zentrale Punkte des Berichts aus.
Im Bericht, aber nicht in der Zusammenfassung
- Die Begründung, warum ein Ansatz über das Gesture-Protokoll nicht funktionierte, weil dessen body andere Gesten verlangt
- Die bisherige Lösung über ein UIViewRepresentable-Overlay und ihre Nachteile bei Koordinaten und anderen Erkennern
- Dass Value.translation wie bei DragGesture die Gesamtverschiebung ab Gestenstart ist
- Dass der Coordinator Startpunkt und Schwellenstatus halten muss, weil handleUIGestureRecognizerAction die Struktur nicht verändern kann
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.