SwiftUI/MacOS: A Custom ScrollView Without ScrollView
Zusammenfassung
Kurz
Der Autor beschreibt, wie er Scroll-Deltas unter macOS mit einem lokalen `NSEvent`-Monitor erfasst und damit eine SwiftUI-Ansicht verschiebt. Einen `NSPanGestureRecognizer` und ein überlagertes `NSView` verwirft er aufgrund seiner Erfahrungen mit Gestenerkennung beziehungsweise blockiertem Hit-Testing; die vermutete Beta-Fehlerursache bleibt unbestätigt.
Mittel
Der Bericht zeigt, wie der Autor unter SwiftUI auf macOS eine scrollgesteuerte Verschiebung ohne `ScrollView` umsetzt. Anlass ist eine Anwendung mit umfangreicher Gestensteuerung, bei der sich `ScrollView` nach seiner Erfahrung nicht gut eignet; grundsätzlich empfiehlt er, die eingebaute Lösung zu verwenden, wenn sie ausreicht.
Ein `NSPanGestureRecognizer` habe sich in seinem Versuch nicht wie eine Scrollgeste verhalten, sondern wie eine Mausziehgeste. Auch ein über `NSViewRepresentable` eingeblendetes `NSView`, das `scrollWheel` abfängt, habe einen Nachteil: Es blockiere das Hit-Testing für darunterliegende Ansichten und damit etwa deren Tap-Gesten.
Als funktionierend beschreibt der Autor einen lokalen `NSEvent`-Monitor für `.scrollWheel`. Dessen Scroll-Deltas addiert er zu einer gespeicherten Verschiebung, die ein vergrößertes Rechteck bewegt. Eine weitere Codevariante begrenzt die horizontale Verschiebung bereits im Ereignishandler, damit sich keine lange auszugleichende Bewegung ansammelt. Der Bericht bietet Beispielcode, aber keinen umfassenden Test oder Vergleich. Die Beta-Fehler-Erklärung des Autors ist eine Vermutung.
Ausführlich lesen
Der Bericht beschreibt einen Ansatz für eine eigene Scroll- beziehungsweise Verschiebefunktion unter SwiftUI auf macOS, bei dem kein SwiftUI-`ScrollView` verwendet wird. Der Autor begründet das mit einer Anwendung, deren umfangreiche Gestenbehandlung, darunter Vergrößerungsgesten, sich seiner Erfahrung nach nicht gut mit `ScrollView` verträgt. Zugleich empfiehlt er zunächst, nach Möglichkeit die eingebaute ScrollView zu verwenden.
Als ersten Versuch zeigt der Autor einen `NSPanGestureRecognizer`, der die Verschiebung auslesen und an eine SwiftUI-Ansicht binden soll. Nach seiner Darstellung eignet sich dieser jedoch nicht für Scrollgesten: Er beschreibt ihn als Erkennung eines gedrückten Maustasters mit anschließendem Ziehen und Loslassen. Obwohl im Beispiel zwei Berührungen als Mindest- und Höchstzahl eingestellt sind, werde der Erkenner bei ihm auch durch einen Klick mit einem Finger ausgelöst. Der Autor vermutet, das könne ein Fehler sein, und weist darauf hin, dass die betreffenden APIs im beschriebenen Kontext Beta seien.
Ein weiterer Versuch ist ein über `NSViewRepresentable` eingeblendetes `NSView`, das `scrollWheel(with:)` überschreibt und Scrollereignisse weitergibt. Der Autor berichtet, dass er damit zwar `NSEvent`-Daten erhält, die überlagerte Ansicht aber das Hit-Testing abfängt: Eine darunterliegende SwiftUI-Ansicht könne dann beispielsweise keinen `TapGesture` mehr empfangen. Das Deaktivieren des Hit-Testings löse das Problem nicht, weil das Overlay dadurch auch keine Scrollereignisse mehr erhalte.
Als funktionierende Lösung stellt der Bericht einen lokalen Ereignismonitor über `NSEvent.addLocalMonitorForEvents(matching: .scrollWheel, handler:)` vor. Im einfachen Beispiel werden die horizontalen und vertikalen Scroll-Deltas auf eine gespeicherte Verschiebung addiert. Ein vergrößertes Rechteck wird anschließend per `offset` entsprechend bewegt. Eine zweite Variante begrenzt die horizontale Verschiebung anhand der verfügbaren Ansichtsgröße und der skalierten Rechteckbreite. Laut Autor muss die Begrenzung bereits im Ereignishandler erfolgen, damit angesammelte, nicht sichtbare Verschiebung nicht erst durch langes Scrollen in Gegenrichtung ausgeglichen werden muss.
Der Bericht liefert Beispielcode und eine konkrete Lösung für den geschilderten Fall. Er enthält jedoch keinen systematischen Vergleich, keine Angaben zu umfassenden Tests oder zu weiteren Einschränkungen des Ereignismonitors. Die Aussagen zu den Gestenerkennern und zum Hit-Testing sind die Erfahrungen des Autors; die Vermutung, das beobachtete Verhalten sei ein Beta-Fehler, bleibt ausdrücklich unbestätigt.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Es wurden keine Fragen zur Einordnung angegeben, daher bleibt die Einordnung leer. Geprüft wurden beide von Luna gelieferten Zusammenfassungen gemeinsam: Beide geben die Kernaussagen treu wieder und erfinden nichts; die Kurzfassung lässt das Clamping aus, die Mittelfassung den Einzelfinger-Klick.
Im Bericht, aber nicht in der Zusammenfassung
- Kurzfassung: Clamping der Verschiebung im Ereignishandler und die Motivation mit umfangreicher Gestensteuerung fehlen
- Mittelfassung: Der Einzelfinger-Klick, der den NSPanGestureRecognizer trotz Zwei-Finger-Einstellung auslöst, fehlt
- Beide: Die Versionsangabe Beta 27 und die Skalierung per scaleEffect, damit das Fenster unter 1000 bleibt, fehlen
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.