SwiftUI: Horizontal ScrollView on Vertical Drag Gesture
Zusammenfassung
Kurz
Der Artikel zeigt, wie eine vertikale DragGesture eine horizontale SwiftUI-ScrollView steuern kann, und begrenzt die Position anhand der ermittelten Inhaltsgröße, um Überscrollen abzufangen. Für iOS 18 wird ScrollPosition vorgestellt, für ältere Versionen ein empfindlicherer offset-Ansatz; einige technische Erklärungen bleiben laut Autorin unsicher oder offen.
Mittel
Itsuki zeigt, wie eine horizontale SwiftUI-ScrollView auf vertikale Ziehbewegungen reagieren kann. Dazu wird das normale Scrollen deaktiviert und eine DragGesture übersetzt die vertikale Verschiebung mithilfe eines einstellbaren Faktors in eine horizontale Position. Für iOS 18 nutzt das Beispiel ScrollPosition.scrollTo(x:).
Ein Problem entsteht laut Autorin beim starken Überscrollen: Der gespeicherte Positionswert kann weit außerhalb des tatsächlich scrollbaren Bereichs liegen. Eine Gegenbewegung muss diese Differenz erst aufholen. Als Abhilfe wird die Position beim Ende der Geste auf den Bereich von 0 bis Inhaltsbreite minus Bildschirmbreite begrenzt. Die Inhaltsgröße lässt sich laut Artikel mit einem GeometryReader oder, ab iOS 18, mit onScrollGeometryChange ermitteln. Die Erklärung für den Abzug der Bildschirmbreite bezeichnet die Autorin als wahrscheinlich. Für ältere iOS-Versionen beschreibt sie einen offset-basierten Ersatz, der empfindlicher reagiert und deshalb einen niedrigeren Bewegungsfaktor erfordert. Einen verlässlich auslesbaren x-Wert über scrollPosition.point konnte die Autorin selbst nicht erhalten; der Artikel klärt diese Einschränkung nicht auf.
Ausführlich lesen
Der Bericht von Itsuki beschreibt, wie sich in SwiftUI eine horizontale ScrollView so steuern lässt, dass sie auf vertikale Ziehbewegungen reagiert. Als Ausgangspunkt dient ein Kartenband mit farbigen Tier-Symbolen. Die Grundidee: Das normale Scrollen der horizontalen ScrollView wird deaktiviert und eine eigene DragGesture übersetzt die vertikale Bewegung in eine Änderung der horizontalen Position.
Für iOS 18 zeigt der Artikel ScrollPosition und dessen scrollTo(x:)-Methode. Während einer Ziehbewegung wird die vertikale Verschiebung mit einem einstellbaren translationFactor multipliziert und zur gespeicherten horizontalen Position addiert. Beim Ende der Geste wird der neue Wert gespeichert. Die Autorin berichtet, dass das zunächst funktioniert, bei starkem Überscrollen aber ein Problem entsteht: Liegt die gespeicherte Position weit jenseits des tatsächlich scrollbaren Bereichs, muss die Gegenbewegung diese Abweichung erst aufholen, bevor die Ansicht wieder sichtbar zurückscrollt. Die Autorin konnte außerdem den aktuellen x-Wert über scrollPosition.point nicht zuverlässig auslesen; bei ihr blieb er nil.
Um den Scrollbereich zu begrenzen, muss laut Artikel zunächst die Inhaltsgröße ermittelt werden. Dafür stellt Itsuki zwei Wege vor: Ein GeometryReader-Overlay kann die Größe des HStack erfassen; alternativ kann ab iOS 18 der ScrollView-Modifikator onScrollGeometryChange die contentSize liefern. Die zweite Möglichkeit kann laut Autorin zusätzlich hilfreich sein, wenn die ScrollView Einzüge besitzt, da sich damit auch contentInsets auslesen lassen. Anschließend wird die Position beim Ende der Geste zwischen 0 und contentSize.width minus Bildschirmbreite begrenzt. Dass die maximal scrollbare Position um die Bildschirmbreite kleiner als die Inhaltsbreite sei, erklärt die Autorin damit, dass der HStack am rechten Rand vermutlich noch bis zur Bildschirmbreite reicht. Sie kennzeichnet diese Erklärung selbst als wahrscheinlich, nicht als gesicherte Ursache.
Für iOS-Versionen vor 18 oder für Projekte, die ScrollPosition nicht verwenden wollen, nennt der Bericht einen Ersatz: Die Ziehbewegung verändert einen eigenen Positionswert, und der HStack wird mit einem negativen horizontalen offset verschoben. Laut Autorin reagiert dieser Ansatz empfindlicher, weshalb sie einen kleineren translationFactor empfiehlt. Die Beispiele und Grenzen beziehen sich auf die dargestellte Implementierung; der Artikel liefert keine systematische Prüfung auf unterschiedlichen Geräten oder Konfigurationen und lässt die Frage nach dem nil-Wert von point offen.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die mittlere Zusammenfassung von Luna gibt den Bericht im Kern treu wieder und erfindet nichts. Ihr fehlen einige Nebenaussagen, etwa der Apple-Anlass und die Abgrenzung zu ScrollViewReader und onScrollVisibilityChange. Die kurze Fassung ist ebenfalls sachlich richtig, lässt aber die GeometryReader-Alternative und die Erklärung zum Abzug der Bildschirmbreite aus. Es wurden keine Fragen zur Einordnung angegeben, daher bleibt die Einordnung leer.
Im Bericht, aber nicht in der Zusammenfassung
- Anlass des Artikels: die horizontale Scroll-Bewegung auf Apples Startseite
- Hinweis, dass ein ScrollViewReader wegen scrollTo(_:anchor:) mit ID nicht passt
- Verworfener Ansatz über onScrollVisibilityChange, der keine x-Position liefert
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.